WOL(1)

💖 WOL(1) — the glow-up 💖

okay so real talk, this is the manual page for wol, bestie. yes it's a <italic>wol</italic>(1) situation, section 1, and I'm gonna walk you through the whole thing like we're on FaceTime. grab a snack. 🍓

---

✨ NAME ✨

wol — it's a Wake On LAN client, and it's literally out here turning on computers from across the room like it's got main character energy 👑

---

🌸 SYNOPSIS 🌸

wol [OPTION] ... MAC-ADDRESS ...

---

🦋 DESCRIPTION 🦋

so this manual is your little intro to wol, the Wake On LAN client. what does it DO? it remotely turns on computers that support Magic Packet technology (also known as Wake On LAN). you send the packet, the computer goes from sleep to slay. no cap. ✨

some workstations also support the SecureON password feature — those machines are picky and will only wake up if you provide the correct password. and yes, wol provides that feature too, because it's thoughtful like that 💅

---

🎀 OPTIONS 🎀

• --help — prints you a little summary of the command line options. the "what is going on" button.
• -V, --version — prints the version number of wol. gotta know what you're running, iykyk.
• -h HOST, --host=HOST, -i HOST, --ipaddr=HOST — broadcasts the packet to this IP address or hostname. this one's important if your wol client is a multihomed host and you want to send only to one subnet. (the default IP address is 255.255.255.255, iconic behavior btw.)
• -p NUM, --port=NUM — sends the packet with this destination port NUM. super important if your packet filter would block the default destination port 40000. rude of it honestly.
• -f FILE, --file=FILE — reads hardware addresses, IP addresses/hostnames, optional ports and the SecureON password from file FILE. and if FILE is -, wol reads from stdin. cute.
• - — reads hardware addresses, IP addresses, optional ports and optional SecureON password from stdin. so you can extract MAC-ADDRESSES from any source and pipe the data into wol like that. pipeline queen behavior 🫶
• -v, --verbose — turns on verbose output. she's chatty now 💬
• -w NUM, --wait=NUM — waits NUM milliseconds between Magic Packets. also known as fuse health pack. (yes that's what it says, i don't make the rules 🧚)
• --passwd[=PASS] — sends a magic packet with the SecureON password feature. PASS is written as x-x-x-x-x-x, where x is a hexadecimal number between 0 and ff which represents one byte of the password.

if you don't provide PASS, wol prompts you for a password. so either way you're covered 💜

also, quick side note: to set the password of your SecureON capable NIC, you can use ethtool (<http://www.sourceforge.net/projects/gkernel/>). you're welcome 🌈

---

💀 BUGS 💀

please report bugs to <krennwallner@aon.at>. feel free to send bug reports, translations, improvement suggestions and patches to this email address. be nice, they're literally asking for it 🥺

---

🌟 SEE ALSO 🌟

• GNU info entry for wol.

like, the info page. go read it, she's thorough ✨

---

👑 AUTHOR 👑

written by Thomas Krennwallner <krennwallner@aon.at>. legend.

---

🌈 COPYRIGHT 🌈

copyright (C) 2001,2002,2003,2004 Thomas Krennwallner <krennwallner@aon.at>

this document may be distributed and modified under the terms of the GNU General Public License.

this manual is free software; you may redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2, or (at your option) any later version.

this manual is distributed in the hope that it will be useful, but without any warranty; without even the implied warranty of merchantability or fitness for a particular purpose. see the GNU General Public License for more details.

a copy of the GNU General Public License is available on the World Wide Web at the GNU website. you can also obtain it by writing to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.

---

okay and for the cute sign-off: this whole thing is wol 0.7.1, dated 2024-07-08, and that's the WOL(1) manual page, bestie. go wake some computers. periodt 💅🔥🎀