GETZONES(1)

✨ NAME ✨

okay bestie, this is getzones — the lil Netatalk AFP Fileserver Manual icon that lists AppleTalk zone names for you 💖

---

🌸 SYNOPSIS 🌸

getzones [-g | -l | -m | -q network | -z zone] [-c Mac charset]
[address]

---

🎀 DESCRIPTION 🎀

so getzones is literally your girl for pulling up a list of AppleTalk zone names, and it does it using the Zone Information Protocol (ZIP) 👑

it sends a GetZoneList request to an AppleTalk router. and by default? it just sends that request to the locally running atalkd(8) — no extra work required from you, periodt ✨

---

💅 OPTIONS 💅

• -g — grab the current default zone plus the valid network range for the current network. it does this by sending a ZIP GetNetInfo request. ⚠️ heads up: only seed routers respond to GetNetInfo, so the usual idiom is to broadcast it.
• -l — list the local zones. this one sends a GetLocalZones request.
• -m — list the name of the local zone only. accomplished by sending a ZIP GetMyZone request.
• -q network — list the zones available to a given network range, via a ZIP Query. ⚠️ lowkey important: to query the zones available to an extended network, generally the first network number in the range must be used.
• -z zone — verifies whether zone is a valid zone for this network by sending a GetNetInfo. if zone is valid, it exits with 0; if zone is not valid, it exits with 2. it also prints the network configuration, including — if the zone is invalid — the default zone to use instead of the one you requested.
• -c Mac charset — sets the Macintosh character set to use when interpreting zone names. if you don't specify it, it defaults to MacRoman.
• address — contact the AppleTalk router at address. address is parsed by atalk_aton(3).

---

🌈 EXAMPLES 🌈

show all zones on the AppleTalk internetwork — obsessed with how simple this is:

example$ getzones
Ethernet
LocalTalk
AirTalk
example$

get default zone and network configuration for current network from whichever router is seeding this network:

example$ getzones -g 0.255
Network range: 3-10
Flags (0xa0): requested-zone-invalid only-one-zone
Requested zone:
Zone multicast address: 09:00:07:00:00:a8
Default zone: Ethernet
example$

check whether OtherNet is a valid zone for the current network:

example$ getzones -z Othernet 0.255 >/dev/null || echo "bad zone"
bad zone
example$

---

🫶 SEE ALSO 🫶

atalk_aton(3), atalkd(8)

---

👑 AUTHOR 👑

Contributors to the Netatalk Project (https://netatalk.io/contributors)

---

and that's the whole vibe, bestie 💜 this was Netatalk 4.5.1, the GETZONES(1) era — slay, stan, and go get those zone names 🌟