1 01/13/87  excerpt_mst
 2 
 3 
 4 Syntax as a command:  excerpt_mst input_spec {names} {-control_args}
 5 
 6 
 7 Function:  excerpts (extracts) given segments from a Multics System
 8 Tape, or from an MST image stored in a file.
 9 
10 
11 Arguments:
12 input_spec
13    can be either the -input_volume or -input_file control argument, or
14    a reel identification number of the Multics System Tape.  The reel
15    identification number, which is site dependent, can be up to 32
16    characters long.
17 names
18    are the names of the specific segments to be extracted.  The star
19    convention is allowed.  If you supply no names, all of the segments
20    on the tape are extracted.  If a given segment has separate linkage
21    and definitions on the tape and has been extracted, the separate
22    linkage and definitions are extracted as well.  Segments extracted
23    are created in the current working directory.  Bit counts are set
24    from the SLT entry on the tape, as opposed to the actual length of
25    the segment on the tape.
26 
27 
28 Control arguments:
29 -input_volume volname, -ivol volname
30    gives the input tape volume name of the MST to be listed.
31 -input_file path, -if path
32    gives the pathname of a file containing an MST image.  This file
33    must have been previously created by generate_mst or copy_mst.
34 -density DEN, -den DEN
35    gives a tape density.  DEN may be 800, 1600 or 6250.  The input tape
36    is mounted on a tape drive capable of reading density DEN.  However,
37    the actual density at which the input tape is written determines the
38    density used for reading.  The default density is 1600 BPI (bits per
39    inch).
40 
41 
42 Notes:  A message is printed whenever a segment is extracted.  A
43 diagnostic is issued if you provide names that match no segments on the
44 tape.