Skip to main content

signaloid-cli cores

Manage Signaloid compute cores for distribution arithmetic.

Synopsis​

signaloid-cli cores <command> [options]

Description​

The cores command group allows you to manage Signaloid compute cores. Cores define the computational resources and distribution arithmetic capabilities used for builds and tasks. See Execution Cores for details on the available configuration options. You can list available cores, create custom cores, and manage core configurations.

Commands​

  • list - List available cores
  • get - Get details about a specific core
  • create - Create a custom core configuration
  • update - Update core configuration
  • delete - Delete a custom core

Complete Workflow Example​

#!/bin/bash

# 1. List available default cores
echo "Available default cores:"
signaloid-cli cores list --default

# 2. Create custom core for project
echo "Creating custom core..."
CORE_RESPONSE=$(signaloid-cli cores create \
  --name "Project Alpha Core" \
  --class C0Pro \
  --precision 64 \
  --microarchitecture Athens \
  --dependency-tracking Basic)

CORE_ID=$(echo $CORE_RESPONSE | jq -r '.CoreID')
echo "Created core: $CORE_ID"

# 3. Use core for build
BUILD_RESPONSE=$(signaloid-cli builds create:source \
  --file main.c \
  --lang C \
  --core-id $CORE_ID)

BUILD_ID=$(echo $BUILD_RESPONSE | jq -r '.BuildID')
echo "Build created: $BUILD_ID"

# 4. Wait for build and create task
signaloid-cli builds watch --build-id $BUILD_ID
TASK_ID=$(signaloid-cli tasks create --build-id $BUILD_ID | jq -r '.TaskID')

# 5. Get results
signaloid-cli tasks watch --task-id $TASK_ID
signaloid-cli tasks output --task-id $TASK_ID

echo "Complete!"

Exit Codes​

CodeDescription
0Success
1Error: the request failed, the Signaloid Cloud Compute Engine rejected the configuration, an option value is not one of the allowed values, or an option that is always required (such as --name, --class, or --microarchitecture for cores create, or --core-id) is missing
2Usage error: the CLI rejects the combination of options before sending the request. Examples: --precision or --dependency-tracking missing for a core other than an r7i or Bypass one, --precision 32 or --microarchitecture Bypass for an r7i core, --precision 32 or --dependency-tracking Basic for a Bypass core, or a cores update that needs --class, --microarchitecture, --precision, or --dependency-tracking
3Authentication error: not logged in, or the credentials are invalid or expired
4Core not found

See Also​

Learn More​

Last updated on