Previous topic

help

Next topic

inspector

This Page

info

file adjustreplica|check|convert|copy|drop|info|layout|move|purge|rename|replicate|verify|version ...
'[eos] file ..' provides the file management interface of EOS.
Options:
file adjustreplica [--nodrop] <path>|fid:<fid-dec>|fxid:<fid-hex> [space [subgroup]] :
  tries to bring a files with replica layouts to the nominal replica level [ need to be root ]
file check [<path>|fid:<fid-dec>|fxid:<fid-hex>] [%size%checksum%nrep%checksumattr%force%output%silent] :
  retrieves stat information from the physical replicas and verifies the correctness
  - %size                                                       :  return with error code EFAULT if there is a mismatch between the size meta data information
  - %checksum                                                   :  return with error code EFAULT if there is a mismatch between the checksum meta data information
  - %nrep                                                       :  return with error code EFAULT if there is a mismatch between the layout number of replicas and the existing replicas
  - %checksumattr                                               :  return with error code EFAULT if there is a mismatch between the checksum in the extended attributes on the FST and the FMD checksum
  - %silent                                                     :  suppresses all information for each replica to be printed
  - %force                                                      :  forces to get the MD even if the node is down
  - %output                                                     :  prints lines with inconsistency information
file convert [--sync|--rewrite] [<path>|fid:<fid-dec>|fxid:<fid-hex>] [<layout>:<stripes> | <layout-id> | <sys.attribute.name>] [target-space] [placement-policy]:
  convert the layout of a file
  <layout>:<stripes>   : specify the target layout and number of stripes
  <layout-id>          : specify the hexadecimal layout id
  <conversion-name>    : specify the name of the attribute sys.conversion.<name> in the parent directory of <path> defining the target layout
  <target-space>       : optional name of the target space or group e.g. default or default.3
  <placement-policy>   : optional placement policy valid values are 'scattered','hybrid:<some_geotag>' and 'gathered:<some_geotag>'
  --sync               : run conversion in synchronous mode (by default conversions are asynchronous) - not supported yet
  --rewrite            : run conversion rewriting the file as is creating new copies and dropping old
file copy [-f] [-s] [-c] <src> <dst>                                   :  synchronous third party copy from <src> to <dst>
  <src>                                                         :  source can be a file or a directory (<path>|fid:<fid-dec>|fxid:<fid-hex>)
  <dst>                                                         :  destination can be a file (if source is a file) or a directory
  -f                                                            :  force overwrite
  -s                                                            :  don't print output
  -c                                                            :  clone the file (keep ctime, mtime)
file drop [<path>|fid:<fid-dec>|fxid:<fid-hex>] <fsid> [-f] :
  drop the file <path> from <fsid> - force removes replica without trigger/wait for deletion (used to retire a filesystem)
file info [<path>|fid:<fid-dec>|fxid:<fid-hex>] :
  convenience function aliasing to 'fileinfo' command
file layout <path>|fid:<fid-dec>|fxid:<fid-hex>  -stripes <n> :
  change the number of stripes of a file with replica layout to <n>
file layout <path>|fid:<fid-dec>|fxid:<fid-hex>  -checksum <checksum-type> :
  change the checksum-type of a file to <checksum-type>
file move [<path>|fid:<fid-dec>|fxid:<fid-hex>] <fsid1> <fsid2> :
  move the file <path> from  <fsid1> to <fsid2>
file purge <path> [purge-version] :
  keep maximum <purge-version> versions of a file. If not specified apply the attribute definition from sys.versioning.
file rename [<path>|fid:<fid-dec>|fxid:<fid-hex>] <new> :
  rename from <old> to <new> name (works for files and directories!).
file replicate [<path>|fid:<fid-dec>|fxid:<fid-hex>] <fsid1> <fsid2> :
  replicate file <path> part on <fsid1> to <fsid2>
file symlink <name> <link-name> :
  create a symlink with <name> pointing to <link-name>
file tag <name> +|-|~<fsid> :
  add/remove/unlink a filesystem location to/from a file in the location index - attention this does not move any data!
  unlink keeps the location in the list of deleted files e.g. the location get's a deletion request
file touch [<path>|fid:<fid-dec>|fxid:<fid-hex>] :
  create a 0-size/0-replica file if <path> does not exist or update modification time of an existing file to the present time
file verify <path>|fid:<fid-dec>|fxid:<fid-hex> [<fsid>] [-checksum] [-commitchecksum] [-commitsize] [-rate <rate>] :
  verify a file against the disk images
file verify <path|fid:<fid-dec>|fxid:<fid-hex> -resync :
  ask all locations to resync their file md records
  <fsid>          : verifies only the replica on <fsid>
  -checksum       : trigger the checksum calculation during the verification process
  -commitchecksum : commit the computed checksum to the MGM
  -commitsize     : commit the file size to the MGM
  -rate <rate>    : restrict the verification speed to <rate> per node
file version <path> [purge-version] :
  create a new version of a file by cloning
  <purge-version> : defines the max. number of versions to keep
file versions [grab-version] :
  list versions of a file
  grab a version [grab-version] of a file
  if not specified it will add a new version without purging any previous version
file share <path> [lifetime] :
  <path>          : path to create a share link
  <lifetime>      : validity time of the share link like 1, 1s, 1d, 1w, 1mo, 1y, ... default is 28d
file workflow <path>|fid:<fid-dec>|fxid:<fid-hex> <workflow> <event> :
  trigger workflow <workflow> with event <event> on <path>