ws_list - Man Page

list workspaces


ws_list [-h] [-F FILESYSTEM] [-g] [-l] [-s] [-v] [-s] [-r] [-N] [-R] [-C] [PATTERN]


List workspaces of the calling user. The output can be restricted to workspaces in a certain FILESYSTEM, matching a certain PATTERN, and can be sorted according to different criterias.

The idea of the workspace is to allow the administrator to keep control of filespace in working filesystems, and to avoid the situations that data of past and finished projects/jobs is idling for ever on disks. A user can create and dispose arbitrary number of workspaces, they are cheap, and can be created e.g. for each job.

From the system side, workspaces will be deleted after beeing expired. A friendly user can release workspaces before the expiration date using ws_release which will mark the workspace for future deletion.

Deletion is probably a task done once a night and not immediately.

If a workspace was forgotten and expired, it might make sense to contact the administrator, as he probaly can restore a workspace for some time, if disk space is not low.



display usage help text


list the available filesystems, only filesystems the user has access to will be shown.


select the filesystem to list the workspaces from.


show group-workspaces visible for current group in addition to own workspaces


short listing, only workspace names will be listed.


terse listing, less information is shown


verbose listing, all information is shown


sort according to names of workspaces


sort according to remaining time of workspaces


sort according to creation date of workspaces


invert the sorting of -N, -C or -R


list all workspaces, unsorted:


list available filesystems:

ws_list -l

list all workspaces, sorted by remaining time, shortest first:

ws_list -R

list all workspaces, sorted by creation time, oldest last:

ws_list -R -r list a specific workspace ws_list my_workspace


Written by Holger Berger

See Also

ws_allocate, ws_release, ws_restore


October 2019 USER COMMANDS