← Back to branch summary

~ubuntu-branches/debian/wheezy/netatalk/wheezy

« back to all changes in this revision

Viewing changes to man/man1/ad.1

  • Committer: Bazaar Package Importer
  • Author(s): Jonas Smedegaard
  • Date: 2011-06-05 21:04:21 UTC
  • mfrom: (1.1.10 upstream)
  • Revision ID: james.westby@ubuntu.com-20110605210421-19gag2srevj0ocxh
Tags: 2.2~beta4-1
http://bugs.debian.org/606005
http://bugs.debian.org/621413
http://bugs.debian.org/628119
http://bugs.debian.org/621849
* New upstream release.
  + Fixes "Internal Error" after ad_open on sparc.
    Closes: bug#606005. Thanks to Alfredo Sola.
* Adjust references to unofficial packages in README.Debian.
* Use dversionmangle (not uversionmangle) in watch file. Fix add
  leading dash (-) to upstream version in mangling.
* Update patches:
  + Drop patches 107 and 294 (Zeroconf support): Implemented
    (differently) upstream now.
  + Drop patches 109 and 112 (avoid broken XFS linkage) obsolete.
  + Drop patch 200 (hostname resolving): adopted upstream.
  + Refresh patch 205.
* Rewrite copyright file using draft 174 of DEP-5 format.
* Build-depend on and recommend unversioned (i.e. default) BerkeleyDB
  packages.
  Closes: bug#621413. Thanks to Ondřej Surý.
  Simplify suggestions on older versioned BerkeleyDB packages.
* Stop installing some documentation dropped upstream, and let CDBS
  automagically handle some of the remains.
* Update control file:
  + Bump policy compliance to standards-version 3.9.2.
  + Shorten Vcs-* URLs.
* Add patches 115 and (for automade file) 214 to avoid installing
  unneeded /default dir.
  Closes: bug#628119. Thanks to Russell Muetzelfeldt and Luk Claes.
* Don't ship .la files. Closes: bug#621849. Thanks to Andreas Metzler
  and Luk Claes.
* Stop renaming afile and achfile, dropped upstream.
* Explicitly enable DDP (AppleTalk), now disabled by default.
* Enable Zeroconf, should be stable now.
* Simplify package relations:
  + Drop (build-)dependency fallback unneeded even for oldstable.

Show diffs side-by-side

added added

removed removed

Lines of Context:
man/man1/ad.1
2
2
.\"     Title: ad
3
3
.\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
4
4
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
5
 
.\"      Date: 01 Sep 2009
6
 
.\"    Manual: Netatalk 2.1
7
 
.\"    Source: Netatalk 2.1
 
5
.\"      Date: 30 Mar 2011
 
6
.\"    Manual: Netatalk 2.2
 
7
.\"    Source: Netatalk 2.2
8
8
.\"  Language: English
9
9
.\"
10
 
.TH "AD" "1" "01 Sep 2009" "Netatalk 2.1" "Netatalk 2.1"
 
10
.TH "AD" "1" "30 Mar 2011" "Netatalk 2.2" "Netatalk 2.2"
11
11
.\" -----------------------------------------------------------------
12
12
.\" * set default formatting
13
13
.\" -----------------------------------------------------------------
22
22
ad \- Netatalk compatible UNIX file utility suite\&.
23
23
.SH "SYNOPSIS"
24
24
.HP \w'\fBad\fR\ 'u
25
 
\fBad\fR {ls} [\&.\&.\&.]
 
25
\fBad\fR {ls\ |\ cp\ |\ mv\ |\ rm} [\&.\&.\&.]
26
26
.SH "DESCRIPTION"
27
27
.PP
28
28
\fBad\fR
31
31
\&.AppleDouble
32
32
directories and the CNID databases are updated as appropiate\&.
33
33
.SH "AVAILABLE COMMANDS"
34
 
.PP
35
 
.HP \w'\fBad\ ls\fR\ 'u \fBad ls\fR [\-dRl\ [u]] {file|dir\ [\&.\&.\&.]}
 
34
.HP \w'\fBad\ ls\fR\ 'u
 
35
\fBad ls\fR [\-dRl\ [u]] {file|dir\ [\&.\&.\&.]}
 
36
.PP
 
37
List files and directories\&.
 
38
.HP \w'\fBad\ cp\fR\ 'u
 
39
\fBad cp\fR [\-aipvf] {src_file} {dst_file}
 
40
.HP \w'\fBad\ cp\ \-R\fR\ 'u
 
41
\fBad cp \-R\fR [\-aipvf] {src_file|src_directory\ \&.\&.\&.} {dst_directory}
 
42
.PP
 
43
Copy files and directories\&.
 
44
.HP \w'\fBad\ mv\fR\ 'u
 
45
\fBad mv\fR [\-finv] {src_file} {dst_file}
 
46
.HP \w'\fBad\ mv\fR\ 'u
 
47
\fBad mv\fR [\-finv] {src_file|src_directory\ \&.\&.\&.} {dst_directory}
 
48
.PP
 
49
Move files and directories\&.
 
50
.HP \w'\fBad\ rm\fR\ 'u
 
51
\fBad rm\fR [\-Rv] {file|directory}
 
52
.PP
 
53
Remove files and directories\&.
 
54
.SH "AD LS"
 
55
.PP
 
56
List files and directories\&. Options:
 
57
.PP
 
58
\-d
 
59
.RS 4
 
60
Directories are listed as plain files
 
61
.RE
 
62
.PP
 
63
\-R
 
64
.RS 4
 
65
list subdirectories recursively
 
66
.RE
 
67
.PP
 
68
\-l
 
69
.RS 4
 
70
Long output, list AFP info
 
71
.RE
 
72
.PP
 
73
\-u
 
74
.RS 4
 
75
List UNIX info
 
76
.RE
 
77
.PP
 
78
\fILong output description\fR
36
79
.sp
37
80
.if n \{\
38
81
.RS 4
39
82
.\}
40
83
.nf
41
 
\-l Long Output [\-u: unix info]:
42
 
 
43
 
   <unixinfo \&.\&.\&.> <FinderFlags> <AFPAttributes> <Color> <Type> <Creator> <CNID from AppleDouble> <name>
44
 
 
45
 
   FinderFlags (valid for (f)ile and/or (d)irectory):
46
 
     d = On Desktop (f/d)
47
 
     e = Hidden extension (f/d)
48
 
     m = Shared (can run multiple times) (f)
49
 
     n = No INIT resources (f)
50
 
     i = Inited (f/d)
51
 
     c = Custom icon (f/d)
52
 
     t = Stationery (f)
53
 
     s = Name locked (f/d)
54
 
     b = Bundle (f/d)
55
 
     v = Invisible (f/d)
56
 
     a = Alias file (f/d)
57
 
 
58
 
   AFPAttributes:
59
 
     y = System (f/d)
60
 
     w = No write (f)
61
 
     p = Needs backup (f/d)
62
 
     r = No rename (f/d)
63
 
     l = No delete (f/d)
64
 
     o = No copy (f)
65
 
 
66
 
  Note: any letter appearing in uppercase means the flag is set but it\'s a directory for which the flag is not allowed\&.
 
84
<unixinfo> <FinderFlags> <AFP Attributes> <Color> <Type> <Creator> <CNID from AppleDouble> <name>
 
85
 
 
86
FinderFlags (valid for (f)iles and/or (d)irectories):
 
87
 
 
88
  d = On Desktop                      (f/d)
 
89
  e = Hidden extension                (f/d)
 
90
  m = Shared (can run multiple times) (f)
 
91
  n = No INIT resources               (f)
 
92
  i = Inited                          (f/d)
 
93
  c = Custom icon                     (f/d)
 
94
  t = Stationery                      (f)
 
95
  s = Name locked                     (f/d)
 
96
  b = Bundle                          (f/d)
 
97
  v = Invisible                       (f/d)
 
98
  a = Alias file                      (f/d)
 
99
 
 
100
AFP Attributes:
 
101
 
 
102
  y = System                          (f/d)
 
103
  w = No write                        (f)
 
104
  p = Needs backup                    (f/d)
 
105
  r = No rename                       (f/d)
 
106
  l = No delete                       (f/d)
 
107
  o = No copy                         (f)
 
108
 
 
109
Note: any letter appearing in uppercase means the flag is set but it\'s a directory for which the flag is not allowed\&.
67
110
.fi
68
111
.if n \{\
69
112
.RE
70
113
.\}
 
114
.SH "AD CP"
 
115
.PP
 
116
Copy files and directories\&.
 
117
.PP
 
118
In the first synopsis form, the cp utility copies the contents of the source_file to the target_file\&. In the second synopsis form, the contents of each named source_file is copied to the destination target_directory\&. The names of the files themselves are not changed\&. If cp detects an attempt to copy a file to itself, the copy will fail\&.
 
119
.PP
 
120
Netatalk AFP volumes are detected by means of their "\&.AppleDesktop" directory which is located in their volume root\&. When a copy targetting an AFP volume is detected, its CNID database daemon is connected and all copies will also go through the CNID database\&. AppleDouble files are also copied and created as needed when the target is an AFP volume\&.
 
121
.PP
 
122
Options:
 
123
.PP
 
124
\-a
 
125
.RS 4
 
126
Archive mode\&. Same as \-Rp\&.
 
127
.RE
 
128
.PP
 
129
\-f
 
130
.RS 4
 
131
For each existing destination pathname, remove it and create a new file, without prompting for confirmation regardless of its permis\- sions\&. (The \-f option overrides any previous \-i or \-n options\&.)
 
132
.RE
 
133
.PP
 
134
\-i
 
135
.RS 4
 
136
Cause cp to write a prompt to the standard error output before copying a file that would overwrite an existing file\&. If the response from the standard input begins with the character \'y\' or \'Y\', the file copy is attempted\&. (The \-i option overrides any pre\- vious \-f or \-n options\&.)
 
137
.RE
 
138
.PP
 
139
\-n
 
140
.RS 4
 
141
Do not overwrite an existing file\&. (The \-n option overrides any previous \-f or \-i options\&.)
 
142
.RE
 
143
.PP
 
144
\-p
 
145
.RS 4
 
146
Cause cp to preserve the following attributes of each source file in the copy: modification time, access time, file flags, file mode, user ID, and group ID, as allowed by permissions\&. If the user ID and group ID cannot be preserved, no error message is displayed and the exit value is not altered\&.
 
147
.RE
 
148
.PP
 
149
\-R
 
150
.RS 4
 
151
If source_file designates a directory, cp copies the directory and the entire subtree connected at that point\&.If the source_file ends in a /, the contents of the directory are copied rather than the directory itself\&.
 
152
.RE
 
153
.PP
 
154
\-v
 
155
.RS 4
 
156
Cause cp to be verbose, showing files as they are copied\&.
 
157
.RE
 
158
.PP
 
159
\-x
 
160
.RS 4
 
161
File system mount points are not traversed\&.
 
162
.RE
 
163
.SH "AD MV"
 
164
.PP
 
165
Move files and directories\&.
 
166
.PP
 
167
Move files around within an AFP volume, updating the CNID database as needed\&. If either:
 
168
.sp
 
169
.RS 4
 
170
.ie n \{\
 
171
\h'-04'\(bu\h'+03'\c
 
172
.\}
 
173
.el \{\
 
174
.sp -1
 
175
.IP \(bu 2.3
 
176
.\}
 
177
source or destination is not an AFP volume
 
178
.RE
 
179
.sp
 
180
.RS 4
 
181
.ie n \{\
 
182
\h'-04'\(bu\h'+03'\c
 
183
.\}
 
184
.el \{\
 
185
.sp -1
 
186
.IP \(bu 2.3
 
187
.\}
 
188
source AFP volume != destination AFP volume
 
189
.RE
 
190
.sp
 
191
.RE
 
192
the files are copied and removed from the source\&.
 
193
.PP
 
194
Options:
 
195
.PP
 
196
\-f
 
197
.RS 4
 
198
Do not prompt for confirmation before overwriting the destination path\&. (The \-f option overrides any previous \-i or \-n options\&.)
 
199
.RE
 
200
.PP
 
201
\-i
 
202
.RS 4
 
203
Cause mv to write a prompt to standard error before moving a file that would overwrite an existing file\&. If the response from the standard input begins with the character `y\' or `Y\', the move is attempted\&. (The \-i option overrides any previous \-f or \-n options\&.)
 
204
.RE
 
205
.PP
 
206
\-n
 
207
.RS 4
 
208
Do not overwrite an existing file\&. (The \-n option overrides any previous \-f or \-i options\&.)
 
209
.RE
 
210
.PP
 
211
\-v
 
212
.RS 4
 
213
Cause mv to be verbose, showing files after they are moved\&.
 
214
.RE
 
215
.SH "AD RM"
 
216
.PP
 
217
Remove files and directories\&.
 
218
.PP
 
219
The rm utility attempts to remove the non\-directory type files specified on the command line\&. If the files and directories reside on an AFP volume, the corresponding CNIDs are deleted from the volumes database\&.
 
220
.PP
 
221
The options are as follows:
 
222
.PP
 
223
\-R
 
224
.RS 4
 
225
Attempt to remove the file hierarchy rooted in each file argument\&.
 
226
.RE
 
227
.PP
 
228
\-v
 
229
.RS 4
 
230
Be verbose when deleting files, showing them as they are removed\&.
 
231
.RE
71
232
.SH "REPORTING BUGS"
72
233
.PP
73
234
Report bugs to the Netatalk\-devel list <netatalk\-devel@lists\&.sourceforge\&.net>\&.
74
235
.SH "SEE ALSO"
75
236
.PP
76
 
\fBdbd\fR(1)\&.
 
237
\fBdbd\fR(1),
 
238
\fBapple_dump\fR(1)\&.