NAME

       cpmchattr - change file attributes on CP/M files

SYNOPSIS

       cpmchattr [-f format] image attrib file-pattern ...

DESCRIPTION

       Cpmchattr changes the file attributes for files on CP/M disks.

OPTIONS

       -f format
              Use the given CP/M disk format instead of the default format.

       -T libdsk-type
              libdsk  driver  type, e.g. tele for Teledisk images or raw for raw images (requires
              building cpmtools with support for libdsk).

       attrib Set the file attributes as given.

FILE ATTRIBUTES

       The file attribute string can contain the characters 1,2,3,4,r,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.

       r      The file is read-only.  This is the same  as  using  cpmchmod(1)  to  revoke  write
              permissions.

       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.

ERRORS

       Any errors are indicated by exit code 1.

ENVIRONMENT

       CPMTOOLSFMT    Default format

FILES

       /etc/cpmtools/diskdefs   CP/M disk format definitions

AUTHORS

       This  program is copyright 1997–2012 Michael Haardt <michael@moria.de> and copyright 2000,
       2001, 2011 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

       cpmls(1), cpmchmod(1), cpm(5)