github.com/NVIDIA/aistore@v1.3.23-0.20240517131212-7df6609be51d/cmd/xmeta/README.md (about)

     1  xmeta is a low-level utility to format (or extract into plain text)
     2  assorted AIS control structures.
     3  
     4  ```console
     5  Usage of xmeta:
     6    -f string
     7          override automatic format detection (values are smap, bmd, rmd, conf, vmd, mt)
     8    -h    print usage and exit
     9    -in string
    10          fully-qualified input filename
    11    -out string
    12          output filename (optional when extracting)
    13    -x    true: extract AIS-formatted metadata type, false: pack and AIS-format plain-text metadata
    14  Build:
    15          go install xmeta.go
    16  
    17  Examples:
    18          xmeta -h                                          - show usage
    19          # Smap:
    20          xmeta -x -in=~/.ais0/.ais.smap                    - extract Smap to STDOUT
    21          xmeta -x -in=~/.ais0/.ais.smap -out=/tmp/smap.txt - extract Smap to /tmp/smap.txt
    22          xmeta -in=/tmp/smap.txt -out=/tmp/.ais.smap       - format plain-text /tmp/smap.txt
    23          # BMD:
    24          xmeta -x -in=~/.ais0/.ais.bmd                     - extract BMD to STDOUT
    25          xmeta -x -in=~/.ais0/.ais.bmd -out=/tmp/bmd.txt   - extract BMD to /tmp/bmd.txt
    26          xmeta -in=/tmp/bmd.txt -out=/tmp/.ais.bmd         - format plain-text /tmp/bmd.txt
    27          # RMD:
    28          xmeta -x -in=~/.ais0/.ais.rmd                     - extract RMD to STDOUT
    29          xmeta -x -in=~/.ais0/.ais.rmd -out=/tmp/rmd.txt   - extract RMD to /tmp/rmd.txt
    30          xmeta -in=/tmp/rmd.txt -out=/tmp/.ais.rmd         - format plain-text /tmp/rmd.txt
    31          # Config:
    32          xmeta -x -in=~/.ais0/.ais.conf                    - extract Config to STDOUT
    33          xmeta -x -in=~/.ais0/.ais.conf -out=/tmp/conf.txt - extract Config to /tmp/config.txt
    34          xmeta -in=/tmp/conf.txt -out=/tmp/.ais.conf       - format plain-text /tmp/config.txt
    35          # VMD:
    36          xmeta -x -in=~/.ais0/.ais.vmd                     - extract VMD to STDOUT
    37          xmeta -x -in=~/.ais0/.ais.vmd -out=/tmp/vmd.txt   - extract VMD to /tmp/vmd.txt
    38          xmeta -in=/tmp/vmd.txt -out=/tmp/.ais.vmd         - format plain-text /tmp/vmd.txt
    39          # EC Metadata:
    40          xmeta -x -in=/data/@ais/abc/%mt/readme            - extract Metadata to STDOUT with auto-detection (by directory name)
    41          xmeta -x -in=./readme -f mt                       - extract Metadata to STDOUT with explicit source format
    42          # LOM (readonly, no format auto-detection):
    43          xmeta -x -in=/data/@ais/abc/%ob/img001.tar -f lom                   - extract LOM to STDOUT
    44          xmeta -x -in=/data/@ais/abc/%ob/img001.tar -out=/tmp/lom.txt -f lom - extract LOM to /tmp/lom.txt
    45  ```