Section: User commands (1)
Updated: June 16, 2008
Index
Return to Main Contents
Disclaimer
NAME cpmchattr - change file attributes on CP/M files.
SYNOPSIS
cpmchattr
[-f
format]
image
attrib
file-pattern
...
Note: Wildcards like *.com should be preceded with the user number
using a pattern like 0:*.com.
DESCRIPTION
Cpmchattr changes the file attributes for files on CP/M disks.
OPTIONS
-
- -f
-
Use the given CP/M disk format instead of the default format.
For Apple II CP/M 80 users the cpmchattr command may have no practical
effect. Try
cpmchmod instead for setting read only
attributes.
- attrib Set the file attributes as given.
-
FILE ATTRIBUTES - The file attribute string can contain the characters
1,2,3,4,s,a,N and M.
The meanings of these are:
- 1-4
-
The CP/M "user attributes" F1-F4. CP/M does not assign any
meaning to these attributes, though MP/M does.
- s
-
The file is a system file. This attribute can also be set by
cpmchmod(1).
- a
-
The file has been backed up.
- N
-
Reset all attributes to zero. So the string "N1r" resets all attributes and
then sets F1 and Read-Only.
- M
-
Attributes after an M are unset rather than set. The string "12M34" sets
atttributes F1 and F2, and unsets F3 and F4.
RETURN VALUE - Upon successful completion, exit code 0 is returned.
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.
ERRORS - Any errors are indicated by exit code 1.
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.
FILES - diskdefs - CP/M disk format definitions
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.
For Apple II CP/M 80 users the cpmchattr command may have no
practical effect. Try
cpmchmod instead for setting read only
attributes.
The possible locations where cpmtools first looks for the diskdefs file:
- Can vary depending on the preferences of the person who builds the
cpmtools binaries (executables) from the source code.
- The location is also installation dependent and the diskdefs file
may also have been renamed.
If it's not found the current (work) directory is then searched for a
file called diskdefs.
On a unix-like system, a ${prefix}/share/ style path
like /usr/local/share/ is a possible place that cpmtools will first
look for diskdefs.
In a Win32 system sometimes unix-like shells like cygwin
are used to run cpmtools instead of Windows cmd. For those installations
unix-like conventions probably apply.
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 \cpm\diskdefs or
even c:\cpmtools\diskdefs are possible.
AUTHORS
This program is copyright 1997-2008 Michael Haardt <michael@moria.de> and
copyright 2000, 2001 John Elliott <jce@seasip.demon.co.uk>.
This program is free software; you can redistribute it and/or modify
it under the terms of
the GNU General Public License as
published by the Free Software Foundation; either version 3 of the License, or (at your
option) any later version.
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
GNU General Public License for more details.
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.
SEE ALSO
cmpls(1),
cpmchmod(1),
cpm(5)
Index
- NAME cpmchattr - change file attributes on CP/M files.
-
- SYNOPSIS
-
- DESCRIPTION
-
- OPTIONS
-
- FILE ATTRIBUTES
-
- RETURN VALUE
-
- ERRORS
-
- FILES
-
- AUTHORS
-
- SEE ALSO
-
Gradus ad Parnassum
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 Bill Buckels.
Caveat Emptor
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 GNU General Public License as
published by the Free Software Foundation; either version 3 of the License, or (at your
option) any later version.
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.