utmp

<h2 id="format">Format</h2>
<h3>utmp, wtmp and btmp</h3>
<ul><li>utmp maintains a full accounting of the <i>current</i> status of the system, system boot time (used by <i>uptime</i>), recording user logins at which terminals, logouts, system events etc.</li>
<li>wtmp acts as a historical utmp</li>
<li>btmp records failed login attempts</li></ul>
<p>These files are not regular text files, but rather a binary format which needs to be edited by specially crafted programs. The implementation and the fields present in the file differ depending on the system or the libc version, and are defined in the utmp.h header file. The wtmp and btmp format are exactly like utmp except that a null value for "username" indicates a logout on the associated terminal (the actual user name is located by finding the preceding login on that terminal).  Furthermore, the value "~" as a terminal name with username "shutdown" or "reboot" indicates a system shutdown or reboot (respectively).<a class="footnote-ref" id="fnref:2" href="#fn:2"><sup>2</sup></a>
</p><p>These files are not set by any given <a href="/facts/Pluggable_authentication_module/g8lhxyUk">PAM</a> module (such as pam_unix.so or pam_sss.so) but are set by the application performing the operation (e.g. min<a href="/facts/Getty_(Unix)/gw3FM805">getty</a>, /bin/login, or sshd). As such it is the obligation of the program itself to record the utmp information.
</p>
<h3>utmpx, wtmpx and btmpx</h3>
<p>Utmpx and wtmpx are extensions to the original utmp and wtmp, originating from <a href="/facts/Sun_Microsystems/VJ9EzEFd">Sun Microsystems</a>. Utmpx is specified in <a href="/facts/POSIX/mQkSt234">POSIX</a>.<a class="footnote-ref" id="fnref:3" href="#fn:3"><sup>3</sup></a> The utmp, wtmp and btmp files were never a part of any official Unix standard, such as <a href="/facts/Single_UNIX_Specification/w1ba5bDt">Single UNIX Specification</a>, while utmpx and corresponding APIs are part of it.<a class="footnote-ref" id="fnref:4" href="#fn:4"><sup>4</sup></a><a class="footnote-ref" id="fnref:5" href="#fn:5"><sup>5</sup></a> While some systems create different newer files for the utmpx variants and have deprecated/obsoleted former formats, this is not always the case. <a href="/facts/Linux/9FvCKSTq">Linux</a> for example uses the utmpx structure in the place of the older file structure.
</p>
<h2 id="location">Location</h2>
<p>Depending on the system, those files may commonly be found in different places (non-exhaustive list) :
</p><p><a href="/facts/AIX/cRWERua2">AIX</a>:<a class="footnote-ref" id="fnref:6" href="#fn:6"><sup>6</sup></a>
</p>
/etc/utmp
/var/adm/wtmp

<p><a href="/facts/Linux/9FvCKSTq">Linux</a>:
</p>
/var/run/utmp
/var/log/wtmp
/var/log/btmp

<p><a href="/facts/Oracle_Solaris/KPfT98EJ">Solaris</a>:<a class="footnote-ref" id="fnref:7" href="#fn:7"><sup>7</sup></a>
</p>
/var/adm/utmp (deprecated), /var/adm/utmpx
/var/adm/wtmp (deprecated), /var/adm/wtmpx

<p><a href="/facts/HP-UX/hIvLDdJF">HP-UX</a>:
</p>
/etc/utmp (deprecated), /etc/utmpx
/var/adm/wtmp (deprecated), /var/adm/wtmpx
/var/adm/btmp (deprecated), /var/adm/btmpx

<p><a href="/facts/FreeBSD/RKsFTm7F">FreeBSD 9.0</a> introduced new files while adding support for utmpx:<a class="footnote-ref" id="fnref:8" href="#fn:8"><sup>8</sup></a>
</p>
/var/run/utx.active (replaces utmp)
/var/log/utx.lastlogin (replaces lastlog)
/var/log/utx.log (replaces wtmp)

<h2 id="related-commands">Related commands</h2>
<p>Different commands allow users to consult the information stored in those files. This includes programs <i><a href="/facts/Who_(Unix)/3XnJumIz">who</a></i> (which show current system users), <i>last</i> (which shows the last logged in users) and <i>lastb</i> (which shows the last failed login attempts; Linux-specific).
</p>
<h2 id="see-also">See also</h2>
<ul><li><a href="/facts/Lastlog/f6Im5epU">lastlog</a></li></ul>

<h2 id="external-links">External links</h2>
<ul><li><a href="https://www.freebsd.org/cgi/man.cgi?query=last&sektion=1">last(1)</a>: indicate last logins of users and ttys – <a href="/facts/FreeBSD/RKsFTm7F">FreeBSD</a> General Commands <a href="/facts/Man_page/S2yYjy0J">Manual</a></li>
<li><a href="https://www.freebsd.org/cgi/man.cgi?query=getutxent&sektion=3">getutxent(3)</a>: user login and logouts, and some system activities – <a href="/facts/FreeBSD/RKsFTm7F">FreeBSD</a> Library Functions <a href="/facts/Man_page/S2yYjy0J">Manual</a></li>
<li><a href="https://linux.die.net/man/1/last">last(1)</a>: show listing of last logged in users – <a href="/facts/Linux/9FvCKSTq">Linux</a> User Commands <a href="/facts/Man_page/S2yYjy0J">Manual</a></li>
<li><a href="https://manned.org/utmp.5">utmp(5)</a>: login records – <a href="/facts/Linux/9FvCKSTq">Linux</a> Programmer's <a href="/facts/Man_page/S2yYjy0J">Manual</a> – File Formats</li>
<li><a href="https://docs.oracle.com/cd/E88353_01/html/E37839/last-1.html">last(1)</a>: display login and logout information about users and terminals – <a href="/facts/Solaris_(operating_system)/KPfT98EJ">Solaris 11.4</a> User Commands Reference <a href="/facts/Man_page/S2yYjy0J">Manual</a></li>
<li><a href="https://docs.oracle.com/cd/E88353_01/html/E37852/wtmp-5.html">wtmp(5)</a>: utmp and wtmp entry formats – <a href="/facts/Solaris_(operating_system)/KPfT98EJ">Solaris 11.4</a> File Formats Reference <a href="/facts/Man_page/S2yYjy0J">Manual</a></li></ul>

<h2 id="references">References</h2>

<ol>
<li id="fn:1"><p>"man utmp (5)". manpages.org. <a href="https://manpages.org/utmp/5" target="_blank">https://manpages.org/utmp/5</a> <a href="#fnref:1" class="footnote-back-ref">↩</a></p></li>
<li id="fn:2"><p>"util-linux". github.com. v2.37.2. login-utils/last.c. 2020-12-01. lines 740-750. <a href="https://github.com/util-linux/util-linux/blob/v2.37.2/login-utils/last.c#L740-L750" target="_blank">https://github.com/util-linux/util-linux/blob/v2.37.2/login-utils/last.c#L740-L750</a> <a href="#fnref:2" class="footnote-back-ref">↩</a></p></li>
<li id="fn:3"><p>"utmpx.h - Man Page". www.mankier.com. Institute of Electrical and Electronics Engineers, Inc and The Open Group. Archived from the original on 2023-03-09. <a href="https://archive.today/20230309200416/https://www.mankier.com/0p/utmpx.h" target="_blank">https://archive.today/20230309200416/https://www.mankier.com/0p/utmpx.h</a> <a href="#fnref:3" class="footnote-back-ref">↩</a></p></li>
<li id="fn:4"><p>"utmpx.h - user accounting database definitions". The Open Group Base Specifications. The IEEE and The Open Group. Archived from the original on 8 Sep 2012. <a href="https://archive.today/20120908205449/http://pubs.opengroup.org/onlinepubs/009695399/basedefs/utmpx.h.html" target="_blank">https://archive.today/20120908205449/http://pubs.opengroup.org/onlinepubs/009695399/basedefs/utmpx.h.html</a> <a href="#fnref:4" class="footnote-back-ref">↩</a></p></li>
<li id="fn:5"><p>"Ed's short guide on utmp(x)". 80386.nl. January 12, 2012. Archived from the original on 1 Jul 2012. <a href="https://archive.today/20120701143450/http://80386.nl/unix/utmpx/" target="_blank">https://archive.today/20120701143450/http://80386.nl/unix/utmpx/</a> <a href="#fnref:5" class="footnote-back-ref">↩</a></p></li>
<li id="fn:6"><p>"utmp, wtmp, failedlogin File Format". IBM. March 24, 2023. <a href="https://www.ibm.com/docs/en/aix/7.3?topic=formats-utmp-wtmp-failedlogin-file-format" target="_blank">https://www.ibm.com/docs/en/aix/7.3?topic=formats-utmp-wtmp-failedlogin-file-format</a> <a href="#fnref:6" class="footnote-back-ref">↩</a></p></li>
<li id="fn:7"><p>andy (May 25, 2010). "Solaris Trim wtmpx file". UNIX Note. Archived from the original on 2014-07-07. <a href="https://web.archive.org/web/20140707221308/https://unixnote.com/2010/05/solaris-tip-trim-wtmpx-file.html" target="_blank">https://web.archive.org/web/20140707221308/https://unixnote.com/2010/05/solaris-tip-trim-wtmpx-file.html</a> <a href="#fnref:7" class="footnote-back-ref">↩</a></p></li>
<li id="fn:8"><p>Ed Schouten (2010-01-13). "utmpx.h". github.com. 9.0.0. include/utmpx.h. lines 41-66. <a href="https://github.com/freebsd/freebsd-src/blob/release/9.0.0/include/utmpx.h#L41-L66" target="_blank">https://github.com/freebsd/freebsd-src/blob/release/9.0.0/include/utmpx.h#L41-L66</a> <a href="#fnref:8" class="footnote-back-ref">↩</a></p></li>
</ol>

utmp open-in-new

utmp