goosefs fs [generic options]
文件系统各项指令列表如下：
| 指令操作 | 指令说明 |
| cat <path> | 打印指定的 GooseFS 路径中的文件内容。 |
| checkConsistency [-r] [-t|–threads <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> <dst> | 将指定的 GooseFS 文件路径拷贝到指定的本地路径，可以设置缓冲区大小。 |
| count [-h]<path> | 统计指定 GooseFS 路径的文件及文件夹总数。 |
| cp [-R] [–buffersize <bytes>] <src> <dst> | 将指定的 GooseFS 路径拷贝到另一个指定的 GooseFS 路径上，支持递归拷贝，支持调整缓冲区大小。 |
| decompress [-a]<path>[-C <targetDir>] | 将指定 GooseFS 路径上的文件解压缩到目标目录下。 |
| distributedCp [–active-jobs <num>] [–batch-size <num>] <src> <dst> | 分布式拷贝数据，将指定的 GooseFS 路径并发拷贝到另一个指定的 GooseFS 路径上，支持设置作业数和每批次的拷贝数量。 |
| distributedLoad [-A] [–replication <num>] [–active-jobs <num>] [–batch-size <num>] [–expire-time <time>] [–file-list <path>] [–report-path <path>] -F -M <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 文件路径的挂载信息。 |