git.gag.com Git - debian/cpmtools/blob - cpmchattr.1.in

   1 .TH CPMCHATTR 1 "@UPDATED@" "CP/M tools" "User commands"
   2 .SH NAME \"{{{roff}}}\"{{{
   3 cpmchattr \- change file attributes on CP/M files
   4 .\"}}}
   5 .SH SYNOPSIS \"{{{
   6 .ad l
   7 .B cpmchattr
   8 .RB [ \-f
   9 .IR format ]
  10 .I image
  11 .I attrib
  12 .I file-pattern
  13 \&...
  14 .ad b
  15 .\"}}}
  16 .SH DESCRIPTION \"{{{
  17 \fBCpmchattr\fP changes the file attributes for files on CP/M disks.
  18 .\"}}}
  19 .SH OPTIONS \"{{{
  20 .IP "\fB\-f\fP \fIformat\fP"
  21 Use the given CP/M disk \fIformat\fP instead of the default format.
  22 .IP "\fIattrib\fP"
  23 Set the file attributes as given.
  24 .\"}}}
  25 .SH "FILE ATTRIBUTES" \"{{{
  26 The file attribute string can contain the characters
  27 1,2,3,4,s,a,N and M.
  28 The meanings of these are:
  29 .TP
  30 .B 1-4
  31 The CP/M "user attributes" F1-F4.  CP/M does not assign any
  32 meaning to these attributes, though MP/M does.
  33 .TP
  34 .B s
  35 The file is a system file.  This attribute can also be set by
  36 .I cpmchmod(1).
  37 .TP
  38 .B a
  39 The file has been backed up.
  40 .TP
  41 .B N
  42 Reset all attributes to zero.  So the string "N1r" resets all attributes and
  43 then sets F1 and Read-Only.
  44 .TP
  45 .B M
  46 Attributes after an M are unset rather than set.  The string "12M34" sets
  47 atttributes F1 and F2, and unsets F3 and F4.
  48 .\"}}}
  49 .SH "RETURN VALUE" \"{{{
  50 Upon successful completion, exit code 0 is returned.
  51 .\"}}}
  52 .SH ERRORS \"{{{
  53 Any errors are indicated by exit code 1.
  54 .\"}}}
  55 .SH FILES \"{{{
  56 @DATADIR@/diskdefs      CP/M disk format definitions
  57 .\"}}}
  58 .SH AUTHORS \"{{{
  59 This program is copyright 1997\(en2007 Michael Haardt
  60 <michael@moria.de> and copyright 2000, 2001 John Elliott
  61 <jce@seasip.demon.co.uk>.
  62 .PP
  63 This program is free software; you can redistribute it and/or modify
  64 it under the terms of the GNU General Public License as published by
  65 the Free Software Foundation; either version 3 of the License, or
  66 (at your option) any later version.
  67 .PP
  68 This program is distributed in the hope that it will be useful,
  69 but WITHOUT ANY WARRANTY; without even the implied warranty of
  70 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  71 GNU General Public License for more details.
  72 .PP
  73 You should have received a copy of the GNU General Public License along
  74 with this program.  If not, write to the Free Software Foundation, Inc.,
  75 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
  76 .\"}}}
  77 .SH "SEE ALSO" \"{{{
  78 .IR cpmls (1),
  79 .IR cpmchmod (1),
  80 .IR cpm (5)
  81 .\"}}}