Skip to content

parkit ls

Lists all data objects under any HPC-DME collection path and renders them as a tree with exact byte sizes. Uses the same backend as projark ls but accepts a full HPC-DME path instead of a project number.

Syntax

parkit ls <COLLECTION_PATH>
parkit ls <COLLECTION_PATH> --human-readable
parkit ls <COLLECTION_PATH> --json

Inputs

Argument Type Description
COLLECTION_PATH positional (required) Full HPC-DME collection path
--human-readable flag Show decimal KB, MB, GB instead of exact bytes
--json flag Emit results as a JSON array instead of the tree view

Examples

List a single project:

parkit ls /CCBR_Archive/GRIDFTP/Project_CCBR-982

List all projects under the GRIDFTP root (shows full multi-project hierarchy):

parkit ls /CCBR_Archive/GRIDFTP

Size formatting

Sizes default to exact integer bytes (B) for files and collection totals. Use --human-readable for decimal units with one digit after the decimal point: 1 KB = 1000 bytes, 1 MB = 1000000 bytes. For example, 57743 B becomes 57.7 KB. This avoids the previous binary/decimal unit mismatch with HPC-DME; displayed precision may still differ from the portal. --human-readable and --json are mutually exclusive. JSON retains numeric size_bytes and includes decimal size_human. Unknown sizes remain unknown.

Output

Default (tree view)

GRIDFTP  (2037000000000 B)
├── Project_CCBR-1068/  (1000000000000 B)
│   └── Analysis/  (1000000000000 B)
│       ├── ccbr1068.tar_0001                         500000000000 B     Samarth Mathur,260220
│       └── ccbr1068.tar_0002                         500000000000 B     Samarth Mathur,260220
└── Project_CCBR-982/  (1037000000000 B)
    ├── Analysis/  (571000000000 B)
    │   ├── ccbr982.tar_0001                          500000000000 B     Vishal Koparde,260625
    │   └── ccbr982.tar_0002                          71000000000 B      Vishal Koparde,260625
    └── Rawdata/  (466000000000 B)
        └── ccbr982.tar                               466000000000 B     Vishal Koparde,240429

The tree renders the full path hierarchy at any depth. Sub-collection totals are shown in parentheses.

JSON output (--json)

parkit ls /CCBR_Archive/GRIDFTP --json

Emits a JSON array of all data objects:

[
  {
    "path": "/CCBR_Archive/GRIDFTP/Project_CCBR-982/Analysis/ccbr982.tar_0001",
    "size_bytes": 500000000000,
    "size_human": "500.0 GB",
    "depositor": "Vishal Koparde",
    "deposit_date": "260625"
  }
]

Notes

  • No Helix host check, no tmux/screen requirement, no sync-gate check.
  • Newly deposited files may not appear for up to 60 minutes due to DME search index lag.
  • For project-level queries, prefer projark ls <projectnumber> which constructs the path automatically.