New upstream version 2.20
[debian/cpmtools] / cpmls.1
1 .TH CPMLS 1 "October 25, 2014" "CP/M tools" "User commands"
2 .SH NAME \"{{{roff}}}\"{{{
3 cpmls \- list sorted contents of directory
4 .\"}}}
5 .SH SYNOPSIS \"{{{
6 .ad l
7 .B cpmls
8 .RB [ \-f
9 .IR format ]
10 .RB [ \-T
11 .IR libdsk-type ]
12 .RB [ \-d | \-D | \-F | \-A | \-l [ \-c ][ \-i ]]
13 .I image
14 .RI [ file-pattern "...]"
15 .ad b
16 .\"}}}
17 .SH DESCRIPTION \"{{{
18 \fBCpmls\fP lists the sorted contents of the directory.
19 .\"}}}
20 .SH OPTIONS \"{{{
21 .IP "\fB\-f\fP \fIformat\fP"
22 Use the given CP/M disk \fIformat\fP instead of the default format.
23 .IP "\fB\-T\fP \fIlibdsk-type\fP"
24 libdsk driver type, e.g. \fBtele\fP for Teledisk images or \fBraw\fP for raw images
25 (requires building cpmtools with support for libdsk).
26 .IP \fB\-d\fP
27 Old CP/M 2.2 dir output.
28 .IP \fB\-D\fP
29 P2DOS 2.3 ddir-like output.
30 .IP \fB\-F\fp
31 CP/M 3.x dir output.
32 .IP \fB\-A\fp
33 E2fs lsattr-like output.
34 .IP \fB\-l\fP
35 Long UNIX-style directory listing including size, time stamp and user number.
36 .IP \fB\-c\fP
37 Output the creation time, not the modification time.
38 .IP \fB\-i\fP
39 Print index number of each file.
40 .\"}}}
41 .SH "RETURN VALUE" \"{{{
42 Upon successful completion, exit code 0 is returned.
43 .\"}}}
44 .SH ERRORS \"{{{
45 Any errors are indicated by exit code 1.
46 .\"}}}
47 .SH ENVIRONMENT \"{{{
48 CPMTOOLSFMT     Default format
49 .\"}}}
50 .SH FILES \"{{{
51 ${prefix}/share/diskdefs        CP/M disk format definitions
52 .\"}}}
53 .SH AUTHORS \"{{{
54 This program is copyright 1997\(en2012 Michael Haardt
55 <michael@moria.de>.  The Windows port is copyright 2000, 2001, 2011 John Elliott
56 <jce@seasip.demon.co.uk>.
57 .PP
58 This program is free software; you can redistribute it and/or modify
59 it under the terms of the GNU General Public License as published by
60 the Free Software Foundation; either version 3 of the License, or
61 (at your option) any later version.
62 .PP
63 This program is distributed in the hope that it will be useful,
64 but WITHOUT ANY WARRANTY; without even the implied warranty of
65 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
66 GNU General Public License for more details.
67 .PP
68 You should have received a copy of the GNU General Public License along
69 with this program.  If not, write to the Free Software Foundation, Inc.,
70 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
71 .\"}}}
72 .SH "SEE ALSO" \"{{{
73 .IR cpmcp (1),
74 .IR cpm (5)
75 .\"}}}