UTX(8)			  BSD System Manager's Manual			UTX(8)

NAME
     utx, utxrm — manage the user accounting database

SYNOPSIS
     utx boot
     utx shutdown
     utx rm identifier ...
     utxrm identifier ...

DESCRIPTION
     The utx utility can be used to perform operations on the user accounting
     database, as done by pututxline(3).

     The first argument to utx indicates an action to be performed:

     boot      Write a boot time record to the user accounting database.  This
	       option should typically only be used by rc(8).

     shutdown  Write a shutdown time record to the user accounting database.
	       This option should typically only be used by rc(8).

     rm        Remove stale sessions from the user accounting database, by
	       referring to their identifier.  Stale sessions can occur if a
	       login service exits prematurely or fails to remove the session
	       from the accounting database.

	       Utilities such as w(1) will not display the identifier corre‐
	       sponding with a login session, since its value is typically
	       only of use by the process managing the record.	The following
	       command can be used to obtain all records from the user
	       accounting database's active session table, including its iden‐
	       tifiers:

		     getent utmpx active

	       Identifiers can either be supplied in hexadecimal form as dis‐
	       played by getent(1), or as a string if the identifier allows
	       such a representation.

	       To remain backward compatible, this action can also be invoked
	       directly by using the utxrm command.

     Because this utility requires write-access to the user accounting data‐
     base, its use is limited to the super-user.

SEE ALSO
     getent(1), w(1), pututxline(3)

HISTORY
     The utx utility replaced utxrm in FreeBSD 10.0.

AUTHORS
     Ed Schouten ⟨ed@FreeBSD.org⟩

BSD			       February 11, 2012			   BSD