forked from MirrorRepos/RomWBW
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.
242 lines
6.9 KiB
242 lines
6.9 KiB
<HTML><HEAD><TITLE>CPMCHMOD - change file mode on CP/M files</TITLE>
|
|
</HEAD><BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#008000" ALINK="#008000" VLINK="#008000">
|
|
<FONT FACE="Arial" SIZE=2>
|
|
<H2><A NAME="lbAA">CPMCHMOD</A></H2>
|
|
Section: User commands (1)<BR>
|
|
Updated: December 1, 2013<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 cpmchmod - change file mode on CP/M files.</B><BR><BR>
|
|
|
|
<A NAME="lbAC"> </A>
|
|
<B>SYNOPSIS</B><BR><BR>
|
|
|
|
<B>cpmchmod</B>
|
|
|
|
[<B>-f</B>
|
|
|
|
<I>format</I>]
|
|
|
|
<I>image</I>
|
|
|
|
<I>mode</I>
|
|
|
|
<I>file-pattern</I>
|
|
|
|
...
|
|
|
|
<BR><BR>
|
|
|
|
<b>Note: Wildcards like *.com should be preceded with the user number
|
|
using a pattern like 0:*.com.</b>
|
|
<br>
|
|
<br>
|
|
|
|
<A NAME="lbAD"> </A>
|
|
<B>DESCRIPTION</B><BR><BR>
|
|
|
|
<B>Cpmchmod changes the file mode for files on CP/M disks.</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>
|
|
|
|
|
|
<DT><b>mode</b> Octal file mode, as used in the <b>unix command chmod</b>.<DD>
|
|
|
|
<BR>
|
|
<b>Numeric (Octal) file mode:</b>
|
|
<br>
|
|
<br>
|
|
From one to four octal digits. Any omitted digits are assumed to be leading zeros.
|
|
<br>
|
|
<br>
|
|
<b>chmod Examples:</b>
|
|
<br>
|
|
<br>
|
|
chmod 400 file - Read by owner<br>
|
|
chmod 040 file - Read by group<br>
|
|
chmod 004 file - Read by world
|
|
<br>
|
|
<br>
|
|
chmod 200 file - Write by owner<br>
|
|
chmod 020 file - Write by group<br>
|
|
chmod 002 file - Write by world
|
|
<br>
|
|
<br>
|
|
chmod 100 file - execute by owner<br>
|
|
chmod 010 file - execute by group<br>
|
|
chmod 001 file - execute by world
|
|
<br>
|
|
<br>
|
|
To combine these, just add the numbers together:
|
|
<br>
|
|
<br>
|
|
chmod 444 file - Allow read permission to owner and group and world<br>
|
|
chmod 777 file - Allow everyone to read, write, and execute file
|
|
<br>
|
|
<BR>
|
|
</DL>
|
|
<b>cmpchmod Examples:</b>
|
|
<BR>
|
|
<BR>
|
|
The following example shows how to change a file on an Apple II DOS 3.3
|
|
order cpm disk image to read only:
|
|
<BR>
|
|
<BR>
|
|
cpmchmod -f apple-do exmplcpm.dsk 444 bhead.c
|
|
<BR>
|
|
<BR>
|
|
The following example shows how to change a file on an Apple II DOS 3.3
|
|
order cpm disk image to read/write:
|
|
<BR>
|
|
<BR>
|
|
cpmchmod -f apple-do exmplcpm.dsk 666 bhead.c
|
|
<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 (in "unix" format, not Windows format)
|
|
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>
|
|
To convert between Windows text and "unix" text, two utilities (rmcr and cr) are
|
|
included in the Windows distro of the cpmtools binaries. These are included so you
|
|
can use a Windows text editor to edit a copy of diskdefs if your Windows text editor
|
|
does not edit "unix" text.
|
|
<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>
|
|
<b>If it's not found the current (work) directory is then searched for a
|
|
file called diskdefs.</b>
|
|
<br>
|
|
<br>
|
|
The Windows distro uses <b>\cpmtools\diskdefs</b> as a default.
|
|
<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 build and run cpmtools instead of Windows cmd. For those installations
|
|
unix-like conventions may apply.
|
|
<BR>
|
|
<BR>
|
|
|
|
<A NAME="lbAI"> </A>
|
|
<B>AUTHORS</B>
|
|
<BR>
|
|
<BR>
|
|
This program is copyright 1997-2013 Michael Haardt <<A HREF="mailto:michael@moria.de">michael@moria.de</A>> and
|
|
copyright 2000, 2001, 2011 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=" ./cpmls.htm">cmpls</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 cpmchmod - change file mode on CP/M files.</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>
|
|
<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>
|
|
|
|
|