doc/manpages/man5/afp_signature.conf.5.xml

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <refentry id="afp_signature.conf.5">
   3
   4   <refmeta>
   5     <refentrytitle>afp_signature.conf</refentrytitle>
   6
   7     <manvolnum>5</manvolnum>
   8
   9     <refmiscinfo class="date">23 Mar 2012</refmiscinfo>
  10
  11     <refmiscinfo class="source">:NETATALK_VERSION:</refmiscinfo>
  12   </refmeta>
  13
  14   <refnamediv>
  15     <refname>afp_signature.conf</refname>
  16
  17     <refpurpose>Configuration file used by afpd(8) to specify server
  18         signature<indexterm>
  19         <primary>afp_signature.conf</primary>
  20       </indexterm></refpurpose>
  21   </refnamediv>
  22
  23   <refsect1>
  24     <title>Description</title>
  25
  26     <para><filename>:STATEDIR:/netatalk/afp_signature.conf</filename> is the
  27     configuration file used by <command>afpd</command> to specify
  28     server signature automagically. The configuration lines are
  29     composed like:</para>
  30
  31     <para><replaceable>"server name"</replaceable>
  32     <replaceable>hexa-string</replaceable></para>
  33
  34     <para>The first field is server name. Server names must be quoted
  35     if they contain spaces. The second field is the hexadecimal string
  36     of 32 characters for 16-bytes server signature.</para>
  37     <para>The leading spaces and tabs are ignored. Blank lines are ignored.
  38     The lines prefixed with # are ignored. The illegal lines are ignored.
  39     </para>
  40
  41     <note>
  42         <para>Server Signature is unique 16-bytes identifier used to
  43         prevent logging on to the same server twice. </para>
  44         <para>Netatalk 2.0 and earlier generated server signature by using
  45         gethostid(). There was a problem that another servers have the same
  46         signature because the hostid is not unique enough.</para>
  47         <para>Current netatalk generates the signature from random numbers and
  48         saves it into afp_signature.conf. When starting next time, it
  49         is read from this file. </para>
  50         <para>This file should not be thoughtlessly edited and be copied
  51         onto another server. If it wants to set the signature intentionally,
  52         use the option "signature ="  in afp.conf. In this case,
  53         afp_signature.conf is not used.</para>
  54     </note>
  55
  56     <para></para>
  57   </refsect1>
  58
  59   <refsect1>
  60     <title>Examples</title>
  61
  62     <example>
  63       <title>afp_signature.conf</title>
  64
  65       <programlisting># This is a comment.
  66 "My Server" 74A0BB94EC8C13988B2E75042347E528</programlisting>
  67     </example>
  68   </refsect1>
  69
  70   <refsect1>
  71     <title>See also</title>
  72
  73     <para><citerefentry>
  74         <refentrytitle>afpd</refentrytitle>
  75
  76         <manvolnum>8</manvolnum>
  77       </citerefentry>, <citerefentry>
  78         <refentrytitle>afp.conf</refentrytitle>
  79
  80         <manvolnum>5</manvolnum>
  81       </citerefentry>, <citerefentry>
  82         <refentrytitle>asip-status.pl</refentrytitle>
  83
  84         <manvolnum>1</manvolnum>
  85       </citerefentry></para>
  86   </refsect1>
  87 </refentry>