xref: /dflybsd-src/libexec/utmp_update/utmp_update.8 (revision e4ec4b66eebec85407429c4c36ee51526c2dafad)
1*e4ec4b66SSascha Wildner.\"	$NetBSD: utmp_update.8,v 1.2 2008/04/30 13:10:52 martin Exp $
259a92d18SAlex Hornung.\"
359a92d18SAlex Hornung.\" Copyright (c) 2002 The NetBSD Foundation, Inc.
459a92d18SAlex Hornung.\" All rights reserved.
559a92d18SAlex Hornung.\"
659a92d18SAlex Hornung.\" This code is derived from software contributed to The NetBSD Foundation
759a92d18SAlex Hornung.\" by Thomas Klausner.
859a92d18SAlex Hornung.\"
959a92d18SAlex Hornung.\" Redistribution and use in source and binary forms, with or without
1059a92d18SAlex Hornung.\" modification, are permitted provided that the following conditions
1159a92d18SAlex Hornung.\" are met:
1259a92d18SAlex Hornung.\" 1. Redistributions of source code must retain the above copyright
1359a92d18SAlex Hornung.\"    notice, this list of conditions and the following disclaimer.
1459a92d18SAlex Hornung.\" 2. Redistributions in binary form must reproduce the above copyright
1559a92d18SAlex Hornung.\"    notice, this list of conditions and the following disclaimer in the
1659a92d18SAlex Hornung.\"    documentation and/or other materials provided with the distribution.
1759a92d18SAlex Hornung.\"
1859a92d18SAlex Hornung.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
1959a92d18SAlex Hornung.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
2059a92d18SAlex Hornung.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
2159a92d18SAlex Hornung.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
2259a92d18SAlex Hornung.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
2359a92d18SAlex Hornung.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
2459a92d18SAlex Hornung.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
2559a92d18SAlex Hornung.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
2659a92d18SAlex Hornung.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
2759a92d18SAlex Hornung.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
2859a92d18SAlex Hornung.\" POSSIBILITY OF SUCH DAMAGE.
2959a92d18SAlex Hornung.\"
3059a92d18SAlex Hornung.Dd December 12, 2002
3159a92d18SAlex Hornung.Dt UTMP_UPDATE 8
3259a92d18SAlex Hornung.Os
3359a92d18SAlex Hornung.Sh NAME
3459a92d18SAlex Hornung.Nm utmp_update
3559a92d18SAlex Hornung.Nd update utmpx database
3659a92d18SAlex Hornung.Sh SYNOPSIS
3759a92d18SAlex Hornung.Nm
3859a92d18SAlex Hornung.Ar utmpx_entry
3959a92d18SAlex Hornung.Sh DESCRIPTION
4059a92d18SAlex Hornung.Nm
4159a92d18SAlex Hornungis a helper program to allow a user to update his own
4259a92d18SAlex Hornung.Xr utmpx 5
4359a92d18SAlex Hornungentry.
4459a92d18SAlex Hornung.Nm
4559a92d18SAlex Hornungdoes some consistency checks on the
4659a92d18SAlex Hornung.Xr strvis 3 Ns No -encoded
4759a92d18SAlex Hornung.Ar utmpx_entry
4859a92d18SAlex Hornungand then updates the
4959a92d18SAlex Hornung.Xr utmpx 5
5059a92d18SAlex Hornungdatabase of currently logged in users.
5159a92d18SAlex Hornung.Pp
5259a92d18SAlex Hornung.Nm
5359a92d18SAlex Hornungshould not be called directly, but will normally only be called by
5459a92d18SAlex Hornung.Xr pututxline 3
5559a92d18SAlex Hornungif the privileges of the calling user are not sufficient.
5659a92d18SAlex Hornung.Sh EXIT STATUS
5759a92d18SAlex Hornung.Nm
5859a92d18SAlex Hornungreturns 0 on success, and 1 if an error occurred.
5959a92d18SAlex Hornung.Sh SEE ALSO
6059a92d18SAlex Hornung.Xr pututxline 3 ,
6159a92d18SAlex Hornung.Xr utmpx 5
62