1 03/04/85  dump_segment_
 2 
 3 
 4 This subroutine prints the dump of a segment formatted in the same way
 5 as the dump_segment command would print it.  The output format is
 6 controlled by a bit string that allows most of the formatting control
 7 arguments available to dump_segment.
 8 
 9 
10 Entry points in dump_segment_:
11    (List is generated by the help command)
12 
13 
14 :Entry:  dump_segment_:  03/04/85  dump_segment_
15 
16 
17 Function:
18 prints the dump of a segment formatted in the same way as the
19 dump_segment command would print it.
20 
21 
22 
23 Syntax:
24 declare dump_segment_ entry (ptr, ptr, fixed bin, fixed bin(18),
25      fixed bin(18), bit(*));
26 call dump_segment_ (iocb_ptr, first, block_size, offset, count,
27      format);
28 
29 
30 Arguments:
31 iocb_ptr
32    is a pointer to the I/O control block that specifies where the dump
33    is to be written.  (Input)
34 first
35    is a pointer to the first word of the data to be dumped.  (Input)
36 block_size
37    is the number of words in the block if blocked output is desired.
38    If unblocked output is desired, this is zero.  (Input)
39 offset
40    is an arbitrary offset to be printed in addition to the address of
41    the first word of data to be dumped if the offset option in the
42    format string is specified.  (It is reset to this initial value at
43    the start of each block.)  (Input)
44 
45 
46 count
47    is the number of words to dump, starting with the word pointed to by
48    first.  (Input)
49 format
50    is a format control bit string with the following definition:  (See
51    the dump_segment command in the Multics Commands and Active
52    Functions Manual, for a full discussion of these arguments.) (Input)
53 
54 
55 :Entry:  string:  03/04/85 dump_segment_$string
56 
57 
58 Function:  This entry point returns the formatted dump of a segment.
59 The ouput format is controlled by a bit string that allows most of the
60 formatting control arguments available to the dump_segment command.
61 
62 
63 Syntax:
64 dcl dump_segment_$string entry (ptr, fixed bin (21), ptr, fixed bin,
65      fixed bin (18), fixed bin (18), bit (*));
66 call dump_segment_$string (string_ptr, string_length, first,
67      block_size, offset, count, format)
68 
69 
70 Arguments:
71 string_ptr
72    is the pointer to the varying character string to place the output
73    in.  (Input)
74 string_length
75    is the maximum length of the varying character string.  (Input)
76 first
77    is the pointer to the first word of data to be dump.  (Input)
78 block_size
79    is the output dump in blocks of this number of words.  (Input)
80 offset
81    is an arbitrary offset to be printed in addition to the address of
82    the first word of data to be dumped if the offset option in the
83    format string is specified.  (It is reset to this initial value at
84    the start of each block.)  (Input)
85 
86 
87 count
88    is the number of words to be dump.  (Input)
89 format
90    is the bit string controlling the output modes.  (Input) Described
91    in dump_segment_format.incl.pl1.
92 
93 
94 Notes:  The dump_segment_format_structure is structure is declared in
95 dump_segment_format.incl.pl1.