mirror of https://github.com/wwarthen/RomWBW.git
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
235 lines
6.6 KiB
235 lines
6.6 KiB
<HTML><HEAD><TITLE>CPMLS - list sorted contents of directory</TITLE>
|
|
</HEAD><BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#008000" ALINK="#008000" VLINK="#008000">
|
|
<FONT FACE="Arial" SIZE=2>
|
|
<H2><A NAME="lbAA">CPMLS</A></H2>
|
|
Section: User commands (1)<BR>
|
|
Updated: June 16, 2008<BR><BR>
|
|
|
|
<A HREF="#index">Index </A>
|
|
<A HREF=" ./index.htm">Return to Main Contents </A>
|
|
<a href="#disclaimer">Disclaimer </a><br><BR><HR>
|
|
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<B>NAME cpmls - list sorted contents of directory</B><BR><BR>
|
|
|
|
<A NAME="lbAC"> </A>
|
|
<B>SYNOPSIS</B><BR><BR>
|
|
|
|
|
|
<B>cpmls</B>
|
|
|
|
[<B>-d</B>|<B>-D</B>|<B>-F</B>|<B>-A</B>|<B>-l</B>[<B>-c</B>][<B>-i</B>]]
|
|
|
|
[<B>-f</B>
|
|
|
|
<I>format</I>]
|
|
|
|
<I>image</I>
|
|
|
|
[<I>file-pattern</I>...]
|
|
<BR><BR>
|
|
|
|
<A NAME="lbAD"> </A>
|
|
<B>DESCRIPTION</B><BR><BR>
|
|
|
|
<B>Cpmls lists the sorted contents of the directory.</B>
|
|
<BR>
|
|
<BR>
|
|
|
|
<A NAME="lbAE"> </A>
|
|
<B>OPTIONS</B><BR><BR>
|
|
|
|
<DL COMPACT><DT><DD>
|
|
|
|
<DT><B>-f</B><BR><DD>
|
|
|
|
Use the given CP/M disk <I>format</I> instead of the default format.
|
|
<BR><BR>
|
|
For Apple II CP/M 80
|
|
users the disk image formats apple-do and apple-po are available. These
|
|
are DOS3.3 order and ProDOS order disk image formats respectively, and must always be specified
|
|
using the form <b>-f apple-do</b> or <b>-f apple-po</b>.
|
|
<BR><BR>
|
|
|
|
<DT><B>-d</B><BR><DD>
|
|
Old CP/M 2.2 dir output.
|
|
<BR><BR>
|
|
|
|
<DT><B>-D</B><BR><DD>
|
|
P2DOS 2.3 ddir-like output.
|
|
<BR><BR>
|
|
|
|
<DT><B>-F</B><BR><DD>
|
|
CP/M 3.x dir output.
|
|
<BR><BR>
|
|
|
|
<DT><B>-A</B><BR><DD>
|
|
E2fs lsattr-like output.
|
|
<BR><BR>
|
|
|
|
<DT><B>-l</B><BR><DD>
|
|
Long UNIX-style directory listing including size, time stamp and user number.
|
|
<BR><BR>
|
|
|
|
<DT><B>-c</B><BR><DD>
|
|
Output the creation time, not the modification time.
|
|
<BR><BR>
|
|
|
|
<DT><B>-i</B><BR><DD>
|
|
Print index number of each file.
|
|
<BR>
|
|
</DL>
|
|
|
|
<b>Example:</b>
|
|
<BR>
|
|
<BR>
|
|
The following example shows how to list the files on an Apple II DOS 3.3
|
|
order cpm disk image using a unix-like output:
|
|
<BR>
|
|
<BR>
|
|
<b>cpmls -f apple-do -l exmplcpm.dsk</b>
|
|
<BR>
|
|
<BR>
|
|
|
|
<A NAME="lbAF"> </A>
|
|
<B>RETURN VALUE - Upon successful completion, exit code 0 is returned.</B><BR><BR>
|
|
|
|
This will likely only be of interest to programmers. In a Win32 system
|
|
the exit code can be trapped in a batch file as an "ERRORLEVEL" or as a
|
|
return value when run from another Win32 console program written in a
|
|
language like C.
|
|
<BR><BR>
|
|
|
|
<A NAME="lbAG"> </A>
|
|
<B>ERRORS - Any errors are indicated by exit code 1.</B><BR><BR>
|
|
|
|
This will likely only be of interest to programmers. In a Win32 system the
|
|
exit code can be trapped in a batch file as an "ERRORLEVEL" or as a
|
|
return value when run from another Win32 console program written in a
|
|
language like C.
|
|
<BR><BR>
|
|
|
|
<A NAME="lbAH"> </A>
|
|
<B>FILES - diskdefs - CP/M disk format definitions</B><BR><BR>
|
|
|
|
The diskdefs file is a plain ascii text file that serves as a database of
|
|
disk and disk image format definitions. It can be reviewed for available
|
|
CP/M formats and their names. For Apple II CP/M 80 users the disk
|
|
image formats apple-do and apple-po are available.
|
|
<BR><BR>
|
|
<b>The possible locations where cpmtools first looks for the diskdefs file:</b>
|
|
<BR>
|
|
<BR>
|
|
- Can vary depending on the preferences of the person who builds the
|
|
cpmtools binaries (executables) from the source code.
|
|
<BR><BR>
|
|
- The location is also installation dependent and the diskdefs file
|
|
may also have been renamed.
|
|
<BR>
|
|
<BR>
|
|
<b>If it's not found the current (work) directory is then searched for a
|
|
file called diskdefs.</b>
|
|
<BR>
|
|
<BR>
|
|
<b>On a unix-like system</b>, a <b>${prefix}/share/</b> style path
|
|
like <b>/usr/local/share/</b> is a possible place that cpmtools will first
|
|
look for diskdefs.
|
|
<BR>
|
|
<BR>
|
|
<b>In a Win32 system</b> sometimes unix-like shells like cygwin
|
|
are used to run cpmtools instead of Windows cmd. For those installations
|
|
unix-like conventions probably apply.
|
|
<br>
|
|
<br>
|
|
For cpmtools installations targetted at the average
|
|
Windows user who does not have a unix-like shell and uses the Windows cmd
|
|
prompt to run cpmtools there is no standard shared place that cpmtools will first
|
|
look for diskdefs. Pathed File names like <b>\cpm\diskdefs</b> or
|
|
even <b>c:\cpmtools\diskdefs</b> are possible.
|
|
<BR>
|
|
<BR>
|
|
|
|
<A NAME="lbAJ"> </A>
|
|
<B>AUTHORS</B>
|
|
<BR>
|
|
<BR>
|
|
This program is copyright 1997-2008 Michael Haardt <<A HREF="mailto:michael@moria.de">michael@moria.de</A>>.
|
|
The Windows port is
|
|
copyright 2000, 2001 John Elliott <<A HREF="mailto:jce@seasip.demon.co.uk">jce@seasip.demon.co.uk</A>>.
|
|
<BR><BR>
|
|
|
|
|
|
This program is free software; you can redistribute it and/or modify
|
|
it under the terms of
|
|
the <a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> as
|
|
published by the Free Software Foundation; either version 3 of the License, or (at your
|
|
option) any later version.
|
|
<BR><BR>
|
|
|
|
This program is distributed in the hope that it will be useful,
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
<a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> for more details.
|
|
<BR><BR>
|
|
|
|
You should have received a copy of the GNU General Public License along
|
|
with this program. If not, write to the Free Software Foundation, Inc.,
|
|
59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
|
|
<BR><BR>
|
|
|
|
<A NAME="lbAJ"> </A>
|
|
<B>SEE ALSO</B><BR><BR>
|
|
|
|
<I><A HREF=" ./cpmcp.htm">cpmcp</A></I>(1),
|
|
|
|
<I><A HREF=" ./cpm.htm">cpm</A></I>(5)
|
|
|
|
<BR><BR>
|
|
|
|
|
|
<HR>
|
|
|
|
<A NAME="index"> </A><B>Index</B>
|
|
<BR>
|
|
<BR>
|
|
|
|
<DL>
|
|
<DT><A HREF="#lbAA">NAME cpmls - list sorted contents of directory.</A><DD>
|
|
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DL>
|
|
<DT><A HREF="#lbAE">OPTIONS</A><DD>
|
|
<DT><A HREF="#lbAF">RETURN VALUE</A><DD>
|
|
<DT><A HREF="#lbAG">ERRORS</A><DD>
|
|
<DT><A HREF="#lbAH">FILES</A><DD>
|
|
</DL>
|
|
<DT><A HREF="#lbAI">AUTHORS</A><DD>
|
|
<DT><A HREF="#lbAJ">SEE ALSO</A><DD>
|
|
</DL>
|
|
|
|
<HR>
|
|
<b>Gradus ad Parnassum</b>
|
|
<br>
|
|
<br>
|
|
An ugly version of this document was initially created by man2html on November 14, 2008
|
|
using the cpmtools version 2.8 manual pages
|
|
then edited and reformatted by hand by <A HREF="mailto:bbuckels@mts.net">Bill Buckels</A>.
|
|
<br>
|
|
<br>
|
|
<a name="disclaimer"><b>Caveat Emptor</b></a>
|
|
<br>
|
|
<br>
|
|
The contents of this document
|
|
are either part of cpmtools or provide additional information about using cmptools.
|
|
You can redistribute it under the terms of
|
|
the <a href="http://www.gnu.org/licenses/licenses.html#GPL">GNU General Public License</a> as
|
|
published by the Free Software Foundation; either version 3 of the License, or (at your
|
|
option) any later version.
|
|
<br>
|
|
<br>
|
|
Bill Buckels has no warranty
|
|
obligations or liability resulting from this document's use in any way whatsoever. If you don't
|
|
agree then don't read it.
|
|
</FONT></BODY>
|
|
</HTML>
|
|
|