os2sdk/bin/doc/shd.hlp - annotate

Return to shd.hlp CVS log

Up to [OS/2 SDKs] / os2sdk / bin / doc

Annotation of os2sdk/bin/doc/shd.hlp, revision 1.1.1.1

1.1 root 1: Name
2:
3: shd - Displays named shared memory segments or files in hexadecimal
4: format. Works in both protected mode and real mode with real mode
5: only allowing file examination.
6:
7: Syntax
8:
9: shd [-format] [-mode] [-s offset] [-n count] [name]...
10:
11: Description
12:
13: The shd command displays the contents of named shared memory segments or
14: files in hexadecimal, octal, decimal, and character formats. Control
15: over the specification of ranges of characters is also available.
16:
17: The default behavior is with the following flags set: "-abx -A". This
18: says that address (shared memory or file offsets) and bytes are printed
19: in hexadecimal and that characters are also printed.
20:
21: If no 'name' argument is given, the standard input is read. If one or
22: more names are given, shd first checks to see if 'name' is a valid shared
23: memory segment. If a shared memory segment does not exist, then shd
24: checks for a file with that name. In either case once a valid shared
25: segment or file has been found, all other names on the command line are
26: treated in the same manner as the first.
27:
28: Options include:
29:
30: -s offset
31:
32: Specify the beginning offset in the memory segment or file where
33: printing is to begin. If no memory segment or file argument is
34: given, or if a seek fails because the input is a pipe, 'offset' bytes
35: are read from the input and discarded. Otherwise, a seek error will
36: terminate processing of the current memory segment or file.
37:
38: The offset may be given in decimal, hexadecimal (preceded by '0x'),
39: or octal (preceded by '0'). It is optionally followed by one of the
40: following multipliers: w, l, b, k; for words (2 bytes), long words (4
41: bytes), blocks (512 bytes), or K bytes (1024 bytes). Note that this
42: is the one case where "b" does not stand for bytes. Since specifying
43: a hexadecimal offset in blocks would result in an ambiguous trailing '
44: b', any offset and multiplier may be separated by an asterisk (*).
45:
46: -n count
47:
48: Specify the number of bytes to process. The count is in the same
49: format as offset, above.
50:
51: Mode Flags
52:
53: The mode flags may be used to override the default of checking first
54: for a named shared segment and then for a file that matches the
55: first 'name' argument.
56:
57: -m
58:
59: Sets the mode to named shared memory segments and causes the
60: program to look only for a named shared memory segment and if not
61: found, will not look for a file by the name and will announce
62: that it was not found.
63:
64: -f
65:
66: Sets the mode to files and cause the program to look only for a
67: file and if not found will announce that it was not found.
68:
69: Format Flags
70:
71: Format flags may specify addresses, characters, bytes, words (2
72: bytes), or longs (4 bytes) to be printed in hexadecimal, decimal or
73: octal. Two special formats may also be indicated: text or ASCII.
74: Format and base specifiers may be freely combined and repeated as
75: desired in order to specify different bases (hexadecimal, decimal or
76: octal) for different output formats (addresses, characters, etc.).
77: All format flags appearing in a single argument are applied as
78: appropriate to all other flags in that argument.
79:
80: acbwlA
81:
82: Output format specifiers for addresses, characters, bytes, words,
83: longs and ASCII, respectively. Only one base spec will be used
84: for addresses; the address will appear on the first line of
85: output that begins each new offset in the input.
86:
87: The character format prints printable characters unchanged,
88: special C escapes as defined in the language, and remaining
89: values in the specified base.
90:
91: The ASCII format prints all printable characters unchanged, and
92: all others as a period (.). This format appears to the right of
93: the first of other specified output formats. A base spec has no
94: meaning with the ASCII format. If no other output form at (other
95: than address) is given, bx is assumed. If no base spec is given,
96: all of xdo are used.
97:
98: xdo
99:
100: Output base specifiers for hexadecimal, decimal and octal. If no
101: format spec is given, all of acbwl are used.
102:
103: t
104:
105: Print a text file, each line preceded by the address in the file.
106: Normally, lines should be terminated by a \n character; but long
107: lines will be broken up. Control characters in the range 0x00 to
108: 0x1f are printed as '^@' to '^_'. Bytes with the high bit set
109: are preceded by a tilde (~) and printed as if the high bit were
110: not set. The special characters (^, ~, \) are preceded by a
111: backslash (\) to escape their special meaning. As special cases,
112: two values are represented numerically as '\177 ' and '\377'.
113: This flag will override all output format specifiers except
114: addresses.
115:
116: Names
117:
118: More than one name may be specified in the 'name' argument. There are
119: two formats expected depending on the mode of use.
120:
121: Memory Mode
122:
123: The names listed on the command line must not include the "SHAREMEM\"
124: part of the named shared memory segment. If you want to examine a
125: named shared memory segment it would normally be addressed as:
126: "\SHAREMEM\name.ext" using the standard file naming conventions. This
127: program automatically appends the "\SHAREMEM\" portion of the named
128: shared memory segment and requires that the name argument only
129: include the "name.ext" portion of the named shared memory
130: specification. It will not find the segment if the entire shared
131: memory path is used.
132:
133: File Mode
134:
135: The names listed on the command line may follow the standard file
136: naming conventions with complete path specification as desired.

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.