3 .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
4 .\" Generator: DocBook XSL Stylesheets v1.74.3 <http://docbook.sf.net/>
6 .\" Manual: Netatalk 2.1
7 .\" Source: Netatalk 2.1
10 .TH "UNICONV" "1" "24 Jun 2004" "Netatalk 2.1" "Netatalk 2.1"
11 .\" -----------------------------------------------------------------
12 .\" * set default formatting
13 .\" -----------------------------------------------------------------
14 .\" disable hyphenation
16 .\" disable justification (adjust text to left margin only)
18 .\" -----------------------------------------------------------------
19 .\" * MAIN CONTENT STARTS HERE *
20 .\" -----------------------------------------------------------------
22 uniconv \- convert Netatalk volume encoding
24 .HP \w'\fBuniconv\fR\fB\fR\ 'u
25 \fBuniconv\fR\fB\fR [\-ndv] \-c\ \fIcnidbackend\fR \-f\ \fIfromcode\fR \-t\ \fItocode\fR [\-m\ \fImaccode\fR] \fIvolumepath\fR
29 converts the volume encoding of
40 CNID backend used on this volume, usually cdb or dbd\&. Should match the backend selected with afpd for this volume\&. If not specified, the default CNID backend `:DEFAULT_CNID_SCHEME:\' is used
45 don\'t CAP encode leading dots (:2e), equivalent to
48 \fBAppleVolumes.default\fR(5)
53 encoding to convert from, use ASCII for CAP encoded volumes
63 Macintosh client codepage, required for CAP encoded volumes\&. Defaults to `MAC_ROMAN\'
68 `dry run\', don\'t do any real changes
73 volume encoding to convert to, e\&.g\&. UTF8
78 verbose output, use twice for maximum logging\&.
83 print version and exit
88 Setting the wrong options might render your data unusable!!! Make sure you know what you are doing\&. Always backup your data first\&.
92 recommended to do a `dry run\' first and to check the output for conversion errors\&.
97 be running while you change the volume encoding\&. Remember to change
100 \fBAppleVolumes.default\fR(5)
101 to the new codepage, before restarting afpd\&.
104 \fBMacChineseTraditional\fR,
107 \fBMacKorean\fR, uniconv cannot be used\&.
109 \fBUSE AT YOUR OWN RISK!!!\fR
110 .SH "SELECTABLE CHARSETS"
112 Netatalk provides internal support for UTF\-8 (pre\- and decomposed) and CAP\&. If you want to use other charsets, they must be provided by
116 also knows iso\-8859\&.adapted, an old style 1\&.x NLS widely used\&. This is only intended for upgrading old volumes,
118 cannot handle iso\-8859\&.adapted anymore\&.
119 .SH "CNID BACKGROUND"
121 The CNID backends maintains name to ID mappings\&. If you change a filename outside afpd(8) (shell, samba), the CNID db, i\&.e\&. the DIDNAME index, gets inconsistent\&. Netatalk tries to recover from such inconsistencies as gracefully as possible\&. The mechanisms to resolve such inconsistencies may fail sometimes, though, as this is not an easy task to accomplish\&. I\&.e\&. if several names in the path to the file or directory have changed, things may go wrong\&.
123 If you change a lot of filenames at once, chances are higher that the afpds fallback mechanisms fail, i\&.e\&. files will be assigned new IDs, even though the file hasn\'t changed\&.
125 therefore updates the CNID entry for each file/directory directly after it changes the name to avoid inconsistencies\&. The two supported backends for volumes, dbd and cdb, use the same CNID db format\&. Therefore, you
133 \fBWarning\fR: There must not be two processes opening the CNID database using different backends at once! If a volume is still opened with dbd (cnid_metad/cnid_dbd) and you start
135 with cdb, the result will be a corrupted CNID database, as the two backends use different locking schemes\&. You might run into additional problems, e\&.g\&. if dbd is compiled with transactions, cdb will not update the transaction logs\&.
137 In general, it is recommended to use the same backend for
143 convert 1\&.x CAP encoded volume to UTF\-8, clients used MacRoman codepage, cnidscheme is dbd:
149 example%\fB uniconv \-c dbd \-f ASCII \-t UTF8 \-m MAC_ROMAN /path/to/share\fR
155 convert iso8859\-1 volume to UTF\-8, cnidscheme is cdb:
161 example%\fB uniconv \-c cdb \-f ISO\-8859\-1 \-t UTF8 \-m MAC_ROMAN /path/to/share\fR
167 convert 1\&.x volume using iso8859\-1 adapted NLS to CAP encoding:
173 example%\fB uniconv \-f ISO\-8859\-ADAPTED \-t ASCII \-m MAC_ROMAN/path/to/share\fR
179 convert UTF\-8 volume to CAP, for MacCyrillic clients:
185 example%\fB uniconv \-f UTF8 \-t ASCII \-m MAC_CYRILLIC /path/to/share\fR
192 \fBAppleVolumes.default\fR(5),\fBafpd\fR(8),\fBiconv\fR(1),\fBcnid_metad\fR(8),\fBcnid_dbd\fR(8)