Initial import package mtools: Programs for accessing MS-DOS disks without mounting...
[profile/ivi/mtools.git] / mattrib.1
1 .TH mattrib 1 "03Nov09" mtools-4.0.12
2 .SH Name
3 mattrib - change MSDOS file attribute flags
4 '\" t
5 .de TQ
6 .br
7 .ns
8 .TP \\$1
9 ..
10
11 .tr \(is'
12 .tr \(if`
13 .tr \(pd"
14
15 .SH Note\ of\ warning
16 This manpage has been automatically generated from mtools's texinfo
17 documentation, and may not be entirely accurate or complete.  See the
18 end of this man page for details.
19 .PP
20 .SH Description
21 .iX "p mattrib"
22 .iX "c Changing file attributes"
23 .iX "c Hidden files"
24 .iX "c Read-only files (changing the attribute)"
25 .iX "c System files"
26 .iX "c Archive bit"
27 .PP
28 \&\fR\&\f(CWMattrib\fR is used to change MS-DOS file attribute flags. It has the
29 following syntax:
30 .PP
31 \&\fR\&\f(CWmattrib\fR [\fR\&\f(CW-a|+a\fR] [\fR\&\f(CW-h|+h\fR] [\fR\&\f(CW-r|+r\fR]
32 [\fR\&\f(CW-s|+s\fR] [\fR\&\f(CW-/\fR]  [\fR\&\f(CW-p\fR] [\fR\&\f(CW-X\fR] \fImsdosfile\fR [ \fImsdosfiles\fR \&... ]
33 .PP
34 \&\fR\&\f(CWMattrib\fR adds attribute flags to an MS-DOS file (with the
35 `\fR\&\f(CW+\fR' operator) or remove attribute flags (with the `\fR\&\f(CW-\fR'
36 operator).
37 .PP
38 \&\fR\&\f(CWMattrib\fR supports the following attribute bits:
39 .TP
40 \&\fR\&\f(CWa\fR\ 
41 Archive bit.  Used by some backup programs to indicate a new file.
42 .TP
43 \&\fR\&\f(CWr\fR\ 
44 Read-only bit.  Used to indicate a read-only file.  Files with this bit
45 set cannot be erased by \fR\&\f(CWDEL\fR nor modified.
46 .TP
47 \&\fR\&\f(CWs\fR\ 
48 System bit.  Used by MS-DOS to indicate a operating system file.
49 .TP
50 \&\fR\&\f(CWh\fR\ 
51 Hidden bit.  Used to make files hidden from \fR\&\f(CWDIR\fR.
52 .PP
53 \&\fR\&\f(CWMattrib\fR supports the following command line flags:
54 .TP
55 \&\fR\&\f(CW/\fR\ 
56 Recursive.  Recursively list the attributes of the files in the subdirectories.
57 .TP
58 \&\fR\&\f(CWX\fR\ 
59 Concise. Prints the attributes whithout any whitespace padding.  If
60 neither the "/" option is given, nor the \fImsdosfile\fR contains a
61 wildcard, and there is only one Msdos file parameter on the command
62 line, only the attribute is printed, and not the filename.  This option
63 is convenient for scripts
64 .TP
65 \&\fR\&\f(CWp\fR\ 
66 Replay mode.  Outputs a series of mformat commands that will reproduce
67 the current situation, starting from a situation as left by untarring
68 the Dos filesystem.  Commands are only output for attribute settings
69 that differ from the default (archive bit set for files, unset for
70 directories).  This option is intended to be used in addition to
71 tar. The \fR\&\f(CWreadonly\fR attribute is not taken into account, as tar can
72 set that one itself.
73 .PP
74 .SH See\ Also
75 Mtools' texinfo doc
76 .SH Viewing\ the\ texi\ doc
77 This manpage has been automatically generated from mtools's texinfo
78 documentation. However, this process is only approximative, and some
79 items, such as crossreferences, footnotes and indices are lost in this
80 translation process.  Indeed, these items have no appropriate
81 representation in the manpage format.  Moreover, not all information has
82 been translated into the manpage version.  Thus I strongly advise you to
83 use the original texinfo doc.  See the end of this manpage for
84 instructions how to view the texinfo doc.
85 .TP
86 * \ \ 
87 To generate a printable copy from the texinfo doc, run the following
88 commands:
89  
90 .nf
91 .ft 3
92 .in +0.3i
93     ./configure; make dvi; dvips mtools.dvi
94 .fi
95 .in -0.3i
96 .ft R
97 .lp
98  
99 \&\fR
100 .TP
101 * \ \ 
102 To generate a html copy,  run:
103  
104 .nf
105 .ft 3
106 .in +0.3i
107     ./configure; make html
108 .fi
109 .in -0.3i
110 .ft R
111 .lp
112  
113 \&\fRA premade html can be found at
114 \&\fR\&\f(CW\(ifhttp://www.gnu.org/software/mtools/manual/mtools.html\(is\fR
115 .TP
116 * \ \ 
117 To generate an info copy (browsable using emacs' info mode), run:
118  
119 .nf
120 .ft 3
121 .in +0.3i
122     ./configure; make info
123 .fi
124 .in -0.3i
125 .ft R
126 .lp
127  
128 \&\fR
129 .PP
130 The texinfo doc looks most pretty when printed or as html.  Indeed, in
131 the info version certain examples are difficult to read due to the
132 quoting conventions used in info.
133 .PP