GooseFS 命令行接口为用户提供了基本的文件系统操作，可以使用以下命令来得到所有子命令：
goosefs fs [generic options]
文件系统各项指令列表如下：
指令操作 | 指令说明 |
cat <path> | 打印指定的 GooseFS 路径中的文件内容。 |
checkConsistency [-r][-t|--threads ] <GooseFS path> | 检查 GooseFS 和底层存储的元数据一致性。 |
checksum <GooseFS path> | 计算指定 GooseFS 文件路径的 md5 校验码。 |
chgrp [-R]<group><path> | 修改指定 GooseFS 文件或者文件夹的所属用户组信息，支持通过 -R 递归修改指定目录下所有文件的所属用户组。 |
chmod [-R]<mode><path> | 修改指定 GooseFS 文件或者文件夹的访问权限信息，支持通过 -R 递归修改指定目录下所有文件的访问权限。 |
chown [-R]<owner>[:<group>]<path> | 修改指定 GooseFS 文件或者文件夹的所有者信息，支持通过 -R 递归修改指定目录下所有文件的所有者。 |
copyFromLocal [--thread <num>] [--buffersize <bytes>] <src> <remoteDst> | 将指定的本地路径拷贝到指定的 GooseFS 文件路径上，可以设置该指令的并发数和缓冲区大小，调整拷贝速率。 |
copyToLocal [--buffersize <bytes>] <src> <localDst> | 将指定的 GooseFS 文件路径拷贝到指定的本地路径，可以设置缓冲区大小。 |
count [-h]<path> | 统计指定 GooseFS 路径的文件及文件夹总数。 |
cp [-R][--buffersize ] <src> <dst> | 将指定的 GooseFS 路径拷贝到另一个指定的 GooseFS 路径上，支持递归拷贝，支持调整缓冲区大小。 |
decompress [-a]<path>[-C <targetDir>] | 将指定 GooseFS 路径上的文件解压缩到目标目录下。 |
distributedCp [--active-jobs <num>] [--batch-size <num>] <src> <dst> | 分布式拷贝数据，将指定的 GooseFS 路径并发拷贝到另一个指定的 GooseFS 路径上，支持设置作业数和每批次的拷贝数量。 |
distributedLoad [-ignoreCap][-dryrun][-A][--replication ][--active-jobs <num>] [--batch-size <num>] [--expire-time] <path> | 分布式预热数据，将指定 GooseFS 路径的数据从底层存储中预热到缓存集群中，支持设置缓存副本数、作业数和每批次的拷贝数等参数。 |
distributedMv <src><dst> | 分布式移动数据，将指定的 GooseFS 路径并发移动到另一个指定的 GooseFS 路径上。 |
du [-h|-s|-g|-m]<path> | 输出指定 GooseFS 文件/文件夹的大小。 |
free [-f]<path> | 释放指定 GooseFS 文件/文件夹的缓存数据，该操作不会删除底层存储中的数据。 |
getCapacityBytes | 获取 GooseFS 的集群总容量大小。 |
getSyncPathList | 获取当前活跃的自动同步进程列表。 |
getUsedBytes | 获取 GooseFS 已缓存的容量大小。 |
getfacl <path> | 获取指定 GooseFS 文件路径的 Posix acl。 |
head [-c <bytes>]<path> | 输出指定 GooseFS 文件开头的指定长度内容，默认输出开头的1KB内容。 |
help [<command>] | 获取指定文件系统指令的帮助信息。 |
leader | 获取当前 GooseFS 集群的主 Master 节点信息。 |
listDecompressJobs <namespace>[-f <Running|Success|Failed|Pending>][-s <asc|desc>][-n <resultNums>][-p <pageIndex>] | 列出指定 GooseFS 命名空间下正在解压缩的任务列表，支持状态、升降序、每页打印的任务数以及任务索引等参数。 |
load [--local] <path> | 预热数据，将指定 GooseFS 路径的数据从底层存储加载到集群中。 |
loadMetadata [-R][-F]<path> | 预热元数据，将指定 GooseFS 路径的元数据信息加载到集群中，如果路径为目录，支持递归加载。 |
location <path> | 输出包含指定 GooseFS文件的节点列表。 |
ls [-d|-f|-p|-R|-h|--sort=option|--timestamp=option|-r|-a] <path> ... | 输出指定 GooseFS 路径下的所有文件和目录信息，支持递归列出等操作。 |
masterInfo | 输出 GooseFS Master 节点的容灾信息，例如 leader 节点信息、所有 master 节点列表以及配置的 zookeeper 地址（如有配置）等。 |
mkdir <path1>[path2]...[pathn] | 在制定的路径下创建文件夹，多个路径用空格或者 tab 键分隔；如果其中有任意路径已存在，那么该操作会抛出异常。 |
mount [--readonly] [--shared] [--option <key=val>] <goosefsPath> <ufsURI> | 将指定的底层存储路径挂载到 GooseFS 命名空间的指定路径下。如果指定路径已存在，那么挂载操作会抛出异常。挂载成功后，对该挂载点下的文件操作会同时作用于底层存储上的对应路径。 |
mv <src><dst> | 将指定的 GooseFS 路径并发移动到另一个指定的 GooseFS 路径上。如果目标路径已存在，该操作会抛出异常。 |
persist [-p|--parallelism <#>] [-t|--timeout <milliseconds>] [-w|--wait <milliseconds>] <path> [<path> ...] | 将仅存在于 GooseFS 上的文件或者文件夹持久化到底层存储上，支持设置并发度、超时时间等参数。 |
pin <path> media1 media2 media3 ... | 将指定 GooseFS 上的文件或者文件夹锁定到 GooseFS 集群中，避免被淘汰。如果指定路径为文件夹则默认递归锁定文件夹下所有文件。 |
queryDecompress <path>[<jobId>] | 查询指定 GooseFS 文件路径、指定任务id的解压缩任务。 |
rm [-R][-U][--goosefsOnly] <path> | 删除指定 GooseFS 文件路径的文件，支持递归删除，支持设定是否只删除缓存中的文件。 |
setReplication [--max <num> | --min <num>] <path> | 设置指定 GooseFS 上文件路径的副本数，支持设定副本数的最大值和最小值。 |
setTtl [--action delete_only_goosefs|delete|free] <path> <time to live> | 设置指定 GooseFS 上文件路径的TTL，支持设置到期删除操作类型，包括删除底层存储文件，删除本地文件，释放缓存。 |
setfacl [-d][-R][--set | -m | -x <acl_entries> <path>] | [-b | -k <path>] | 设置指定GooseFS上文件路径的权限信息，支持递归设置。 |
startSync <path> | 启动指定 GooseFS 文件路径的自动同步进程。 |
stat [-f <format>]<path> | 统计指定 GooseFS 路径的文件信息。 |
stopSync <path> | 停止指定 GooseFS 文件路径的自动同步进程。 |
tail [-c <bytes>]<path> | 输出指定 GooseFS 文件末尾的指定长度内容，默认输出最后的1KB内容。 |
test [-d|-f|-e|-s|-z]<path> | 测试指定 GooseFS 路径的属性，如果属性正确返回0，否则返回1。 |
touch <path> | 在指定的 GooseFS 路径上创建一个空文件。 |
unmount <goosefsPath> | 解除指定的文件挂载点。 |
unpin <path> | 将指定 GooseFS 上的文件或者文件夹解锁，解锁后可以被集群淘汰。如果指定路径为文件夹则默认递归解锁文件夹下所有文件。该操作为 pin 操作的反向操作。 |
unsetTtl <path> | 删除指定 GooseFS 文件路径的TTL信息。 |
updateMount [--readonly] [--shared] [--option <key=val>] <goosefsPath> | 更新指定 GooseFS 文件路径的挂载信息。 |
