3 .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
4 .\" Generator: DocBook XSL Stylesheets v1.78.0 <http://docbook.sf.net/>
6 .\" Manual: @NETATALK_VERSION@
7 .\" Source: @NETATALK_VERSION@
10 .TH "AD" "1" "02 Sep 2011" "@NETATALK_VERSION@" "@NETATALK_VERSION@"
11 .\" -----------------------------------------------------------------
12 .\" * Define some portability stuff
13 .\" -----------------------------------------------------------------
14 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
15 .\" http://bugs.debian.org/507673
16 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
17 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
20 .\" -----------------------------------------------------------------
21 .\" * set default formatting
22 .\" -----------------------------------------------------------------
23 .\" disable hyphenation
25 .\" disable justification (adjust text to left margin only)
27 .\" -----------------------------------------------------------------
28 .\" * MAIN CONTENT STARTS HERE *
29 .\" -----------------------------------------------------------------
31 ad \- Netatalk compatible UNIX file utility suite\&.
34 \fBad\fR {ls\ |\ cp\ |\ mv\ |\ rm} [\&.\&.\&.]
36 \fBad\fR {\-v\ |\ \-\-version}
40 is a UNIX file utility suite with Netatalk compatibility\&. AppleDouble
43 directories and the CNID databases are updated as appropriate\&.
44 .SH "AVAILABLE COMMANDS"
45 .HP \w'\fBad\ ls\fR\ 'u
46 \fBad ls\fR [\-dRl\ [u]] {file|dir\ [\&.\&.\&.]}
48 List files and directories\&.
49 .HP \w'\fBad\ cp\fR\ 'u
50 \fBad cp\fR [\-aipvf] {src_file} {dst_file}
51 .HP \w'\fBad\ cp\ \-R\fR\ 'u
52 \fBad cp \-R\fR [\-aipvf] {src_file|src_directory\ \&.\&.\&.} {dst_directory}
54 Copy files and directories\&.
55 .HP \w'\fBad\ mv\fR\ 'u
56 \fBad mv\fR [\-finv] {src_file} {dst_file}
57 .HP \w'\fBad\ mv\fR\ 'u
58 \fBad mv\fR [\-finv] {src_file|src_directory\ \&.\&.\&.} {dst_directory}
60 Move files and directories\&.
61 .HP \w'\fBad\ rm\fR\ 'u
62 \fBad rm\fR [\-Rv] {file|directory}
63 .HP \w'\fBad\ \-v|\-\-version\fR\ 'u
64 \fBad \-v|\-\-version\fR
69 List files and directories\&. Options:
73 Directories are listed as plain files
78 list subdirectories recursively
83 Long output, list AFP info
91 \fILong output description\fR
97 <unixinfo> <FinderFlags> <AFP Attributes> <Color> <Type> <Creator> <CNID from AppleDouble> <name>
99 FinderFlags (valid for (f)iles and/or (d)irectories):
102 e = Hidden extension (f/d)
103 m = Shared (can run multiple times) (f)
104 n = No INIT resources (f)
106 c = Custom icon (f/d)
108 s = Name locked (f/d)
117 p = Needs backup (f/d)
122 Note: any letter appearing in uppercase means the flag is set but it\*(Aqs a directory for which the flag is not allowed\&.
129 Copy files and directories\&.
131 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\&.
133 Netatalk AFP volumes are detected by means of their "\&.AppleDesktop" directory which is located in their volume root\&. When a copy targeting 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\&.
139 Archive mode\&. Same as \-Rp\&.
144 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\&.)
149 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 \*(Aqy\*(Aq or \*(AqY\*(Aq, the file copy is attempted\&. (The \-i option overrides any pre\- vious \-f or \-n options\&.)
154 Do not overwrite an existing file\&. (The \-n option overrides any previous \-f or \-i options\&.)
159 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\&.
164 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\&.
169 Cause cp to be verbose, showing files as they are copied\&.
174 File system mount points are not traversed\&.
178 Move files and directories\&.
180 Move files around within an AFP volume, updating the CNID database as needed\&. If either:
190 source or destination is not an AFP volume
201 source AFP volume != destination AFP volume
204 the files are copied and removed from the source\&.
210 Do not prompt for confirmation before overwriting the destination path\&. (The \-f option overrides any previous \-i or \-n options\&.)
215 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\*(Aq or `Y\*(Aq, the move is attempted\&. (The \-i option overrides any previous \-f or \-n options\&.)
220 Do not overwrite an existing file\&. (The \-n option overrides any previous \-f or \-i options\&.)
225 Cause mv to be verbose, showing files after they are moved\&.
229 Remove files and directories\&.
231 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\&.
233 The options are as follows:
237 Attempt to remove the file hierarchy rooted in each file argument\&.
242 Be verbose when deleting files, showing them as they are removed\&.
246 Report bugs to the Netatalk\-devel list <netatalk\-devel@lists\&.sourceforge\&.net>\&.
250 \fBapple_dump\fR(1)\&.