<?xml version="1.0" encoding="UTF-8"?>
<refentry id="asip-status.1">
  <refmeta>
    <refentrytitle>asip-status</refentrytitle>

    <manvolnum>1</manvolnum>

    <refmiscinfo class="date">27 Apr 2024</refmiscinfo>

    <refmiscinfo class="source">Netatalk</refmiscinfo>

    <refmiscinfo class="manual">Netatalk AFP Fileserver Manual</refmiscinfo>

    <refmiscinfo class="version">@netatalk_version@</refmiscinfo>
  </refmeta>

  <refnamediv>
    <refname>asip-status</refname>

    <refpurpose>Queries an AFP server for its capabilities</refpurpose>
  </refnamediv>

  <refsynopsisdiv>
    <cmdsynopsis>
      <command>asip-status</command>

      <group>
        <arg choice="plain">-4</arg>

        <arg choice="plain">-6</arg>
      </group>

      <arg>-d</arg>

      <arg>-i</arg>

      <arg>-x</arg>

      <arg><replaceable>HOSTNAME</replaceable></arg>

      <arg><replaceable>PORT</replaceable></arg>
    </cmdsynopsis>

    <cmdsynopsis>
      <command>asip-status</command>

      <group>
        <arg choice="plain">-4</arg>

        <arg choice="plain">-6</arg>
      </group>

      <arg>-d</arg>

      <arg>-i</arg>

      <arg>-x</arg>

      <arg>
        <replaceable>HOSTNAME</replaceable>:<replaceable>PORT</replaceable>
      </arg>
    </cmdsynopsis>

    <cmdsynopsis>
      <command>asip-status</command>

      <group>
        <arg choice="plain">-v</arg>

        <arg choice="plain">-version</arg>

        <arg choice="plain">--version</arg>
      </group>
    </cmdsynopsis>
  </refsynopsisdiv>

  <refsect1>
    <title>Description</title>

    <para><command>asip-status</command> sends an FPGetSrvrInfo request to an
    AFP server at
    <replaceable>HOSTNAME</replaceable>:<replaceable>PORT</replaceable> and
    displays the results: "Machine type", the server's name, supported AFP
    versions, UAMs and AFP flags, the "server signature" and the network
    addresses that the server provides AFP services on.</para>

    <para>When you don't supply <replaceable>PORT</replaceable>, then the
    default AFP port, 548, will be used.</para>

    <para>Starting with Netatalk 3.1.9, <command>asip-status</command>
    supports both IPv4 and IPv6. By default, your system automatically decides
    which protocol version to use. You can use -4 or -6 option to force IPv4
    or IPv6, respectively.</para>
  </refsect1>

  <refsect1>
    <title>Options</title>

    <variablelist remap="TP">
      <varlistentry>
        <term><option>-4</option></term>

        <listitem>
          <para>Use IPv4 only.</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><option>-6</option></term>

        <listitem>
          <para>Use IPv6 only.</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><option>-d</option></term>

        <listitem>
          <para>Enable debug output.</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><option>-i</option></term>

        <listitem>
          <para>Show icon if it exists.</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><option>-x</option></term>

        <listitem>
          <para>Enable hex dump output.</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><option>-v, -version, --version</option></term>

        <listitem>
          <para>Show version.</para>
        </listitem>
      </varlistentry>
    </variablelist>
  </refsect1>

  <refsect1>
    <title>Examples</title>

    <para><programlisting>$ <emphasis remap="B">asip-status</emphasis> 192.168.1.15
AFP reply from 192.168.1.15:548 via IPv4
Flags: 1  Cmd: 3  ID: 57005
Reply: DSIGetStatus
Request ID: 57005
Machine type: Macintosh
AFP versions: AFPVersion 1.1,AFPVersion 2.0,AFPVersion 2.1,AFP2.2
UAMs: Cleartxt passwrd,Randnum exchange,2-Way Randnum exchange
Volume Icon &amp; Mask: Yes
Flags:
    SupportsCopyFile
    SupportsChgPwd
    SupportsServerMessages
    SupportsServerSignature
    SupportsTCP/IP
    SupportsSuperClient
Server name: bookchan
Signature:
04 1d 65 23 04 1d 65 23 04 1d 65 23 04 1d 65 23  ..e#..e#..e#..e#

Network address: 192.168.1.15:548 (IPv4 address and port)
Network address: 65280.128 (ddp address)
</programlisting></para>

    <para><programlisting>$ <emphasis remap="B">asip-status</emphasis> myserver:10548
AFP reply from myserver:10548 via IPv6
Flags: 1  Cmd: 3  ID: 57005
Reply: DSIGetStatus
Request ID: 57005
Machine type: Netatalk3.1.9
AFP versions: AFP2.2,AFPX03,AFP3.1,AFP3.2,AFP3.3,AFP3.4
UAMs: DHX2,DHCAST128
Volume Icon &amp; Mask: Yes
Flags:
    SupportsCopyFile
    SupportsServerMessages
    SupportsServerSignature
    SupportsTCP/IP
    SupportsSrvrNotifications
    SupportsOpenDirectory
    SupportsUTF8Servername
    SupportsUUIDs
    SupportsExtSleep
    SupportsSuperClient
Server name: myserver
Signature:
ea 56 61 0d bf 29 36 31 fa 6a 8a 24 a8 f0 cc 1d  .Va..)61.j.$....

Network address: [fd00:0000:0000:0000:0000:0000:0001:0160]:10548 (IPv6 address + port)
UTF8 Servername: myserver
</programlisting></para>
  </refsect1>

  <refsect1>
    <title>Author</title>

    <para>See <ulink url='https://netatalk.io/contributors'>CONTRIBUTORS</ulink></para>
  </refsect1>
</refentry>
