1 08/31/83  walk_subtree, ws
 2 
 3 Syntax:  ws path command_line {-control_args}
 4 
 5 
 6 Function:  executes a specified command line in the directory selected
 7 (called the starting node) and in its inferior directories.  It prints
 8 the pathname of every directory in which the command line is executed.
 9 
10 
11 Arguments:
12 path
13    is the starting node.  This must be the first argument.  A path of
14    -working_directory (-wd) specifies the working directory.
15 command_line
16    is the command line to be executed.  The entire command line is
17    taken to be a single argument.  A multiple-word command line should
18    be typed as a quoted string.
19 
20 
21 Control arguments:
22 -brief, -bf
23    suppresses printing of the names of the directories in which the
24    command line is executed.
25 -bottom_up, -bu
26    causes execution of the command line to commence at the last level
27    and to proceed upward through the storage system hierarchy until the
28    first level is reached.  In the default mode, execution begins at
29    the highest (first) level and proceeds downward to the lowest (last)
30    level.
31 -first N, -ft N
32    makes N the first level in the storage system hierarchy at which the
33    command line is to be executed, where, by definition, the starting
34    node is level 1.  The default is -ft 1.
35 
36 
37 -last N, -lt N
38    makes N the last level in the storage system hierarchy at which the
39    command line is to be executed.  The default is -lt 99999, i.e., all
40    levels.
41 -msf
42    treats multisegment files as directories, which, normally, are not
43    considered as such.
44 -priv
45    invokes a highly privileged primitive to list directories.  It
46    requires access to the hphcs_ gate.
47 
48 
49 Notes:  This command has a cleanup handler--if one quits out of it and
50 immediately types "rl" (release), one's directory is changed back to
51 what it was prior to walk_subtree's invocation.