UDHCPC(8)

💖 udhcpc(8) from the GNU/Linux Administrator's Manual — very small DHCP client 💖

---

🌸 NAME 🌸

udhcpc — very small DHCP client. That's it, that's the girlie. ✨

🦋 SYNOPSIS 🦋

udhcpc [OPTION]...

✨ DESCRIPTION ✨

Okay so the udhcp client negotiates a lease with the DHCP server and executes a script when it is obtained or lost. main character energy, honestly. 🫶

💅 OPTIONS 💅

Bestie, here's the whole flag menu — no cap, nothing skipped:

• -c CLIENTID, --clientid=CLIENTID — send the client identifier CLIENTID. 💖
• -f, --foreground — do not fork after obtaining a lease.
• -H HOSTNAME, --hostname=HOSTNAME — send the client hostname HOSTNAME. 🎀
• -h HOSTNAME — alias for -H HOSTNAME. iykyk.
• -i INTERFACE, --interface=INTERFACE — configure INTERFACE. 🦋
• -n, --now — exit with failure if a lease cannot be obtained.
• -p FILE, --pidfile=FILE — write the process ID of the daemon to FILE. 🌸
• -q, --quit — exit after obtaining a lease.
• -r ADDRESS, --request=ADDRESS — request IP address ADDRESS. ⭐
• -s FILE, --script=FILE — use script FILE. 🫶
• -v, --version — display version.

🎀 USAGE 🎀

When an event occurs, udhcpc executes a script. There are four possible arguments to this script:

🎬 script arguments

• deconfig — used when udhcpc starts, and when a lease is lost. The script should put the interface in an up, but deconfigured, state. 💅
• bound — used when udhcpc moves from an unbound to a bound state. The script should configure the interface and set any other relevant parameters (e.g., default gateway, dns server, etc.). 🔥
• renew — used when a lease is renewed. The interface is already configured, so the IP address will not change. Other parameters (e.g., default gateway, subnet mask, dns server) may change. 🌈
• nak — used when udhcpc receives a NAK packet from the server. The environment variable $message will contain the reason for the NAK message if the server included one. Processing this message is optional, as the script will also be called with deconfig if need be. 💀

🌱 environment variables

Parameters are passed to the script via the following environment variables:

• HOME — the inherited HOME, or / if it is unset. yes, slash. 🏠
• PATH — the inherited PATH, or /bin:/usr/bin:/sbin:/usr/sbin if it is unset. periodt.
• interface — the interface.
• ip — the client IP address. 👑
• siaddr — the BOOTP next server option.
• sname — the BOOTP server name option.
• boot_file — the BOOTP boot file option.
• subnet — the subnet mask.
• timezone — the timezone offset from UTC in seconds.
• router — the list of routers. 🛜
• timesvr — the list of time servers.
• namesvr — the list of IEN 116 name servers.
• dns — the list of DNS servers. ✨
• logsvr — the list of MIT-LCS UDP log servers.
• cookiesvr — the list of RFC 865 cookie servers. 🍪
• lprsvr — the list of LPR servers.
• hostname — the host name.
• bootsize — the length in 512-octet blocks of the bootfile.
• domain — the domain name of the network.
• swapsvr — the client's swap server.
• rootpath — the path of the client's root dist.
• ipttl — the TTL.
• mtu — the MTU.
• broadcast — the broadcast address. 📣
• ntpsrv — the list of NTP servers.
• wins — the list of WINS servers.
• lease — the lease time in seconds. ⏳
• dhcptype — the DHCP message type (safely ignored). so don't stress.
• serverid — the server IP address.
• message — reason for a DHCPNAK.
• tftp — the TFTP server name.
• bootfile — the bootfile name.

🍓 FILES 🍓

• /usr/share/udhcpc/default.script — script run when leases are obtained or lost. 🎀

🔔 NOTES 🔔

udhcpc responds to the following signals:

• SIGUSR1 — this signal causes udhcpc to renew the current lease or, if it does not have one, obtain a new lease. 🔥
• SIGUSR2 — this signal causes udhcpc to release the current lease. 💀

mwah 💋 — GNU/Linux, 2001-09-26. periodt. 🌈