![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to cpm.1 CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [CSRG BSD Unix] / 43BSDReno / share / doc / ucs / single|
Return to cpm.1 CVS log | Up to [CSRG BSD Unix] / 43BSDReno / share / doc / ucs / single |
1.1 root 1: .TH CPM 1 "3 May 1983"
2: .UC 4
3: .SH NAME
4: cpm \- read and write CP/M\*R floppy disks
5: .SH SYNOPSIS
6: .B cpm
7: [ options ] [ filename ]
8: .SH DESCRIPTION
9: .PP
10: .I Cpm
11: reads and writes files with an internal structure
12: like a CP/M file system. By default
13: .I cpm
14: assumes that the specified file has the parameters of a standard IBM format
15: single sided single density 8" CP/M floppy disk, i.e., 2002 records
16: containing 128 bytes each, of which 52 are reserved for system use and
17: 16 (2 blocks) are used by the directory (maximum 64 directory entries).
18: These parameters may be changed by
19: specifying the appropriate flags (see below). Thus, various double
20: density formats may also be read and written, provided that the hardware
21: can handle the actual format.
22: .PP
23: The specified file may be a floppy disk drive (e.g., /dev/floppy on
24: an 11/780 or /dev/rrx?b if rx02 drives are available on your system),
25: or a standard UNIX file with the appropriate structure. Since
26: it may be inconvenient (and slow) to access the device directly, in
27: particular the console floppy on an 11/780, it is always a good idea to
28: copy the contents of the diskette into a standard file using
29: \fIdd\fP(1), e.g.,
30: .sp
31: .nf
32: dd if=/dev/floppy of=yourfile bs=128 count=2002
33: .fi
34: .PP
35: On most systems you have to be superuser to access the console
36: floppy and to be able to write to rx02's.
37: .PP
38: Flags:
39: .TP 20
40: .BR \-d
41: display directory on standard output
42: .TP
43: .BR \-B
44: the files specified with the \fBc\fR or \fBC\fR flag contain binary
45: code rather than plain text (default)
46: .TP
47: \fB\-c \fIname1 name2\fR
48: copy the CP/M file \fIname1\fR to the UNIX file \fIname2\f
49: .TP
50: \fB\-C \fIname1 name2\fR
51: copy the UNIX file \fIname1\fR to the CP/M file \fIname2\f
52: .TP
53: \fB\-p \fIname\fR
54: copy the specified CP/M file to standard output
55: .TP
56: .BR \-i
57: enter interactive mode (all the above flags are turned off)
58: .TP
59: .BR \-I
60: force initializtion of the specified CP/M file (e.g., delete all files)
61: .TP
62: .BI \-s n
63: skew factor (sector interleaving); default is 6
64: .TP
65: .BI \-b n
66: block size (in bytes); default is 1K bytes
67: .TP
68: .BI \-m n
69: max number of directory entries; default is 64
70: .TP
71: .BI \-l n
72: sector size (in bytes); default is 128
73: .TP
74: .BI \-r n
75: number of sectors per track; default is 26
76: .PP
77: If the
78: .B \-i
79: flag is specified, the filename argument must always be present.
80: If the specified file does not exist, a
81: new file will be initialized. The
82: .B \-C,
83: .B \-c
84: and
85: .B \-p
86: flags are mutually exclusive.
87: .PP
88: The following commands are available in interactive mode:
89: .TP 24
90: \fBccopyin \fIunixfile cpmfile\fR
91: copy UNIX binary file to CP/M
92: .TP
93: \fBccopyout \fIcpmfile unixfile\fR
94: copy CP/M binary file to UNIX
95: .TP
96: \fBcopyin \fIunixfile cpmfile\fR
97: copy UNIX text file to CP/M
98: .TP
99: \fBcopyout \fIcpmfile unixfile\fR
100: copy CP/M text file to UNIX
101: .TP
102: \fBdel\fR[ete] \fIfilename\fR
103: a synonym for \fIerase\fR
104: .TP
105: \fBdir\fR[ectory] or \fBls\fP
106: display directory
107: .TP
108: \fBera\fR[se] \fIfilename\fR
109: delete the given file
110: .TP
111: \fBhel\fR[p]
112: print a short description of each command
113: .TP
114: \fBlog\fR[out] or \fBexi\fR[t] or \fB^D\fR
115: terminate, return to the shell
116: .TP
117: \fBren\fR[ame] \fIfile1 file2\fR
118: rename \fIfile1\fR to \fIfile2\fR
119: .TP
120: \fBtyp\fR[e] \fIfilename\fR
121: print CP/M file to console
122: .PP
123: .sp
124: The commands may be abbreviated as indicated by brackets.
125: CP/M file names are automatically converted to upper case.
126: The copy commands refuse to overwrite existing files.
127: .PP
128: If the CP/M floppy file becomes full during a file transfer from UNIX,
129: the file is closed and the command terminated.
130: The data already written to the CP/M file will be saved.
131: .PP
132: The
133: .I copyout
134: command assumes that CP/M text files
135: have cr+lf as line terminators and removes carriage returns.
136: .I Copyin
137: adds a carriage return in front of each line-feed, and adds
138: a ^Z to the end of the file. The binary copy commands provide
139: for ``raw'' file copying, thus making it possible to copy code files
140: to and from diskettes.
141: .PP
142: Interrupts are recognized in interactive mode, and will return you to
143: the command level.
144: .SH FILES
145: /dev/floppy
146: .br
147: /dev/rrx?b
148: .br
149: /usr/new/lib/cpm.hlp
150: .SH SEE ALSO
151: dd(1), rx(4v)
152: .SH BUGS
153: CP/M user numbers are ignored, files written
154: to the CP/M floppy file will always have user number 0.
155: .PP
156: No testing has been done with double density floppies.
157: .PP
158: CP/M filename extensions containing more than 3 characters will quietly be
159: truncated.
160: .PP
161: Wildcards are not supported.
162: .PP
163: The distinction between text and binary files is clumsy but necessary
164: because CP/M uses CR/LF for line termination.
165: .SH AUTHOR
166: Helge Skrivervik
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.