1ws_list(1)                  General Commands Manual                 ws_list(1)
2
3
4

NAME

6       ws_list - list workspaces
7
8

SYNOPSIS

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

DESCRIPTION

15       List workspaces of the calling user.  The output can be  restricted  to
16       workspaces in a certain FILESYSTEM, matching a certain PATTERN, and can
17       be sorted according to different criterias.
18
19
20       The idea of the workspace is to allow the administrator to keep control
21       of  filespace  in working filesystems, and to avoid the situations that
22       data of past and finished projects/jobs is idling for ever on disks.  A
23       user  can  create  and dispose arbitrary number of workspaces, they are
24       cheap, and can be created e.g. for each job.
25
26       From the system side, workspaces will be deleted after beeing  expired.
27       A friendly user can release workspaces before the expiration date using
28       ws_release which will mark the workspace for future deletion.
29
30       Deletion is probably a task done once a night and not immediately.
31
32       If a workspace was forgotten and expired, it might make sense  to  con‐
33       tact  the administrator, as he probaly can restore a workspace for some
34       time, if disk space is not low.
35
36

OPTIONS

38       -h     display usage help text
39
40       -l     list the available filesystems, only filesystems  the  user  has
41              access to will be shown.
42
43       -F     select the filesystem to list the workspaces from.
44
45       -g     show  group-workspaces  visible for current group in addition to
46              own workspaces
47
48       -s     short listing, only workspace names will be listed.
49
50       -t     terse listing, less information is shown
51
52       -v     verbose listing, all information is shown
53
54       -N     sort according to names of workspaces
55
56       -R     sort according to remaining time of workspaces
57
58       -C     sort according to creation date of workspaces
59
60       -r     invert the sorting of -N, -C or -R
61
62

EXAMPLES

64       list all workspaces, unsorted:
65              ws_list
66
67       list available filesystems:
68              ws_list -l
69
70       list all workspaces, sorted by remaining time, shortest first:
71              ws_list -R
72
73       list all workspaces, sorted by creation time, oldest last:
74              ws_list -R -r list a specific workspace ws_list my_workspace
75
76

AUTHOR

78       Written by Holger Berger
79
80

SEE ALSO

82       ws_allocate, ws_release, ws_restore
83
84
85
86USER COMMANDS                    October 2019                       ws_list(1)
Impressum