HDDTEMP(8)

💖 hddtemp(8) — the hard drive temperature girlie 💖

ok so bestie, welcome to the hddtemp manual page, section 8 of your System Manager's Manual 💅 this is the glow-up where I tell you literally everything the original page says, just with the personality it deserves 🫶

✨ NAME ✨

hddtemp — a whole utility to monitor hard drive temperature, no cap 🌡️

✨ SYNOPSIS ✨

hddtemp [options] [type:]disk...

✨ DESCRIPTION ✨

okay so here's the vibe: hddtemp gives you the temperature of your hard drive by reading Self-Monitoring Analysis and Reporting Technology (S.M.A.R.T.) information on drives that support this feature 🔥 Only modern hard drives have a temperature sensor, jsyk. And hddtemp supports reading S.M.A.R.T. information from SCSI drives too — she's versatile like that 💅 hddtemp can work as a simple command line tool or as a daemon, main character energy either way 👑

You can specify one or more device drive path, and each path can be prefixed with a type like PATA, SATA or SCSI to force hddtemp to use one of these type (because detection can fail 😭 — she's trying her best).

✨ OPTIONS ✨

The program follows the usual GNU command line syntax, with long options starting with two dashes (-). A summary of options is included below 🎀

• -b, --drivebase — Display the database file that allows hddtemp to recognize a supported drive. like, show me the receipts 📄
• -D, --debug — Display various S.M.A.R.T. fields and their values. Useful for finding a value that seems to match the temperature and/or to send a report. (done for every drive supplied) 🕵️‍♀️
• -d, --daemon — Execute hddtemp in TCP/IP daemon mode (port 7634 by default). she's out here listening 👀
• -f, --file=file — Specify the database file to use. 🗂️
• -F, --foreground — Don't fork into the background even in daemon mode. This is useful when running under a process supervisor. no disappearing acts 💀
• -l, --listen=addr — Listen on a specific address. addr is a string containing a host name or a numeric host address string. The numeric host address string is a dotted-decimal IPv4 address or an IPv6 hex address. 🌐
• -n, --numeric — Print only the temperature (without the unit). just the digits bestie 🔢
• -p, --port=# — Port number to listen to (in TCP/IP daemon mode). 🚪
• -s, --separator=char — Separator to use between fields (in TCP/IP daemon mode). The default separator is |. aesthetic field-splitting ✨
• -S, --syslog=s — Switch to daemon mode and log temperatures to syslog every s seconds. set it and forget it 💜
• -q, --quiet — Don't check if the drive is supported. shhh 🤫
• -u, --unit=C|F — Force output temperature either in Celsius or Fahrenheit. pick your fighter 🌡️
• -v, --version — Display hddtemp version number. 🏷️
• -w, --wake-up — Wake-up the drive if needed (ATA drives only). rise and shine sleepyhead ☀️
• -4 — Listen on IPv4 sockets only.
• -6 — Listen on IPv6 sockets only.

✨ DRIVE DATABASE ✨

So if you know your drive has a temperature sensor but it is being reported unsupported, tell me which model and which manufacturer it is, and/or just add a new entry in /etc/hddtemp.db 🗄️ Each line of hddtemp.db is either a comment, a blank line or a line containing:

• a regular expression that allow hddtemp to recognize a drive or a set of drives from its model name or from a generic model name,
• a value (ATTRIBUTE_ID from S.M.A.R.T.),
• a C or an F to set the unit to Celsius or Fahrenheit,
• a description.

Feedback is welcome (see the REPORT section below) 💌

✨ TCP/IP DAEMON MODE ✨

Example of type forcing:

# hddtemp SATA:/dev/sda PATA:/dev/hda

To test hddtemp in daemon mode, start it like this:

# hddtemp -d /dev/hd[abcd]

and use telnet or netcat (which is known as nc on some systems) to get a reply:

# netcat localhost 7634

⚠️ ok important thing: the drive database is read only once at startup, so hddtemp must be restarted if the database is updated for the changes to take effect. no hot-reloading here bestie 😭

✨ REPORT ✨

As I receive a lot of reports, things must be clarified. When running hddtemp with debug options, hddtemp will show sort of a dump of S.M.A.R.T. data. Each field corresponds to an information field. The standard field for drive temperature is 194. But this is not always the case (mostly for older drives). Even if your drive has S.M.A.R.T. capabilities, it doesn't necessarily mean that it can report its temperature. So, things must be determined through experimentation 🔬

So, you can try to guess which field by is the good one by running hddtemp at regular intervals:

• just after starting up your PC/server/station,
• after opening a window (a physical window :),
• after opening the case,
• whatever you can think of...

and looking for a field's value that would increase or decrease depending on what effect you want to induce 👀 Be careful, fields 4, 9, and 12 are often reported to match a temperature field but after some investigation they do not. But fields 194 (which is the standard field for temperature) and 231 are good candidates 💯

Then, you can send me a report with outputs from hddtemp --debug ..., smartctl or hdparm -i ..., and/or add an entry in hddtemp.db yourself 🫶

✨ BUGS ✨

If hddtemp crashes (yes, it might 😭) for some unknown reasons, look for a file named hddtemp.backtrace.<PID>.XXXXXX (where XXXXXX is a random number generated at runtime) in /tmp. Then, you can then send me this file and the hddtemp binary 📮 The backtrace functionality is currently supported on i386 architectures only. sorry to the other girlies 💀

✨ SEE ALSO ✨

smartctl(8), syslog(3), syslogd(8).

✨ AUTHOR ✨

Emmanuel Varagnat (hddtemp@guzu.net).

This manual page was originally written by Aurelien Jarno <aurel32@debian.org>, for the Debian GNU/Linux system (but may be used by others).

---

ok that's the whole page, you ate that bestie 💅👑 and if you're wondering about the source and date: this is from the System Manager's Manual, HDDTEMP(8), dated July 21, 2003 — iconic, vintage, timeless 🎀✨🦋💜