doc/manpages/man1/asip-status.pl.1.xml

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <refentry id="asip-status.pl.1">
   3   <refmeta>
   4     <refentrytitle>asip-status.pl</refentrytitle>
   5
   6     <manvolnum>1</manvolnum>
   7
   8     <refmiscinfo class="date">24 Jul 2012</refmiscinfo>
   9
  10     <refmiscinfo class="source">@NETATALK_VERSION@</refmiscinfo>
  11   </refmeta>
  12
  13   <refnamediv>
  14     <refname>asip-status.pl</refname>
  15
  16     <refpurpose>Queries AFP servers for their capabilities</refpurpose>
  17   </refnamediv>
  18
  19   <refsynopsisdiv>
  20     <cmdsynopsis>
  21       <command>asip-status.pl<indexterm>
  22           <primary>asip-status.pl</primary>
  23         </indexterm></command>
  24
  25       <arg choice="opt">-d</arg>
  26       <arg choice="opt">-i</arg>
  27       <arg choice="opt">-x</arg>
  28
  29       <arg choice="plain">HOSTNAME[:PORT]</arg>
  30     </cmdsynopsis>
  31
  32     <sbr />
  33
  34     <cmdsynopsis>
  35       <command>asip-status.pl<indexterm>
  36           <primary>asip-status.pl</primary>
  37         </indexterm></command>
  38
  39       <group choice="plain">
  40         <arg choice="plain">-v</arg>
  41         <arg choice="plain">-version</arg>
  42         <arg choice="plain">--version</arg>
  43       </group>
  44     </cmdsynopsis>
  45
  46   </refsynopsisdiv>
  47
  48   <refsect1>
  49     <title>DESCRIPTION</title>
  50
  51     <para><emphasis remap="B">asip-status.pl</emphasis> is a perl script that
  52     sends a FPGetSrvrInfo request to an AFP server at HOSTNAME:PORT and
  53     displays the results, namely "Machine type", the server's name, supported
  54     AFP versions, UAMs and AFP flags, the "server signature" and the network
  55     addresses, the server provides AFP services on.</para>
  56
  57     <para>When you don't supply :PORT, then the default AFP port, 548, will be
  58     used.</para>
  59   </refsect1>
  60
  61   <refsect1>
  62     <title>OPTIONS</title>
  63
  64     <variablelist remap="TP">
  65       <varlistentry>
  66         <term><option>-d</option></term>
  67
  68         <listitem>
  69           <para>Enable debug output.</para>
  70         </listitem>
  71       </varlistentry>
  72
  73       <varlistentry>
  74         <term><option>-i</option></term>
  75
  76         <listitem>
  77           <para>Show icon if it exists.</para>
  78         </listitem>
  79       </varlistentry>
  80
  81       <varlistentry>
  82         <term><option>-x</option></term>
  83
  84         <listitem>
  85           <para>Enable hex dump output.</para>
  86         </listitem>
  87       </varlistentry>
  88
  89       <varlistentry>
  90         <term><option>-v, -version, --version</option></term>
  91
  92         <listitem>
  93           <para>Show version.</para>
  94         </listitem>
  95
  96       </varlistentry>
  97     </variablelist>
  98   </refsect1>
  99
 100   <refsect1>
 101     <title>EXAMPLES</title>
 102
 103     <para><programlisting><emphasis remap="B">asip-status.pl</emphasis> 192.168.1.15
 104 AFP reply from 192.168.1.15:548
 105 Flags: 1  Cmd: 3  ID: 57005
 106 Reply: DSIGetStatus
 107 Request ID: 57005
 108 Machine type: Macintosh
 109 AFP versions: AFPVersion 1.1,AFPVersion 2.0,AFPVersion 2.1,AFP2.2
 110 UAMs: Cleartxt passwrd,Randnum exchange,2-Way Randnum exchange
 111 Volume Icon &amp; Mask: Yes
 112 Flags:
 113     SupportsCopyFile
 114     SupportsChgPwd
 115     SupportsServerMessages
 116     SupportsServerSignature
 117     SupportsTCP/IP
 118     SupportsSuperClient
 119 Server name: bookchan
 120 Signature:
 121 04 1d 65 23 04 1d 65 23 04 1d 65 23 04 1d 65 23  ..e#..e#..e#..e#
 122
 123 Network address: 192.168.1.15:548 (TCP/IP address and port)
 124 Network address: 65280.128 (ddp address)
 125 </programlisting></para>
 126
 127     <para><programlisting><emphasis remap="B">asip-status.pl</emphasis> myserver:10548
 128 AFP reply from myserver:10548
 129 Flags: 1  Cmd: 3  ID: 57005
 130 Reply: DSIGetStatus
 131 Request ID: 57005
 132 Machine type: Netatalk3.0
 133 AFP versions: AFP2.2,AFPX03,AFP3.1,AFP3.2,AFP3.3
 134 UAMs: DHX2,DHCAST128
 135 Volume Icon &amp; Mask: Yes
 136 Flags:
 137     SupportsCopyFile
 138     SupportsServerMessages
 139     SupportsServerSignature
 140     SupportsTCP/IP
 141     SupportsSrvrNotifications
 142     SupportsOpenDirectory
 143     SupportsUTF8Servername
 144     SupportsUUIDs
 145     SupportsExtSleep
 146     SupportsSuperClient
 147 Server name: myserver
 148 Signature:
 149 8a c6 12 3a 0e d9 95 3e 6f 31 e3 a9 17 f5 70 f6  ...:...>o1....p.
 150
 151 Network address: 192.168.1.154:10548 (TCP/IP address and port)
 152 UTF8 Servername: myserver
 153 </programlisting></para>
 154   </refsect1>
 155
 156   <refsect1>
 157     <title>REPORTING BUGS</title>
 158
 159     <para>Report bugs to the Netatalk-devel list
 160     &lt;netatalk-devel@lists.sourceforge.net&gt;.</para>
 161   </refsect1>
 162 </refentry>