f415a77173
* chore: Set version as v1.27.0-rc1 Set version as v1.27.0-rc1, run make gen & make docsgen-cli * Update changelog Update changelog * Update changelog Update changelog based on feedback
564 lines
16 KiB
Markdown
564 lines
16 KiB
Markdown
# curio
|
|
```
|
|
NAME:
|
|
curio - Filecoin decentralized storage network provider
|
|
|
|
USAGE:
|
|
curio [global options] command [command options] [arguments...]
|
|
|
|
VERSION:
|
|
1.27.0-rc1
|
|
|
|
COMMANDS:
|
|
cli Execute cli commands
|
|
run Start a Curio process
|
|
stop Stop a running Curio process
|
|
config Manage node config by layers. The layer 'base' will always be applied at Curio start-up.
|
|
test Utility functions for testing
|
|
web Start Curio web interface
|
|
guided-setup Run the guided setup for migrating from lotus-miner to Curio or Creating a new Curio miner
|
|
seal Manage the sealing pipeline
|
|
market
|
|
fetch-params Fetch proving parameters
|
|
help, h Shows a list of commands or help for one command
|
|
|
|
GLOBAL OPTIONS:
|
|
--color use color in display output (default: depends on output being a TTY)
|
|
--db-host value Command separated list of hostnames for yugabyte cluster (default: "127.0.0.1") [$CURIO_DB_HOST, $CURIO_HARMONYDB_HOSTS]
|
|
--db-name value (default: "yugabyte") [$CURIO_DB_NAME, $CURIO_HARMONYDB_NAME]
|
|
--db-user value (default: "yugabyte") [$CURIO_DB_USER, $CURIO_HARMONYDB_USERNAME]
|
|
--db-password value (default: "yugabyte") [$CURIO_DB_PASSWORD, $CURIO_HARMONYDB_PASSWORD]
|
|
--db-port value (default: "5433") [$CURIO_DB_PORT, $CURIO_HARMONYDB_PORT]
|
|
--repo-path value (default: "~/.curio") [$CURIO_REPO_PATH]
|
|
--vv enables very verbose mode, useful for debugging the CLI (default: false)
|
|
--help, -h show help
|
|
--version, -v print the version
|
|
```
|
|
|
|
## curio cli
|
|
```
|
|
NAME:
|
|
curio cli - Execute cli commands
|
|
|
|
USAGE:
|
|
curio cli command [command options] [arguments...]
|
|
|
|
COMMANDS:
|
|
storage manage sector storage
|
|
log Manage logging
|
|
wait-api Wait for Curio api to come online
|
|
help, h Shows a list of commands or help for one command
|
|
|
|
OPTIONS:
|
|
--machine value machine host:port (curio run --listen address)
|
|
--help, -h show help
|
|
```
|
|
|
|
### curio cli storage
|
|
```
|
|
NAME:
|
|
curio cli storage - manage sector storage
|
|
|
|
USAGE:
|
|
curio cli storage command [command options] [arguments...]
|
|
|
|
DESCRIPTION:
|
|
Sectors can be stored across many filesystem paths. These
|
|
commands provide ways to manage the storage the miner will used to store sectors
|
|
long term for proving (references as 'store') as well as how sectors will be
|
|
stored while moving through the sealing pipeline (references as 'seal').
|
|
|
|
COMMANDS:
|
|
attach attach local storage path
|
|
detach detach local storage path
|
|
list list local storage paths
|
|
find find sector in the storage system
|
|
help, h Shows a list of commands or help for one command
|
|
|
|
OPTIONS:
|
|
--help, -h show help
|
|
```
|
|
|
|
#### curio cli storage attach
|
|
```
|
|
NAME:
|
|
curio cli storage attach - attach local storage path
|
|
|
|
USAGE:
|
|
curio cli storage attach [command options] [path]
|
|
|
|
DESCRIPTION:
|
|
Storage can be attached to the miner using this command. The storage volume
|
|
list is stored local to the miner in storage.json set in curio run. We do not
|
|
recommend manually modifying this value without further understanding of the
|
|
storage system.
|
|
|
|
Each storage volume contains a configuration file which describes the
|
|
capabilities of the volume. When the '--init' flag is provided, this file will
|
|
be created using the additional flags.
|
|
|
|
Weight
|
|
A high weight value means data will be more likely to be stored in this path
|
|
|
|
Seal
|
|
Data for the sealing process will be stored here
|
|
|
|
Store
|
|
Finalized sectors that will be moved here for long term storage and be proven
|
|
over time
|
|
|
|
|
|
OPTIONS:
|
|
--init initialize the path first (default: false)
|
|
--weight value (for init) path weight (default: 10)
|
|
--seal (for init) use path for sealing (default: false)
|
|
--store (for init) use path for long-term storage (default: false)
|
|
--max-storage value (for init) limit storage space for sectors (expensive for very large paths!)
|
|
--groups value [ --groups value ] path group names
|
|
--allow-to value [ --allow-to value ] path groups allowed to pull data from this path (allow all if not specified)
|
|
--help, -h show help
|
|
```
|
|
|
|
#### curio cli storage detach
|
|
```
|
|
NAME:
|
|
curio cli storage detach - detach local storage path
|
|
|
|
USAGE:
|
|
curio cli storage detach [command options] [path]
|
|
|
|
OPTIONS:
|
|
--really-do-it (default: false)
|
|
--help, -h show help
|
|
```
|
|
|
|
#### curio cli storage list
|
|
```
|
|
NAME:
|
|
curio cli storage list - list local storage paths
|
|
|
|
USAGE:
|
|
curio cli storage list [command options] [arguments...]
|
|
|
|
OPTIONS:
|
|
--local only list local storage paths (default: false)
|
|
--help, -h show help
|
|
```
|
|
|
|
#### curio cli storage find
|
|
```
|
|
NAME:
|
|
curio cli storage find - find sector in the storage system
|
|
|
|
USAGE:
|
|
curio cli storage find [command options] [miner address] [sector number]
|
|
|
|
OPTIONS:
|
|
--help, -h show help
|
|
```
|
|
|
|
### curio cli log
|
|
```
|
|
NAME:
|
|
curio cli log - Manage logging
|
|
|
|
USAGE:
|
|
curio cli log command [command options] [arguments...]
|
|
|
|
COMMANDS:
|
|
list List log systems
|
|
set-level Set log level
|
|
help, h Shows a list of commands or help for one command
|
|
|
|
OPTIONS:
|
|
--help, -h show help
|
|
```
|
|
|
|
#### curio cli log list
|
|
```
|
|
NAME:
|
|
curio cli log list - List log systems
|
|
|
|
USAGE:
|
|
curio cli log list [command options] [arguments...]
|
|
|
|
OPTIONS:
|
|
--help, -h show help
|
|
```
|
|
|
|
#### curio cli log set-level
|
|
```
|
|
NAME:
|
|
curio cli log set-level - Set log level
|
|
|
|
USAGE:
|
|
curio cli log set-level [command options] [level]
|
|
|
|
DESCRIPTION:
|
|
Set the log level for logging systems:
|
|
|
|
The system flag can be specified multiple times.
|
|
|
|
eg) log set-level --system chain --system chainxchg debug
|
|
|
|
Available Levels:
|
|
debug
|
|
info
|
|
warn
|
|
error
|
|
|
|
Environment Variables:
|
|
GOLOG_LOG_LEVEL - Default log level for all log systems
|
|
GOLOG_LOG_FMT - Change output log format (json, nocolor)
|
|
GOLOG_FILE - Write logs to file
|
|
GOLOG_OUTPUT - Specify whether to output to file, stderr, stdout or a combination, i.e. file+stderr
|
|
|
|
|
|
OPTIONS:
|
|
--system value [ --system value ] limit to log system
|
|
--help, -h show help
|
|
```
|
|
|
|
### curio cli wait-api
|
|
```
|
|
NAME:
|
|
curio cli wait-api - Wait for Curio api to come online
|
|
|
|
USAGE:
|
|
curio cli wait-api [command options] [arguments...]
|
|
|
|
OPTIONS:
|
|
--timeout value duration to wait till fail (default: 30s)
|
|
--help, -h show help
|
|
```
|
|
|
|
## curio run
|
|
```
|
|
NAME:
|
|
curio run - Start a Curio process
|
|
|
|
USAGE:
|
|
curio run [command options] [arguments...]
|
|
|
|
OPTIONS:
|
|
--listen value host address and port the worker api will listen on (default: "0.0.0.0:12300") [$LOTUS_WORKER_LISTEN]
|
|
--nosync don't check full-node sync status (default: false)
|
|
--manage-fdlimit manage open file limit (default: true)
|
|
--storage-json value path to json file containing storage config (default: "~/.curio/storage.json")
|
|
--journal value path to journal files (default: "~/.curio/")
|
|
--layers value, -l value, --layer value [ --layers value, -l value, --layer value ] list of layers to be interpreted (atop defaults). Default: base
|
|
--help, -h show help
|
|
```
|
|
|
|
## curio stop
|
|
```
|
|
NAME:
|
|
curio stop - Stop a running Curio process
|
|
|
|
USAGE:
|
|
curio stop [command options] [arguments...]
|
|
|
|
OPTIONS:
|
|
--help, -h show help
|
|
```
|
|
|
|
## curio config
|
|
```
|
|
NAME:
|
|
curio config - Manage node config by layers. The layer 'base' will always be applied at Curio start-up.
|
|
|
|
USAGE:
|
|
curio config command [command options] [arguments...]
|
|
|
|
COMMANDS:
|
|
default, defaults Print default node config
|
|
set, add, update, create Set a config layer or the base by providing a filename or stdin.
|
|
get, cat, show Get a config layer by name. You may want to pipe the output to a file, or use 'less'
|
|
list, ls List config layers present in the DB.
|
|
interpret, view, stacked, stack Interpret stacked config layers by this version of curio, with system-generated comments.
|
|
remove, rm, del, delete Remove a named config layer.
|
|
edit edit a config layer
|
|
new-cluster Create new configuration for a new cluster
|
|
help, h Shows a list of commands or help for one command
|
|
|
|
OPTIONS:
|
|
--help, -h show help
|
|
```
|
|
|
|
### curio config default
|
|
```
|
|
NAME:
|
|
curio config default - Print default node config
|
|
|
|
USAGE:
|
|
curio config default [command options] [arguments...]
|
|
|
|
OPTIONS:
|
|
--no-comment don't comment default values (default: false)
|
|
--help, -h show help
|
|
```
|
|
|
|
### curio config set
|
|
```
|
|
NAME:
|
|
curio config set - Set a config layer or the base by providing a filename or stdin.
|
|
|
|
USAGE:
|
|
curio config set [command options] a layer's file name
|
|
|
|
OPTIONS:
|
|
--title value title of the config layer (req'd for stdin)
|
|
--help, -h show help
|
|
```
|
|
|
|
### curio config get
|
|
```
|
|
NAME:
|
|
curio config get - Get a config layer by name. You may want to pipe the output to a file, or use 'less'
|
|
|
|
USAGE:
|
|
curio config get [command options] layer name
|
|
|
|
OPTIONS:
|
|
--help, -h show help
|
|
```
|
|
|
|
### curio config list
|
|
```
|
|
NAME:
|
|
curio config list - List config layers present in the DB.
|
|
|
|
USAGE:
|
|
curio config list [command options] [arguments...]
|
|
|
|
OPTIONS:
|
|
--help, -h show help
|
|
```
|
|
|
|
### curio config interpret
|
|
```
|
|
NAME:
|
|
curio config interpret - Interpret stacked config layers by this version of curio, with system-generated comments.
|
|
|
|
USAGE:
|
|
curio config interpret [command options] a list of layers to be interpreted as the final config
|
|
|
|
OPTIONS:
|
|
--layers value [ --layers value ] comma or space separated list of layers to be interpreted (base is always applied)
|
|
--help, -h show help
|
|
```
|
|
|
|
### curio config remove
|
|
```
|
|
NAME:
|
|
curio config remove - Remove a named config layer.
|
|
|
|
USAGE:
|
|
curio config remove [command options] [arguments...]
|
|
|
|
OPTIONS:
|
|
--help, -h show help
|
|
```
|
|
|
|
### curio config edit
|
|
```
|
|
NAME:
|
|
curio config edit - edit a config layer
|
|
|
|
USAGE:
|
|
curio config edit [command options] [layer name]
|
|
|
|
OPTIONS:
|
|
--editor value editor to use (default: "vim") [$EDITOR]
|
|
--source value source config layer (default: <edited layer>)
|
|
--allow-overwrite allow overwrite of existing layer if source is a different layer (default: false)
|
|
--no-source-diff save the whole config into the layer, not just the diff (default: false)
|
|
--no-interpret-source do not interpret source layer (default: true if --source is set)
|
|
--help, -h show help
|
|
```
|
|
|
|
### curio config new-cluster
|
|
```
|
|
NAME:
|
|
curio config new-cluster - Create new configuration for a new cluster
|
|
|
|
USAGE:
|
|
curio config new-cluster [command options] [SP actor address...]
|
|
|
|
OPTIONS:
|
|
--help, -h show help
|
|
```
|
|
|
|
## curio test
|
|
```
|
|
NAME:
|
|
curio test - Utility functions for testing
|
|
|
|
USAGE:
|
|
curio test command [command options] [arguments...]
|
|
|
|
COMMANDS:
|
|
window-post, wd, windowpost, wdpost Compute a proof-of-spacetime for a sector (requires the sector to be pre-sealed). These will not send to the chain.
|
|
help, h Shows a list of commands or help for one command
|
|
|
|
OPTIONS:
|
|
--help, -h show help
|
|
```
|
|
|
|
### curio test window-post
|
|
```
|
|
NAME:
|
|
curio test window-post - Compute a proof-of-spacetime for a sector (requires the sector to be pre-sealed). These will not send to the chain.
|
|
|
|
USAGE:
|
|
curio test window-post command [command options] [arguments...]
|
|
|
|
COMMANDS:
|
|
here, cli Compute WindowPoSt for performance and configuration testing.
|
|
task, scheduled, schedule, async, asynchronous Test the windowpost scheduler by running it on the next available curio.
|
|
help, h Shows a list of commands or help for one command
|
|
|
|
OPTIONS:
|
|
--help, -h show help
|
|
```
|
|
|
|
#### curio test window-post here
|
|
```
|
|
NAME:
|
|
curio test window-post here - Compute WindowPoSt for performance and configuration testing.
|
|
|
|
USAGE:
|
|
curio test window-post here [command options] [deadline index]
|
|
|
|
DESCRIPTION:
|
|
Note: This command is intended to be used to verify PoSt compute performance.
|
|
It will not send any messages to the chain. Since it can compute any deadline, output may be incorrectly timed for the chain.
|
|
|
|
OPTIONS:
|
|
--deadline value deadline to compute WindowPoSt for (default: 0)
|
|
--layers value [ --layers value ] list of layers to be interpreted (atop defaults). Default: base
|
|
--storage-json value path to json file containing storage config (default: "~/.curio/storage.json")
|
|
--partition value partition to compute WindowPoSt for (default: 0)
|
|
--help, -h show help
|
|
```
|
|
|
|
#### curio test window-post task
|
|
```
|
|
NAME:
|
|
curio test window-post task - Test the windowpost scheduler by running it on the next available curio.
|
|
|
|
USAGE:
|
|
curio test window-post task [command options] [arguments...]
|
|
|
|
OPTIONS:
|
|
--deadline value deadline to compute WindowPoSt for (default: 0)
|
|
--layers value [ --layers value ] list of layers to be interpreted (atop defaults). Default: base
|
|
--help, -h show help
|
|
```
|
|
|
|
## curio web
|
|
```
|
|
NAME:
|
|
curio web - Start Curio web interface
|
|
|
|
USAGE:
|
|
curio web [command options] [arguments...]
|
|
|
|
DESCRIPTION:
|
|
Start an instance of Curio web interface.
|
|
This creates the 'web' layer if it does not exist, then calls run with that layer.
|
|
|
|
OPTIONS:
|
|
--listen value Address to listen on (default: "127.0.0.1:4701")
|
|
--nosync don't check full-node sync status (default: false)
|
|
--layers value [ --layers value ] list of layers to be interpreted (atop defaults). Default: base
|
|
--help, -h show help
|
|
```
|
|
|
|
## curio guided-setup
|
|
```
|
|
NAME:
|
|
curio guided-setup - Run the guided setup for migrating from lotus-miner to Curio or Creating a new Curio miner
|
|
|
|
USAGE:
|
|
curio guided-setup [command options] [arguments...]
|
|
|
|
OPTIONS:
|
|
--help, -h show help
|
|
```
|
|
|
|
## curio seal
|
|
```
|
|
NAME:
|
|
curio seal - Manage the sealing pipeline
|
|
|
|
USAGE:
|
|
curio seal command [command options] [arguments...]
|
|
|
|
COMMANDS:
|
|
start Start new sealing operations manually
|
|
help, h Shows a list of commands or help for one command
|
|
|
|
OPTIONS:
|
|
--help, -h show help
|
|
```
|
|
|
|
### curio seal start
|
|
```
|
|
NAME:
|
|
curio seal start - Start new sealing operations manually
|
|
|
|
USAGE:
|
|
curio seal start [command options] [arguments...]
|
|
|
|
OPTIONS:
|
|
--actor value Specify actor address to start sealing sectors for
|
|
--now Start sealing sectors for all actors now (not on schedule) (default: false)
|
|
--cc Start sealing new CC sectors (default: false)
|
|
--count value Number of sectors to start (default: 1)
|
|
--synthetic Use synthetic PoRep (default: false)
|
|
--layers value [ --layers value ] list of layers to be interpreted (atop defaults). Default: base
|
|
--help, -h show help
|
|
```
|
|
|
|
## curio market
|
|
```
|
|
NAME:
|
|
curio market
|
|
|
|
USAGE:
|
|
curio market command [command options] [arguments...]
|
|
|
|
COMMANDS:
|
|
rpc-info
|
|
help, h Shows a list of commands or help for one command
|
|
|
|
OPTIONS:
|
|
--help, -h show help
|
|
```
|
|
|
|
### curio market rpc-info
|
|
```
|
|
NAME:
|
|
curio market rpc-info
|
|
|
|
USAGE:
|
|
curio market rpc-info [command options] [arguments...]
|
|
|
|
OPTIONS:
|
|
--layers value [ --layers value ] list of layers to be interpreted (atop defaults). Default: base
|
|
--help, -h show help
|
|
```
|
|
|
|
## curio fetch-params
|
|
```
|
|
NAME:
|
|
curio fetch-params - Fetch proving parameters
|
|
|
|
USAGE:
|
|
curio fetch-params [command options] [sectorSize]
|
|
|
|
OPTIONS:
|
|
--help, -h show help
|
|
```
|