#状态查看命令

yfscmd提供了show命令用于查看YFS内部状态，目前支持查看：

磁盘组信息
故障组信息
磁盘信息
可在线修改配置（即修改立即生效 = 是）的YFS参数信息

# show diskgroup

本命令用于罗列YFS中磁盘组信息，命令格式：

show diskgroup

磁盘组的信息项包括：

id : 磁盘组的全局唯一编号，在故障组或磁盘的信息中将记为dgid。
name ：磁盘组的名称。
type：磁盘组的类型，分为SYSTEM和USER。
- SYSTEM：系统磁盘组，用于存储YFS自身元数据，请勿用于存储业务数据。
- USER：数据磁盘组，用于存储业务数据文件。
level ：磁盘组的冗余度，每个磁盘组的冗余度相互独立。
- 0：表示冗余度为EXTERNAL。该配置下，所有数据仅存储1份，无冗余副本。
- 1：表示冗余度为NORMAL。系统磁盘组在该配置下提供3份副本；数据盘组在该配置下提供[2,3]份YFS元数据副本（具体份数取决于故障组数量）+2份用户数据副本。
- 2：表示冗余度为HIGH。系统磁盘组在该配置下提供5份副本；数据盘组在该配置下提供[3,5]份YFS元数据副本（具体份数取决于故障组数量）+3份用户数据副本。
au_size ：分配单元的大小，单位为字节，是YFS分配磁盘空间的最小维度。
stat：磁盘组的挂载状态。
- MOUNTED：表示已挂载。
- DISMOUNTED：表示未挂载。
block_size：文件数据块的大小，单位为字节。
total_mb：磁盘组的总容量，单位为MB。
free_mb：磁盘组的可用空间，单位为MB。
usable_file_mb：磁盘组的可用文件大小，即磁盘组的可用空间扣除多副本所需容量后的值，单位为MB。

# lsdg

本命令用于罗列YFS中磁盘组信息，同show diskgroup，命令格式为：

lsdg

# show failgroup

本命令用于罗列YFS中故障组信息，命令格式：

show failgroup

故障组的信息项包括：

id：故障组的全局唯一编号，在磁盘的信息中将记为fgid。
name：故障组的名称。
dgid：故障组所属磁盘组的编号。

# show disk

本命令用于罗列YFS中磁盘信息，命令格式：

show disk

磁盘信息项包括：

id：磁盘的全局唯一编号。
interid：在磁盘组内的唯一编号。
name：磁盘的名称。
status: 磁盘的状态，包括：
- NORMAL：磁盘状态正常
- OFFLINE_SYNC：磁盘上线过程中的临时状态，此状态的磁盘可写不可读。上线完成后，磁盘变为正常状态。
- OFFLINE：磁盘已离线
fgid：磁盘所属故障组的编号。
dgid：磁盘所属磁盘组的编号。
au_size：分配单元的大小。
au_count：磁盘中分配单元的数量。
total_mb：磁盘的总容量，单位为MB。
free_mb：磁盘当前可用容量，单位为MB。
redundancy：磁盘所属磁盘组的冗余度，分为EXTERNAL、NORMAL或HIGH。
path：磁盘路径。
partners：当前磁盘的伙伴磁盘列表，磁盘组内的唯一编号（interid）间使用空格隔开。

# lsdsk

本命令用于罗列YFS中磁盘信息，同show disk，命令格式为：

lsdsk

# iostat

本命令用于罗列YFS中磁盘的读写统计信息，命令格式：

iostat

磁盘读写统计信息包括：

id：磁盘的全局唯一编号。
name：磁盘的名称。
group_number：磁盘所属磁盘组的编号。
reads：当前实例读取该磁盘的总次数。
writes：当前实例写入该磁盘的总次数。
read_bytes：当前实例读取该磁盘的总字节数。
written_bytes：当前实例写入该磁盘的总字节数。
read_time_us：当前实例读取该磁盘的总时长，单位为微秒。
write_time_us：当前实例写入该磁盘的总时长，单位为微妙。
path：磁盘路径。

# show job

本命令用于罗列磁盘修复计划的信息，命令格式：

show job

修复计划的信息包括：

id：计划的全局唯一编号。
dgname：计划所属磁盘组的名称。
oper：计划的类型，目前恒为ONLINE，更换磁盘也将归类为ONLINE。
disk：计划操作的目标磁盘。
power：计划的数据迁移强度。
status：计划的状态。
- IDEL：表示当前计划正在等待执行。
- RUNNING：表示当前计划正在执行中。
- FINISH：表示当前计划已完成。
- CANCEL：表示当前计划已被取消，可能因错误自动取消（可通过errno和errmsg确认）或人为主动取消。
create_time：创建计划的时间。
end_time：计划的完成时间，若暂未完成则为空。
errno：仅任务异常时有意义，异常对应的错误码。
errmsg：仅任务异常时有意义，异常对应的错误信息。

# show param

本命令用于罗列YFS中可在线修改配置（即修改立即生效 = 是）的参数信息。

可选过滤条件filter，精确匹配或部分匹配，支持多个条件。多个过滤条件等效filter OR filter，列出过滤条件匹配的所有结果。

命令格式：

show param [filter [filter] ...]

参数信息包括：

name：参数名称。
value：参数值。

# show status

本命令用于查看YFS服务的内部状态。

Note:

本命令属于实验室特性，仅用于调试。

命令格式：

Instance
--------------------
home: /home/yashan/YASDB_NODE/node0

Topo
--------------------
  lock: 0
  id: 0
  master id: 0
  topoTerm: 0
  switchStatus: 0
  instCnt: 0
  aliveCnt: 0
  isWaitNodeJoin: 0
  yfsInstMap:   00000000
  ycsInstMap: 00000000
  topoVer: 0
  waitNodeJoinMap: 00000000
  buildingInstMap:  00000000
  thread:
    name: 
    startTime: 1970-01-01 12:01:00
    closed: 0
    status: COD_THREAD_STATUS_INIT

Shm
--------------------
max  : 1.52GB   
total: 64.00MB  
used : 35.11MB  
free : 28.89MB  
areas: 1
  curr size: 64.00MB  
  next size: 128.00MB 

HandlerPool
--------------------
count   = 1024
hwm     = 8
used    = 8
userCnt = 1

Mem
--------------------
max  : 256.00MB  
total: 1.00MB   
blocks:
  size : 64.00KB  
  count: 16

Hashmap
--------------------
DG0:
  capacity: 524288
  max load: 367001
  used    : 0