]> arthur.barton.de Git - netatalk.git/blob - doc/manual/upgrade.xml
43e5e6967fcff4abcc729cf79f1cb996acf112a3
[netatalk.git] / doc / manual / upgrade.xml
1 <?xml version="1.0" encoding="UTF-8"?>
2 <chapter id="upgrade">
3   <chapterinfo>
4     <date>7.29.2013</date>
5
6     <author>
7       <firstname>Frank</firstname>
8
9       <surname>Lahm</surname>
10     </author>
11
12     <pubdate>29 Jul, 2013</pubdate>
13   </chapterinfo>
14
15   <title>Upgrading from Netatalk 2</title>
16
17   <sect1>
18     <title>Overview</title>
19
20     <para>There are two major changes in Netatalk:<orderedlist>
21         <listitem>
22           <para>New configuration file <filename><link
23           linkend="afp.conf.5">afp.conf</link></filename>, obsoleting all
24           previous configuration files</para>
25         </listitem>
26
27         <listitem>
28           <para>New AppleDouble backend "<option>appledouble = ea</option>"
29           which stores Mac metadata and resource forks in extended attributes
30           of the filesystem</para>
31         </listitem>
32       </orderedlist></para>
33
34     <sect2>
35       <title>New configuration</title>
36
37       <para><itemizedlist>
38           <listitem>
39             <para>ini style syntax (like Samba’s smb.conf)</para>
40           </listitem>
41
42           <listitem>
43             <para>one to rule them all: configure AFP settings and volumes in
44             one file</para>
45           </listitem>
46
47           <listitem>
48             <para>obsoletes <filename>afpd.conf</filename>,
49             <filename>netatalk.conf</filename>,
50             <filename>AppleVolumes.default</filename> and
51             <filename>afp_ldap.conf</filename></para>
52           </listitem>
53         </itemizedlist><warning>
54           <para>most option names have changed, read the full manpage <link
55           linkend="afp.conf.5">afp.conf</link> for details</para>
56         </warning></para>
57     </sect2>
58
59     <sect2>
60       <title>New AppleDouble backend</title>
61
62       <para>New AppleDouble backend "<option>appledouble = ea</option>" which
63       stores Mac metadata and resource forks in extended attributes of the
64       filesystem.<itemizedlist>
65           <listitem>
66             <para>default backend (!)</para>
67           </listitem>
68
69           <listitem>
70             <para>requires a filesystem with Extended Attributes, fallback is
71             "<option>appledouble = v2</option>"</para>
72           </listitem>
73
74           <listitem>
75             <para>converts filesystems from "<option>appledouble = v2</option>"
76             to "<option>appledouble = ea</option>" on the fly when accessed
77             (can be disabled)</para>
78           </listitem>
79
80           <listitem>
81             <para><command><link linkend="dbd.1">dbd</link></command> can be
82             used to do conversion in one shot</para>
83           </listitem>
84         </itemizedlist></para>
85
86       <para>Implementation details:<itemizedlist>
87           <listitem>
88             <para>stores Mac Metadata (eg FinderInfo, AFP Flags, Comment,
89             CNID) in an Extended Attributed named
90             “<filename>org.netatalk.Metadata</filename>”</para>
91           </listitem>
92
93           <listitem>
94             <para>stores Mac ResourceFork either in<itemizedlist>
95                 <listitem>
96                   <para>an Extended Attribute named
97                   “<filename>org.netatalk.ResourceFork</filename>”
98                   on Solaris w. ZFS, or in</para>
99                 </listitem>
100
101                 <listitem>
102                   <para>an extra AppleDouble file named “<filename>._file</filename>” for a file
103                   named “<filename>file</filename>”</para>
104                 </listitem>
105               </itemizedlist></para>
106           </listitem>
107
108           <listitem>
109             <para>the format of the ._ file is exactly as the Mac’s CIFS
110             client expects it when accessing the same filesystem via a CIFS
111             server (Samba), thus you can have parallel access from Macs to the
112             same dataset via AFP and CIFS without the risk of loosing data
113             (resources or metadata). Accessing the same dataset with CIFS
114             from Windows clients will still break the coupling of
115             “<filename>file</filename>” and “<filename>._file</filename>”
116             on non ZFS filesystems (see above), so for this we still
117             need an enhanced Samba VFS module (in the works).</para>
118           </listitem>
119         </itemizedlist></para>
120
121       <para>As these days the only applications making use of Resource Forks
122       are Adobe Photoshop (image preview) and Postscript Type 1 fonts, even on
123       eg Linux you’ll get rid of 99% of any extra Netatalk AppleDouble files
124       (and folders).</para>
125     </sect2>
126
127     <sect2>
128       <title>Other major changes</title>
129
130       <para><itemizedlist>
131           <listitem>
132             <para>New service controller daemon <link
133             linkend="netatalk.8">netatalk</link> which is responsible for
134             starting and restarting the AFP and CNID daemons. All bundled
135             start scripts have been updated, make sure to update yours!</para>
136           </listitem>
137
138           <listitem>
139             <para>The CNID databases are now stored under
140               <filename>/var/netatalk/CNID/</filename>
141               by default. You can use configure --localstatedir=PATH at
142               compile time to change the location.</para>
143           </listitem>
144
145           <listitem>
146             <para>Netatalk 2.x volume options “usedots” and “upriv” now
147             enabled by default</para>
148           </listitem>
149
150           <listitem>
151             <para>Removed SLP and AFP proxy support</para>
152           </listitem>
153
154           <listitem>
155             <para>Removed type/creator extension mapping
156             support</para>
157           </listitem>
158         </itemizedlist></para>
159     </sect2>
160   </sect1>
161
162   <sect1>
163     <title>Upgrading</title>
164
165     <para><orderedlist>
166         <listitem>
167           <para>Stop Netatalk 2.x</para>
168         </listitem>
169
170         <listitem>
171           <para>Install Netatalk 3</para>
172         </listitem>
173
174         <listitem>
175           <para>Manually recreate configuration in
176           <option>afp.conf</option> and <option>extmap.conf</option></para>
177         </listitem>
178
179         <listitem>
180           <para>Update your Netatalk start script (SMF, systemd, whatever...)
181           to only start <link linkend="netatalk.8">netatalk</link></para>
182         </listitem>
183
184         <listitem>
185           <para>Move <filename>afp_voluuid.conf</filename> and
186           <filename>afp_signature.conf</filename> to the localstate directory (default
187           <filename>/var/netatalk/</filename>), you can use <command>afpd -v</command>
188           in order to find the correct path</para>
189         </listitem>
190
191         <listitem>
192           <para>Start Netatalk 3</para>
193         </listitem>
194       </orderedlist></para>
195   </sect1>
196
197   <sect1>
198     <title>Table with old and new configuration file names</title>
199     <para><table frame="all">
200         <title>old and new configuration file names</title>
201         <tgroup cols="3">
202           <colspec colname="c1" colnum="1" colwidth="1.0*"/>
203           <colspec colname="c2" colnum="2" colwidth="1.0*"/>
204           <colspec colname="c3" colnum="3" colwidth="1.0*"/>
205           <thead>
206             <row>
207               <entry>Old File Name</entry>
208               <entry>New File Name</entry>
209               <entry>Description</entry>
210             </row>
211           </thead>
212           <tbody>
213             <row>
214               <entry>-</entry>
215               <entry><filename>etc/afp.conf</filename></entry>
216               <entry>new ini-style format</entry>
217             </row>
218             <row>
219               <entry>-</entry>
220               <entry><filename>etc/extmap.conf</filename></entry>
221               <entry>starting with netatalk 3.0.2</entry>
222             </row>
223             <row>
224               <entry><filename>etc/netatalk/afp_signature.conf</filename></entry>
225               <entry><filename>var/netatalk/afp_signature.conf</filename></entry>
226               <entry>moved to $localstatedir</entry>
227             </row>
228             <row>
229               <entry><filename>etc/netatalk/afp_voluuid.conf</filename></entry>
230               <entry><filename>var/netatalk/afp_voluuid.conf</filename></entry>
231               <entry>moved to $localstatedir</entry>
232             </row>
233             <row>
234               <entry><filename>etc/netatalk/netatalk.conf</filename>
235               (<filename>/etc/default/netatalk</filename>)</entry>
236               <entry>-</entry>
237               <entry>obsolete</entry>
238             </row>
239             <row>
240               <entry><filename>etc/netatalk/afpd.conf</filename></entry>
241               <entry>-</entry>
242               <entry>obsolete</entry>
243             </row>
244             <row>
245               <entry><filename>etc/netatalk/afp_ldap.conf</filename></entry>
246               <entry>-</entry>
247               <entry>obsolete</entry>
248             </row>
249             <row>
250               <entry><filename>etc/netatalk/AppleVolumes.default</filename></entry>
251               <entry>-</entry>
252               <entry>obsolete</entry>
253             </row>
254             <row>
255               <entry><filename>etc/netatalk/AppleVolumes.system</filename></entry>
256               <entry>-</entry>
257               <entry>obsolete</entry>
258             </row>
259             <row>
260               <entry><filename>~/.AppleVolumes</filename></entry>
261               <entry>-</entry>
262               <entry>obsolete</entry>
263             </row>
264           </tbody>
265         </tgroup>
266       </table></para>
267   </sect1>
268
269   <sect1>
270     <title>Table with old and new option names</title>
271     <para><table frame="all">
272         <title>from netatalk.conf (/etc/default/netatalk) to afp.conf</title>
273         <tgroup cols="6">
274           <colspec colname="c1" colnum="1" colwidth="1.0*"/>
275           <colspec colname="c2" colnum="2" colwidth="1.0*"/>
276           <colspec colname="c3" colnum="3" colwidth="1.0*"/>
277           <colspec colname="c4" colnum="4" colwidth="1.0*"/>
278           <colspec colname="c5" colnum="5" colwidth="1.0*"/>
279           <colspec colname="c6" colnum="6" colwidth="1.0*"/>
280           <thead>
281             <row>
282               <entry>Old netatalk.conf</entry>
283               <entry>New afp.conf</entry>
284               <entry>Old Default Value</entry>
285               <entry>New Default Value</entry>
286               <entry>Section</entry>
287               <entry>Description</entry>
288             </row>
289           </thead>
290           <tbody>
291             <row>
292               <entry>ATALK_NAME</entry>
293               <entry>hostname</entry>
294               <entry>-</entry>
295               <entry>-</entry>
296               <entry>(G)</entry>
297               <entry>use gethostname() by default</entry>
298             </row>
299             <row>
300               <entry>ATALK_UNIX_CHARSET</entry>
301               <entry>unix charset</entry>
302               <entry><emphasis role="bold">LOCALE</emphasis></entry>
303               <entry><emphasis role="bold">UTF8</emphasis></entry>
304               <entry>(G)</entry>
305               <entry>-</entry>
306             </row>
307             <row>
308               <entry>ATALK_MAC_CHARSET</entry>
309               <entry>mac charset</entry>
310               <entry>MAC_ROMAN</entry>
311               <entry>MAC_ROMAN</entry>
312               <entry>(G)/(V)</entry>
313               <entry>-</entry>
314             </row>
315             <row>
316               <entry>CNID_METAD_RUN</entry>
317               <entry>-</entry>
318               <entry>yes</entry>
319               <entry>-</entry>
320               <entry>-</entry>
321               <entry>controlled by netatalk(8)</entry>
322             </row>
323             <row>
324               <entry>AFPD_RUN</entry>
325               <entry>-</entry>
326               <entry>yes</entry>
327               <entry>-</entry>
328               <entry>-</entry>
329               <entry>controlled by netatalk(8)</entry>
330             </row>
331             <row>
332               <entry>AFPD_MAX_CLIENTS</entry>
333               <entry>max connections</entry>
334               <entry><emphasis role="bold">20</emphasis></entry>
335               <entry><emphasis role="bold">200</emphasis></entry>
336               <entry>(G)</entry>
337               <entry>-</entry>
338             </row>
339             <row>
340               <entry>AFPD_UAMLIST</entry>
341               <entry>uam list</entry>
342               <entry>-U uams_dhx.so,uams_dhx2.so</entry>
343               <entry>uams_dhx.so uams_dhx2.so</entry>
344               <entry>(G)</entry>
345               <entry>-</entry>
346             </row>
347             <row>
348               <entry>AFPD_GUEST</entry>
349               <entry>guest account</entry>
350               <entry>nobody</entry>
351               <entry>nobody</entry>
352               <entry>(G)</entry>
353               <entry>-</entry>
354             </row>
355             <row>
356               <entry>CNID_CONFIG</entry>
357               <entry>log level</entry>
358               <entry>-l log_note</entry>
359               <entry>cnid:note</entry>
360               <entry>(G)</entry>
361               <entry>-</entry>
362             </row>
363             <row>
364               <entry>CNID_CONFIG</entry>
365               <entry>log file</entry>
366               <entry>-</entry>
367               <entry>-</entry>
368               <entry>(G)</entry>
369               <entry>-</entry>
370             </row>
371             <row>
372               <entry>ATALKD_RUN</entry>
373               <entry>-</entry>
374               <entry>no</entry>
375               <entry>-</entry>
376               <entry>-</entry>
377               <entry>AppleTalk is obsoleted</entry>
378             </row>
379             <row>
380               <entry>PAPD_RUN</entry>
381               <entry>-</entry>
382               <entry>no</entry>
383               <entry>-</entry>
384               <entry>-</entry>
385               <entry>AppleTalk is obsoleted</entry>
386             </row>
387             <row>
388               <entry>TIMELORD_RUN</entry>
389               <entry>-</entry>
390               <entry>no</entry>
391               <entry>-</entry>
392               <entry>-</entry>
393               <entry>AppleTalk is obsoleted</entry>
394             </row>
395             <row>
396               <entry>A2BOOT_RUN</entry>
397               <entry>-</entry>
398               <entry>no</entry>
399               <entry>-</entry>
400               <entry>-</entry>
401               <entry>AppleTalk is obsoleted</entry>
402             </row>
403             <row>
404               <entry>ATALK_BGROUND</entry>
405               <entry>-</entry>
406               <entry>no</entry>
407               <entry>-</entry>
408               <entry>-</entry>
409               <entry>AppleTalk is obsoleted</entry>
410             </row>
411             <row>
412               <entry>ATALK_ZONE</entry>
413               <entry>-</entry>
414               <entry>no</entry>
415               <entry>-</entry>
416               <entry>-</entry>
417               <entry>AppleTalk is obsoleted</entry>
418             </row>
419           </tbody>
420         </tgroup>
421       </table><table frame="all">
422         <title>from afpd.conf to afp.conf</title>
423         <tgroup cols="6">
424           <colspec colname="c1" colnum="1" colwidth="1.0*"/>
425           <colspec colname="c2" colnum="2" colwidth="1.0*"/>
426           <colspec colname="c3" colnum="3" colwidth="1.0*"/>
427           <colspec colname="c4" colnum="4" colwidth="1.0*"/>
428           <colspec colname="c5" colnum="5" colwidth="1.0*"/>
429           <colspec colname="c6" colnum="6" colwidth="1.0*"/>
430           <thead>
431             <row>
432               <entry>Old afpd.conf</entry>
433               <entry>New afp.conf</entry>
434               <entry>Old Default Value</entry>
435               <entry>New Default Value</entry>
436               <entry>Section</entry>
437               <entry>Description</entry>
438             </row>
439           </thead>
440           <tbody>
441             <row>
442               <entry>1st field ("-" or "server name")</entry>
443               <entry>hostname</entry>
444               <entry>-</entry>
445               <entry>-</entry>
446               <entry>(G)</entry>
447               <entry>use gethostname() by default</entry>
448             </row>
449             <row>
450               <entry>-uamlist</entry>
451               <entry>uam list</entry>
452               <entry>-U uams_dhx.so,uams_dhx2.so</entry>
453               <entry>uams_dhx.so uams_dhx2.so</entry>
454               <entry>(G)</entry>
455               <entry>-</entry>
456             </row>
457             <row>
458               <entry>-nozeroconf</entry>
459               <entry>zeroconf</entry>
460               <entry>-</entry>
461               <entry>yes (if supported)</entry>
462               <entry>(G)</entry>
463               <entry>-</entry>
464             </row>
465             <row>
466               <entry>-advertise_ssh</entry>
467               <entry>advertise ssh</entry>
468               <entry>-</entry>
469               <entry>no</entry>
470               <entry>(G)</entry>
471               <entry>-</entry>
472             </row>
473             <row>
474               <entry>-[no]savepassword</entry>
475               <entry>save password</entry>
476               <entry>-savepassword</entry>
477               <entry>yes</entry>
478               <entry>(G)</entry>
479               <entry>-</entry>
480             </row>
481             <row>
482               <entry>-[no]setpassword</entry>
483               <entry>set password</entry>
484               <entry>-nosetpassword</entry>
485               <entry>no</entry>
486               <entry>(G)</entry>
487               <entry>-</entry>
488             </row>
489             <row>
490               <entry>-client_polling</entry>
491               <entry>client polling</entry>
492               <entry>-</entry>
493               <entry>no</entry>
494               <entry>(G)</entry>
495               <entry>-</entry>
496             </row>
497             <row>
498               <entry>-hostname</entry>
499               <entry>hostname</entry>
500               <entry>-</entry>
501               <entry>-</entry>
502               <entry>(G)</entry>
503               <entry>use gethostname() by default</entry>
504             </row>
505             <row>
506               <entry>-loginmesg</entry>
507               <entry>login message</entry>
508               <entry>-</entry>
509               <entry>-</entry>
510               <entry>(G)/(V)</entry>
511               <entry>-</entry>
512             </row>
513             <row>
514               <entry>-guestname</entry>
515               <entry>guest account</entry>
516               <entry>nobody</entry>
517               <entry>nobody</entry>
518               <entry>(G)</entry>
519               <entry>-</entry>
520             </row>
521             <row>
522               <entry>-passwdfile</entry>
523               <entry>passwd file</entry>
524               <entry>afppasswd</entry>
525               <entry>afppasswd</entry>
526               <entry>(G)</entry>
527               <entry>-</entry>
528             </row>
529             <row>
530               <entry>-passwdminlen</entry>
531               <entry>passwd minlen</entry>
532               <entry>-</entry>
533               <entry>-</entry>
534               <entry>(G)</entry>
535               <entry>-</entry>
536             </row>
537             <row>
538               <entry>-tickleval</entry>
539               <entry>tickleval</entry>
540               <entry>30</entry>
541               <entry>30</entry>
542               <entry>(G)</entry>
543               <entry>-</entry>
544             </row>
545             <row>
546               <entry>-timeout</entry>
547               <entry>timeout</entry>
548               <entry>4</entry>
549               <entry>4</entry>
550               <entry>(G)</entry>
551               <entry>-</entry>
552             </row>
553             <row>
554               <entry>-sleep</entry>
555               <entry>sleep time</entry>
556               <entry>10</entry>
557               <entry>10</entry>
558               <entry>(G)</entry>
559               <entry>-</entry>
560             </row>
561             <row>
562               <entry>-dsireadbuf</entry>
563               <entry>dsireadbuf</entry>
564               <entry>12</entry>
565               <entry>12</entry>
566               <entry>(G)</entry>
567               <entry>-</entry>
568             </row>
569             <row>
570               <entry>-server_quantum</entry>
571               <entry>server quantum</entry>
572               <entry>303840</entry>
573               <entry>303840</entry>
574               <entry>(G)</entry>
575               <entry>-</entry>
576             </row>
577             <row>
578               <entry>-volnamelen</entry>
579               <entry>volnamelen</entry>
580               <entry>80</entry>
581               <entry>80</entry>
582               <entry>(G)</entry>
583               <entry>-</entry>
584             </row>
585             <row>
586               <entry>-setuplog</entry>
587               <entry>log level</entry>
588               <entry>default log_note</entry>
589               <entry>default:note</entry>
590               <entry>(G)</entry>
591               <entry>-</entry>
592             </row>
593             <row>
594               <entry>-setuplog</entry>
595               <entry>log file</entry>
596               <entry>-</entry>
597               <entry>-</entry>
598               <entry>(G)</entry>
599               <entry>-</entry>
600             </row>
601             <row>
602               <entry>-admingroup</entry>
603               <entry>admingroup</entry>
604               <entry>-</entry>
605               <entry>-</entry>
606               <entry>(G)</entry>
607               <entry>-</entry>
608             </row>
609             <row>
610               <entry>-k5service</entry>
611               <entry>k5 service</entry>
612               <entry>-</entry>
613               <entry>-</entry>
614               <entry>(G)</entry>
615               <entry>-</entry>
616             </row>
617             <row>
618               <entry>-k5realm</entry>
619               <entry>k5 realm</entry>
620               <entry>-</entry>
621               <entry>-</entry>
622               <entry>(G)</entry>
623               <entry>-</entry>
624             </row>
625             <row>
626               <entry>-k5keytab</entry>
627               <entry>k5 keytab</entry>
628               <entry>-</entry>
629               <entry>-</entry>
630               <entry>(G)</entry>
631               <entry>-</entry>
632             </row>
633             <row>
634               <entry>-uampath</entry>
635               <entry>uam path</entry>
636               <entry><emphasis role="bold">etc/netatalk/uams/</emphasis></entry>
637               <entry><emphasis role="bold">lib/netatalk/</emphasis></entry>
638               <entry>(G)</entry>
639               <entry>moved to $libdir</entry>
640             </row>
641             <row>
642               <entry>-ipaddr</entry>
643               <entry>afp listen</entry>
644               <entry>-</entry>
645               <entry>-</entry>
646               <entry>(G)</entry>
647               <entry>-</entry>
648             </row>
649             <row>
650               <entry>-cnidserver</entry>
651               <entry>cnid server</entry>
652               <entry>localhost:4700</entry>
653               <entry>localhost:4700</entry>
654               <entry>(G)/(V)</entry>
655               <entry>-</entry>
656             </row>
657             <row>
658               <entry>-port</entry>
659               <entry>port</entry>
660               <entry>548</entry>
661               <entry>548</entry>
662               <entry>(G)</entry>
663               <entry>-</entry>
664             </row>
665             <row>
666               <entry>-signature</entry>
667               <entry>signature</entry>
668               <entry>auto</entry>
669               <entry>-</entry>
670               <entry>(G)</entry>
671               <entry>-</entry>
672             </row>
673             <row>
674               <entry>-fqdn</entry>
675               <entry>fqdn</entry>
676               <entry>-</entry>
677               <entry>-</entry>
678               <entry>(G)</entry>
679               <entry>-</entry>
680             </row>
681             <row>
682               <entry>-unixcodepage</entry>
683               <entry>unix charset</entry>
684               <entry><emphasis role="bold">LOCALE</emphasis></entry>
685               <entry><emphasis role="bold">UTF8</emphasis></entry>
686               <entry>(G)</entry>
687               <entry>-</entry>
688             </row>
689             <row>
690               <entry>-maccodepage</entry>
691               <entry>mac charset</entry>
692               <entry>MAC_ROMAN</entry>
693               <entry>MAC_ROMAN</entry>
694               <entry>(G)/(V)</entry>
695               <entry>-</entry>
696             </row>
697             <row>
698               <entry>-closevol</entry>
699               <entry>close vol</entry>
700               <entry>-</entry>
701               <entry>no</entry>
702               <entry>(G)</entry>
703               <entry>-</entry>
704             </row>
705             <row>
706               <entry>-ntdomain</entry>
707               <entry>nt domain</entry>
708               <entry>-</entry>
709               <entry>-</entry>
710               <entry>(G)</entry>
711               <entry>-</entry>
712             </row>
713             <row>
714               <entry>-ntseparator</entry>
715               <entry>nt separator</entry>
716               <entry>-</entry>
717               <entry>-</entry>
718               <entry>(G)</entry>
719               <entry>-</entry>
720             </row>
721             <row>
722               <entry>-dircachesize</entry>
723               <entry>dircachesize</entry>
724               <entry>8192</entry>
725               <entry>8192</entry>
726               <entry>(G)</entry>
727               <entry>-</entry>
728             </row>
729             <row>
730               <entry>-tcpsndbuf</entry>
731               <entry>tcpsndbuf</entry>
732               <entry>-</entry>
733               <entry>-</entry>
734               <entry>(G)</entry>
735               <entry>OS default</entry>
736             </row>
737             <row>
738               <entry>-tcprcvbuf</entry>
739               <entry>tcprcvbuf</entry>
740               <entry>-</entry>
741               <entry>-</entry>
742               <entry>(G)</entry>
743               <entry>OS default</entry>
744             </row>
745             <row>
746               <entry>-fcelistener</entry>
747               <entry>fce listener</entry>
748               <entry>-</entry>
749               <entry>-</entry>
750               <entry>(G)</entry>
751               <entry>-</entry>
752             </row>
753             <row>
754               <entry>-fcecoalesce</entry>
755               <entry>fce coalesce</entry>
756               <entry>-</entry>
757               <entry>-</entry>
758               <entry>(G)</entry>
759               <entry>-</entry>
760             </row>
761             <row>
762               <entry>-fceevents</entry>
763               <entry>fce events</entry>
764               <entry>-</entry>
765               <entry>-</entry>
766               <entry>(G)</entry>
767               <entry>-</entry>
768             </row>
769             <row>
770               <entry>-fceholdfmod</entry>
771               <entry>fce holdfmod</entry>
772               <entry>60</entry>
773               <entry>60</entry>
774               <entry>(G)</entry>
775               <entry>-</entry>
776             </row>
777             <row>
778               <entry>-mimicmodel</entry>
779               <entry>mimic model</entry>
780               <entry>-</entry>
781               <entry>-</entry>
782               <entry>(G)</entry>
783               <entry>-</entry>
784             </row>
785             <row>
786               <entry>-adminauthuser</entry>
787               <entry>admin auth user</entry>
788               <entry>-</entry>
789               <entry>-</entry>
790               <entry>(G)</entry>
791               <entry>-</entry>
792             </row>
793             <row>
794               <entry>-noacl2maccess</entry>
795               <entry>map acls</entry>
796               <entry>-</entry>
797               <entry>rights</entry>
798               <entry>(G)</entry>
799               <entry>-</entry>
800             </row>
801             <row>
802               <entry>-[no]tcp</entry>
803               <entry>-</entry>
804               <entry>-tcp</entry>
805               <entry>-</entry>
806               <entry>-</entry>
807               <entry>always TCP only</entry>
808             </row>
809             <row>
810               <entry>-[no]ddp</entry>
811               <entry>-</entry>
812               <entry>-noddp</entry>
813               <entry>-</entry>
814               <entry>-</entry>
815               <entry>AppleTalk is obsoleted</entry>
816             </row>
817             <row>
818               <entry>-[no]transall</entry>
819               <entry>-</entry>
820               <entry>-tcp -noddp</entry>
821               <entry>-</entry>
822               <entry>-</entry>
823               <entry>always TCP only</entry>
824             </row>
825             <row>
826               <entry>-nodebug</entry>
827               <entry>-</entry>
828               <entry>-</entry>
829               <entry>-</entry>
830               <entry>-</entry>
831               <entry>obsolete</entry>
832             </row>
833             <row>
834               <entry>-[no]slp</entry>
835               <entry>-</entry>
836               <entry>-noslp</entry>
837               <entry>-</entry>
838               <entry>-</entry>
839               <entry>SLP support is obsoleted</entry>
840             </row>
841             <row>
842               <entry>-[no]uservolfirst</entry>
843               <entry>-</entry>
844               <entry>-nouservolfirst</entry>
845               <entry>-</entry>
846               <entry>-</entry>
847               <entry>uservol is obsoleted</entry>
848             </row>
849             <row>
850               <entry>-[no]uservol</entry>
851               <entry>-</entry>
852               <entry>-uservol</entry>
853               <entry>-</entry>
854               <entry>-</entry>
855               <entry>uservol is obsoleted</entry>
856             </row>
857             <row>
858               <entry>-proxy</entry>
859               <entry>-</entry>
860               <entry>-</entry>
861               <entry>-</entry>
862               <entry>-</entry>
863               <entry>AppleTalk is obsoleted</entry>
864             </row>
865             <row>
866               <entry>-defaultvol</entry>
867               <entry>-</entry>
868               <entry>AppleVolumes.default</entry>
869               <entry>-</entry>
870               <entry>-</entry>
871               <entry>afp.conf only</entry>
872             </row>
873             <row>
874               <entry>-systemvol</entry>
875               <entry>-</entry>
876               <entry>AppleVolumes.system</entry>
877               <entry>-</entry>
878               <entry>-</entry>
879               <entry>afp.conf only</entry>
880             </row>
881             <row>
882               <entry>-loginmaxfail</entry>
883               <entry>-</entry>
884               <entry>-</entry>
885               <entry>-</entry>
886               <entry>-</entry>
887               <entry>not supported from the biginning</entry>
888             </row>
889             <row>
890               <entry>-unsetuplog</entry>
891               <entry>-</entry>
892               <entry>-</entry>
893               <entry>-</entry>
894               <entry>-</entry>
895               <entry>obsolete</entry>
896             </row>
897             <row>
898               <entry>-authprintdir</entry>
899               <entry>-</entry>
900               <entry>-</entry>
901               <entry>-</entry>
902               <entry>-</entry>
903               <entry>AppleTalk is obsoleted</entry>
904             </row>
905             <row>
906               <entry>-ddpaddr</entry>
907               <entry>-</entry>
908               <entry>-</entry>
909               <entry>-</entry>
910               <entry>-</entry>
911               <entry>AppleTalk is obsoleted</entry>
912             </row>
913             <row>
914               <entry>-[no]icon</entry>
915               <entry>-</entry>
916               <entry>-noicon</entry>
917               <entry></entry>
918               <entry>-</entry>
919               <entry>obsolete</entry>
920             </row>
921             <row>
922               <entry>-keepsessions</entry>
923               <entry>-</entry>
924               <entry>-</entry>
925               <entry>-</entry>
926               <entry>-</entry>
927               <entry>obsolete. Use kill -HUP.</entry>
928             </row>
929           </tbody>
930         </tgroup>
931       </table><table frame="all">
932         <title>from afp_ldap.conf to afp.conf</title>
933         <tgroup cols="6">
934           <colspec colname="c1" colnum="1" colwidth="1.0*"/>
935           <colspec colname="c2" colnum="2" colwidth="1.0*"/>
936           <colspec colname="c3" colnum="3" colwidth="1.0*"/>
937           <colspec colname="c4" colnum="4" colwidth="1.0*"/>
938           <colspec colname="c5" colnum="5" colwidth="1.0*"/>
939           <colspec colname="c6" colnum="6" colwidth="1.0*"/>
940           <thead>
941             <row>
942               <entry>Old afp_ldap.conf</entry>
943               <entry>New afp.conf</entry>
944               <entry>Old Default Value</entry>
945               <entry>New Defalut Value</entry>
946               <entry>Section</entry>
947               <entry>Description</entry>
948             </row>
949           </thead>
950           <tbody>
951             <row>
952               <entry>ldap_server</entry>
953               <entry>ldap server</entry>
954               <entry>-</entry>
955               <entry>-</entry>
956               <entry>(G)</entry>
957               <entry>-</entry>
958             </row>
959             <row>
960               <entry>ldap_auth_method</entry>
961               <entry>ldap auth method</entry>
962               <entry>-</entry>
963               <entry>-</entry>
964               <entry>(G)</entry>
965               <entry>-</entry>
966             </row>
967             <row>
968               <entry>ldap_auth_dn</entry>
969               <entry>ldap auth dn</entry>
970               <entry>-</entry>
971               <entry>-</entry>
972               <entry>(G)</entry>
973               <entry>-</entry>
974             </row>
975             <row>
976               <entry>ldap_auth_pw</entry>
977               <entry>ldap auth pw</entry>
978               <entry>-</entry>
979               <entry>-</entry>
980               <entry>(G)</entry>
981               <entry>-</entry>
982             </row>
983             <row>
984               <entry>ldap_userbase</entry>
985               <entry>ldap userbase</entry>
986               <entry>-</entry>
987               <entry>-</entry>
988               <entry>(G)</entry>
989               <entry>-</entry>
990             </row>
991             <row>
992               <entry>ldap_userscope</entry>
993               <entry>ldap userscope</entry>
994               <entry>-</entry>
995               <entry>-</entry>
996               <entry>(G)</entry>
997               <entry>-</entry>
998             </row>
999             <row>
1000               <entry>ldap_groupbase</entry>
1001               <entry>ldap groupbase</entry>
1002               <entry>-</entry>
1003               <entry>-</entry>
1004               <entry>(G)</entry>
1005               <entry>-</entry>
1006             </row>
1007             <row>
1008               <entry>ldap_groupscope</entry>
1009               <entry>ldap groupscope</entry>
1010               <entry>-</entry>
1011               <entry>-</entry>
1012               <entry>(G)</entry>
1013               <entry>-</entry>
1014             </row>
1015             <row>
1016               <entry>ldap_uuid_attr</entry>
1017               <entry>ldap uuid attr</entry>
1018               <entry>-</entry>
1019               <entry>-</entry>
1020               <entry>(G)</entry>
1021               <entry>-</entry>
1022             </row>
1023             <row>
1024               <entry>ldap_uuid_string</entry>
1025               <entry>ldap uuid string</entry>
1026               <entry>-</entry>
1027               <entry>-</entry>
1028               <entry>(G)</entry>
1029               <entry>-</entry>
1030             </row>
1031             <row>
1032               <entry>ldap_name_attr</entry>
1033               <entry>ldap name attr</entry>
1034               <entry>-</entry>
1035               <entry>-</entry>
1036               <entry>(G)</entry>
1037               <entry>-</entry>
1038             </row>
1039             <row>
1040               <entry> ldap_group_attr</entry>
1041               <entry>ldap group attr</entry>
1042               <entry>-</entry>
1043               <entry>-</entry>
1044               <entry>(G)</entry>
1045               <entry>-</entry>
1046             </row>
1047           </tbody>
1048         </tgroup>
1049       </table><table frame="all">
1050         <title>from AppleVolumes.* to afp.conf</title>
1051         <tgroup cols="6">
1052           <colspec colname="c1" colnum="1" colwidth="1.0*"/>
1053           <colspec colname="c2" colnum="2" colwidth="1.0*"/>
1054           <colspec colname="c3" colnum="3" colwidth="1.0*"/>
1055           <colspec colname="c4" colnum="4" colwidth="1.0*"/>
1056           <colspec colname="c5" colnum="5" colwidth="1.0*"/>
1057           <colspec colname="c6" colnum="6" colwidth="1.0*"/>
1058           <thead>
1059             <row>
1060               <entry>Old AppleVolumes.*</entry>
1061               <entry>New afp.conf</entry>
1062               <entry>Old Default Value</entry>
1063               <entry>New Defalut Value</entry>
1064               <entry>Section</entry>
1065               <entry>Description</entry>
1066             </row>
1067           </thead>
1068           <tbody>
1069             <row>
1070               <entry>(leading-dot lines)</entry>
1071               <entry>-</entry>
1072               <entry>-</entry>
1073               <entry>-</entry>
1074               <entry>-</entry>
1075               <entry>move to extmap.conf</entry>
1076             </row>
1077             <row>
1078               <entry>:DEFAULT:</entry>
1079               <entry>-</entry>
1080               <entry>options:upriv,usedots</entry>
1081               <entry>-</entry>
1082               <entry>-</entry>
1083               <entry>use "vol preset ="</entry>
1084             </row>
1085             <row>
1086               <entry>1st field ("~")</entry>
1087               <entry>-</entry>
1088               <entry>-</entry>
1089               <entry>-</entry>
1090               <entry>-</entry>
1091               <entry>use [Homes] section</entry>
1092             </row>
1093             <row>
1094               <entry>1st field ("/path")</entry>
1095               <entry>path</entry>
1096               <entry>-</entry>
1097               <entry>-</entry>
1098               <entry>(V)</entry>
1099               <entry>-</entry>
1100             </row>
1101             <row>
1102               <entry>2nd field</entry>
1103               <entry>-</entry>
1104               <entry>-</entry>
1105               <entry>-</entry>
1106               <entry>-</entry>
1107               <entry>use section name</entry>
1108             </row>
1109             <row>
1110               <entry>allow:</entry>
1111               <entry>valid users</entry>
1112               <entry>-</entry>
1113               <entry>-</entry>
1114               <entry>(V)</entry>
1115               <entry>-</entry>
1116             </row>
1117             <row>
1118               <entry>deny:</entry>
1119               <entry>invalid users</entry>
1120               <entry>-</entry>
1121               <entry>-</entry>
1122               <entry>(V)</entry>
1123               <entry>-</entry>
1124             </row>
1125             <row>
1126               <entry>rwlist:</entry>
1127               <entry>rwlist</entry>
1128               <entry>-</entry>
1129               <entry>-</entry>
1130               <entry>(V)</entry>
1131               <entry>-</entry>
1132             </row>
1133             <row>
1134               <entry>rolist:</entry>
1135               <entry>rolist</entry>
1136               <entry>-</entry>
1137               <entry>-</entry>
1138               <entry>(V)</entry>
1139               <entry>-</entry>
1140             </row>
1141             <row>
1142               <entry>volcharset:</entry>
1143               <entry>vol charset</entry>
1144               <entry><emphasis role="bold">UTF8</emphasis></entry>
1145               <entry><emphasis role="bold">(same as unix charset)</emphasis></entry>
1146               <entry>(G)/(V)</entry>
1147               <entry>-</entry>
1148             </row>
1149             <row>
1150               <entry>maccharset:</entry>
1151               <entry>mac charset</entry>
1152               <entry>MAC_ROMAN</entry>
1153               <entry>MAC_ROMAN</entry>
1154               <entry>(G)/(V)</entry>
1155               <entry>-</entry>
1156             </row>
1157             <row>
1158               <entry>veto:</entry>
1159               <entry>veto files</entry>
1160               <entry>-</entry>
1161               <entry>-</entry>
1162               <entry>(V)</entry>
1163               <entry>-</entry>
1164             </row>
1165             <row>
1166               <entry>cnidscheme:</entry>
1167               <entry>cnid scheme</entry>
1168               <entry>dbd</entry>
1169               <entry>dbd</entry>
1170               <entry>(V)</entry>
1171               <entry>-</entry>
1172             </row>
1173             <row>
1174               <entry>casefold:</entry>
1175               <entry>casefold</entry>
1176               <entry>-</entry>
1177               <entry>-</entry>
1178               <entry>(V)</entry>
1179               <entry>-</entry>
1180             </row>
1181             <row>
1182               <entry>adouble:</entry>
1183               <entry>appledouble</entry>
1184               <entry><emphasis role="bold">v2</emphasis></entry>
1185               <entry><emphasis role="bold">ea</emphasis></entry>
1186               <entry>(V)</entry>
1187               <entry>v1, osx and sfm are obsoleted</entry>
1188             </row>
1189             <row>
1190               <entry>cnidserver:</entry>
1191               <entry>cnid server</entry>
1192               <entry>localhost:4700</entry>
1193               <entry>localhost:4700</entry>
1194               <entry>(G)/(V)</entry>
1195               <entry>-</entry>
1196             </row>
1197             <row>
1198               <entry>dbpath:</entry>
1199               <entry>vol dbpath</entry>
1200               <entry><emphasis role="bold">(volume directory)</emphasis></entry>
1201               <entry><emphasis role="bold">var/netatalk/CNID/</emphasis></entry>
1202               <entry>(G)</entry>
1203               <entry>moved to $localstatedir</entry>
1204             </row>
1205             <row>
1206               <entry>umask:</entry>
1207               <entry>umask</entry>
1208               <entry>0000</entry>
1209               <entry>0000</entry>
1210               <entry>(V)</entry>
1211               <entry>-</entry>
1212             </row>
1213             <row>
1214               <entry>dperm:</entry>
1215               <entry>directory perm</entry>
1216               <entry>0000</entry>
1217               <entry>0000</entry>
1218               <entry>(V)</entry>
1219               <entry>-</entry>
1220             </row>
1221             <row>
1222               <entry>fperm:</entry>
1223               <entry>file perm</entry>
1224               <entry>0000</entry>
1225               <entry>0000</entry>
1226               <entry>(V)</entry>
1227               <entry>-</entry>
1228             </row>
1229             <row>
1230               <entry>password:</entry>
1231               <entry>password</entry>
1232               <entry>-</entry>
1233               <entry>-</entry>
1234               <entry>(V)</entry>
1235               <entry>-</entry>
1236             </row>
1237             <row>
1238               <entry>root_preexec:</entry>
1239               <entry>root preexec</entry>
1240               <entry>-</entry>
1241               <entry>-</entry>
1242               <entry>(V)</entry>
1243               <entry>-</entry>
1244             </row>
1245             <row>
1246               <entry>preexec:</entry>
1247               <entry>preexec</entry>
1248               <entry>-</entry>
1249               <entry>-</entry>
1250               <entry>(V)</entry>
1251               <entry>-</entry>
1252             </row>
1253             <row>
1254               <entry>root_postexec:</entry>
1255               <entry>root postexec</entry>
1256               <entry>-</entry>
1257               <entry>-</entry>
1258               <entry>(V)</entry>
1259               <entry>-</entry>
1260             </row>
1261             <row>
1262               <entry>postexec:</entry>
1263               <entry>postexec</entry>
1264               <entry>-</entry>
1265               <entry>-</entry>
1266               <entry>(V)</entry>
1267               <entry>-</entry>
1268             </row>
1269             <row>
1270               <entry>allowed_hosts:</entry>
1271               <entry>hosts allow</entry>
1272               <entry>-</entry>
1273               <entry>-</entry>
1274               <entry>(V)</entry>
1275               <entry>-</entry>
1276             </row>
1277             <row>
1278               <entry>denied_hosts:</entry>
1279               <entry>hosts deny</entry>
1280               <entry>-</entry>
1281               <entry>-</entry>
1282               <entry>(V)</entry>
1283               <entry>-</entry>
1284             </row>
1285             <row>
1286               <entry>ea:</entry>
1287               <entry>ea</entry>
1288               <entry>auto</entry>
1289               <entry>auto</entry>
1290               <entry>(V)</entry>
1291               <entry>-</entry>
1292             </row>
1293             <row>
1294               <entry>volsizelimit:</entry>
1295               <entry>vol size limit</entry>
1296               <entry>-</entry>
1297               <entry>-</entry>
1298               <entry>(V)</entry>
1299               <entry>-</entry>
1300             </row>
1301             <row>
1302               <entry>perm:</entry>
1303               <entry>-</entry>
1304               <entry>-</entry>
1305               <entry>-</entry>
1306               <entry>-</entry>
1307               <entry>Use "directory perm" and "file perm"</entry>
1308             </row>
1309             <row>
1310               <entry>forceuid:</entry>
1311               <entry>-</entry>
1312               <entry>-</entry>
1313               <entry>-</entry>
1314               <entry>-</entry>
1315               <entry>obsolete</entry>
1316             </row>
1317             <row>
1318               <entry>forcegid:</entry>
1319               <entry>-</entry>
1320               <entry>-</entry>
1321               <entry>-</entry>
1322               <entry>-</entry>
1323               <entry>obsolete</entry>
1324             </row>
1325             <row>
1326               <entry>options:ro</entry>
1327               <entry>read only</entry>
1328               <entry>-</entry>
1329               <entry>no</entry>
1330               <entry>(V)</entry>
1331               <entry>-</entry>
1332             </row>
1333             <row>
1334               <entry>options:invisibledots</entry>
1335               <entry>invisible dots</entry>
1336               <entry>-</entry>
1337               <entry>no</entry>
1338               <entry>(V)</entry>
1339               <entry>-</entry>
1340             </row>
1341             <row>
1342               <entry>options:nostat</entry>
1343               <entry>stat vol</entry>
1344               <entry>-</entry>
1345               <entry>yes</entry>
1346               <entry>(V)</entry>
1347               <entry>-</entry>
1348             </row>
1349             <row>
1350               <entry>options:preexec_close</entry>
1351               <entry>preexec close</entry>
1352               <entry>-</entry>
1353               <entry>no</entry>
1354               <entry>(V)</entry>
1355               <entry>-</entry>
1356             </row>
1357             <row>
1358               <entry>options:root_preexec_close</entry>
1359               <entry>root preexec close</entry>
1360               <entry>-</entry>
1361               <entry>no</entry>
1362               <entry>(V)</entry>
1363               <entry>-</entry>
1364             </row>
1365             <row>
1366               <entry>options:upriv</entry>
1367               <entry>unix priv</entry>
1368               <entry>-</entry>
1369               <entry><emphasis role="bold">yes</emphasis></entry>
1370               <entry>(V)</entry>
1371               <entry>-</entry>
1372             </row>
1373             <row>
1374               <entry>options:nodev</entry>
1375               <entry>cnid dev</entry>
1376               <entry>-</entry>
1377               <entry>yes</entry>
1378               <entry>(V)</entry>
1379               <entry>-</entry>
1380             </row>
1381             <row>
1382               <entry>options:illegalseq</entry>
1383               <entry>illegal seq</entry>
1384               <entry>-</entry>
1385               <entry>no</entry>
1386               <entry>(V)</entry>
1387               <entry>-</entry>
1388             </row>
1389             <row>
1390               <entry>options:tm</entry>
1391               <entry>time machine</entry>
1392               <entry>-</entry>
1393               <entry>no</entry>
1394               <entry>(V)</entry>
1395               <entry>-</entry>
1396             </row>
1397             <row>
1398               <entry>options:searchdb</entry>
1399               <entry>search db</entry>
1400               <entry>-</entry>
1401               <entry>no</entry>
1402               <entry>(V)</entry>
1403               <entry>-</entry>
1404             </row>
1405             <row>
1406               <entry>options:nonetids</entry>
1407               <entry>network ids</entry>
1408               <entry>-</entry>
1409               <entry>yes</entry>
1410               <entry>(V)</entry>
1411               <entry>-</entry>
1412             </row>
1413             <row>
1414               <entry>options:noacls</entry>
1415               <entry>acls</entry>
1416               <entry>-</entry>
1417               <entry>yes</entry>
1418               <entry>(V)</entry>
1419               <entry>-</entry>
1420             </row>
1421             <row>
1422               <entry>options:followsymlinks</entry>
1423               <entry>follow symlinks</entry>
1424               <entry>-</entry>
1425               <entry>no</entry>
1426               <entry>(V)</entry>
1427               <entry>-</entry>
1428             </row>
1429             <row>
1430               <entry>options:nohex</entry>
1431               <entry>-</entry>
1432               <entry>-</entry>
1433               <entry>-</entry>
1434               <entry>-</entry>
1435               <entry>auto-convert from ":2f" to ":"</entry>
1436             </row>
1437             <row>
1438               <entry>options:usedots</entry>
1439               <entry>-</entry>
1440               <entry>-</entry>
1441               <entry>-</entry>
1442               <entry>-</entry>
1443               <entry>auto-convert from ":2e" to "."</entry>
1444             </row>
1445             <row>
1446               <entry>options:nofileid</entry>
1447               <entry>-</entry>
1448               <entry>-</entry>
1449               <entry>-</entry>
1450               <entry>-</entry>
1451               <entry>obsolete</entry>
1452             </row>
1453             <row>
1454               <entry>options:prodos</entry>
1455               <entry>-</entry>
1456               <entry>-</entry>
1457               <entry>-</entry>
1458               <entry>-</entry>
1459               <entry>obsolete</entry>
1460             </row>
1461             <row>
1462               <entry>options:mswindows</entry>
1463               <entry>-</entry>
1464               <entry>-</entry>
1465               <entry>-</entry>
1466               <entry>-</entry>
1467               <entry>obsolete</entry>
1468             </row>
1469             <row>
1470               <entry>options:crlf</entry>
1471               <entry>-</entry>
1472               <entry>-</entry>
1473               <entry>-</entry>
1474               <entry>-</entry>
1475               <entry>obsolete</entry>
1476             </row>
1477             <row>
1478               <entry>options:noadouble</entry>
1479               <entry>-</entry>
1480               <entry>-</entry>
1481               <entry>-</entry>
1482               <entry>-</entry>
1483               <entry>obsolete</entry>
1484             </row>
1485             <row>
1486               <entry>options:limitsize</entry>
1487               <entry>-</entry>
1488               <entry>-</entry>
1489               <entry>-</entry>
1490               <entry>-</entry>
1491               <entry>obsolete</entry>
1492             </row>
1493             <row>
1494               <entry>options:dropbox</entry>
1495               <entry>-</entry>
1496               <entry>-</entry>
1497               <entry>-</entry>
1498               <entry>-</entry>
1499               <entry>obsolete</entry>
1500             </row>
1501             <row>
1502               <entry>options:dropkludge</entry>
1503               <entry>-</entry>
1504               <entry>-</entry>
1505               <entry>-</entry>
1506               <entry>-</entry>
1507               <entry>obsolete</entry>
1508             </row>
1509             <row>
1510               <entry>options:nocnidcache</entry>
1511               <entry>-</entry>
1512               <entry>-</entry>
1513               <entry>-</entry>
1514               <entry>-</entry>
1515               <entry>obsolete</entry>
1516             </row>
1517             <row>
1518               <entry>options:caseinsensitive</entry>
1519               <entry>-</entry>
1520               <entry>-</entry>
1521               <entry>-</entry>
1522               <entry>-</entry>
1523               <entry>obsolete</entry>
1524             </row>
1525           </tbody>
1526         </tgroup>
1527       </table></para>
1528   </sect1>
1529
1530   <sect1>
1531     <title>To Do</title>
1532
1533     <para><itemizedlist>
1534         <listitem>
1535           <para>test <command>ad</command> utils with <option>appledouble =
1536           ea</option></para>
1537         </listitem>
1538       </itemizedlist></para>
1539   </sect1>
1540 </chapter>