hddtemp man page on ElementaryOS

Man page or keyword search:  
man Server   4994 pages
apropos Keyword Search (all sections)
Output format
ElementaryOS logo
[printable version]

HDDTEMP(8)							    HDDTEMP(8)

NAME
       hddtemp - Utility to monitor hard drive temperature

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

DESCRIPTION
       hddtemp	will  give  you	 the temperature of your hard drive by reading
       Self-Monitoring Analysis and Reporting Technology (S.M.A.R.T.)	infor‐
       mation  on  drives  that support this feature.  Only modern hard drives
       have a temperature sensor.  hddtemp supports reading S.M.A.R.T.	infor‐
       mation  from  SCSI drives too.  hddtemp can work as simple command line
       tool or as a daemon.

       You can specify one or more device drive path, where each path  can  be
       prefixed	 with  a type like PATA, SATA or SCSI to force hddtemp too use
       one of these type (because detection can fail).

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.

       -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).

       -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.

       -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).

       -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 `|'.

       -S, --syslog=s
	      Switch to daemon mode and log temperatures  to  syslog  every  s
	      seconds.

       -q, --quiet
	      Don't check if the drive is supported.

       -u, --unit=C|F
	      Force output temperature either in Celsius or Fahrenheit.

       -v, --version
	      Display hddtemp version number.

       -w, --wake-up
	      Wake-up the drive if needed (ATA drives only).

       -4     Listen on IPv4 sockets only.

       -6     Listen on IPv6 sockets only.

DRIVE DATABASE
       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

       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.

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 tem‐
       perature.  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 depend‐
       ing 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 investi‐
       gation 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	 your‐
       self.

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.

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).

				 July 21, 2003			    HDDTEMP(8)
[top]

List of man pages available for ElementaryOS

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
...................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net