ASIP-STATUS.PL(1)

✨ asip-status.pl — the manual page, bestie edition ✨

okay so this is the man page for asip-status.pl, from the ASIP-STATUS.PL(1) family, manual section 1. it's a perl script and it's literally so good at asking AFP servers what they can do. grab a snack, we're going in 💖

---

🌸 NAME 🌸

asip-status.pl — Queries AFP servers for their capabilities

no cap, that's the whole job. it asks, servers answer, you get the tea ☕

---

🎀 SYNOPSIS 🎀

asip-status.pl [-4 | -6] [-d] [-i] [-x] HOSTNAME [PORT]

asip-status.pl [-4 | -6] [-d] [-i] [-x] HOSTNAME:PORT

asip-status.pl -v | -version | --version

three whole ways to run her, pick your fighter 💅

---

🦋 DESCRIPTION 🦋

asip-status.pl is a perl script that sends a FPGetSrvrInfo request to an AFP server at HOSTNAME:PORT and then spills all the results. and when I say all, I mean all. what comes back is:

• the "Machine type"
• the server's name
• the supported AFP versions
• the UAMs and AFP flags
• the "server signature"
• the network addresses the server provides AFP services on

so basically the whole personality profile of your server. iconic behavior fr fr 👑

if you don't hand over a PORT, don't stress — the default AFP port, 548, gets used automatically. she's got you 🫶

starting with Netatalk 3.1.9, asip-status.pl supports both IPv4 and IPv6. your system decides which IP version to use, like it's the main character. but if you want to be the main character, you can use the -4 or -6 option to specify the IP version yourself. periodt.

Note 🫧 asip-status.pl requires the IO::Socket::INET6 module. no module, no service. install it bestie, it's giving necessary 💀

---

💅 OPTIONS 💅

• -4 — Use IPv4 only. old school, still slay.
• -6 — Use IPv6 only. futuristic queen energy.
• -d — Enable debug output. for when you need to see everything the girl is thinking 🙈
• -i — Show icon if it exists. cute lil picture moment 🎀
• -x — Enable hex dump output. raw bytes, no filter, we love a transparent server ✨
• -v, -version, --version — Show version. three names, one diva, all valid 🌈

---

🍓 EXAMPLES 🍓

first one, hitting an IPv4 server by its bare IP:

$ asip-status.pl 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 & 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)

look at that signature repeat. 04 1d 65 23 four whole times. she's consistent and I respect it 😌

and here's the second one, a hostname with a custom port, cruising in over IPv6:

$ asip-status.pl 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 & 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

notice the flags list is longer here and there's a whole extra UTF8 Servername: line at the end. glow up 💖✨

---

😭 REPORTING BUGS 😭

found a bug? don't suffer in silence bestie, Report bugs to the Netatalk-devel list <netatalk-devel@lists.sourceforge.net>. they wanna hear from you, fr fr 🫶

---

and that's the whole page! this one's version 3.1.12, dated 06 May 2016, coming at you from the Netatalk crew. mwah, go query a server 💜