getlastlogx.3.patch [plain text]
--- getlastlogx.3.orig 2006-01-11 18:20:07.000000000 -0800
+++ getlastlogx.3 2006-01-04 18:02:57.000000000 -0800
@@ -34,42 +34,33 @@
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd August 26, 2003
+.Dd Dec 26, 2005
.Dt GETLASTLOGX 3
.Os
.Sh NAME
.Nm getlastlogx ,
+.Nm getlastlogxbyname ,
.Nm getutmp ,
.Nm getutmpx ,
-.Nm updlastlogx ,
-.Nm updwtmpx ,
.Nm utmpxname
.Nd user accounting database functions
-.Sh LIBRARY
-.Lb libc
.Sh SYNOPSIS
.In utmpx.h
.Ft struct lastlogx *
-.Fn getlastlogx "const char *fname" "uid_t uid" "struct lastlogx *ll"
+.Fn getlastlogx "uid_t uid" "struct lastlogx *ll"
+.Ft struct lastlogx *
+.Fn getlastlogxbyname "const char *name" "struct lastlogx *ll"
.Ft void
.Fn getutmp "const struct utmpx *ux" "struct utmp *u"
.Ft void
.Fn getutmpx "const struct utmp *u" "struct utmpx *ux"
.Ft int
-.Fn updlastlogx "const char *fname" "uid_t uid" "struct lastlogx *ll"
-.Ft int
-.Fn updwtmpx "const char *file" "const struct utmpx *utx"
-.Ft int
.Fn utmpxname "const char *fname"
.Sh DESCRIPTION
The
.Fn getlastlogx
function looks up the entry for the user with user id
.Fa uid
-in the
-.Xr lastlogx 5
-file given by
-.Fa fname
and returns it in
.Fa \&ll .
If the provided
@@ -81,8 +72,12 @@
and should be
.Fn free Ns d
by the caller.
-.Pp
The
+.Fn getlastlogxbyname
+function is similar to
+.Fn getlastlogx ,
+except the user name is passed.
+.Pp
.Fn getutmp
function fills out the entries in the struct utmp
.Fa u
@@ -99,16 +94,6 @@
field, which will be initialized to
.Dv USER_PROCESS .
.Pp
-The
-.Fn updlastlogx
-function tries to update the information for the user with the user id
-.Fa uid
-in the
-.Xr lastlogx 5
-file given by
-.Fa fname
-with the data supplied in
-.Fa \&ll .
A
.Ft struct lastlogx
is defined like this:
@@ -117,21 +102,8 @@
struct timeval ll_tv; /* time entry was created */
char ll_line[_UTX_LINESIZE]; /* tty name */
char ll_host[_UTX_HOSTSIZE]; /* host name */
- struct sockaddr_storage ll_ss; /* address where entry was made from */
};
.Ed
-All the fields should be filled out by the caller.
-.Pp
-The
-.Fn updwtmpx
-function updates the
-.Xr wtmpx 5
-file
-.Fa file
-with the
-.Xr utmpx 5
-entry
-.Fa utx .
.Pp
The
.Fn utmpxname
@@ -141,11 +113,15 @@
.Fa fname .
.Sh RETURN VALUES
.Fn getlastlogx
-returns the found entry on success, or
+and
+.Fn getlastlogxbyname
+return the found entry on success, or
.Dv NULL
if it could not open the database, could not find an entry matching
.Fa uid
-in there, or could not allocate the necessary space (in case
+or
+.Fa name ,
+or could not allocate the necessary space (in case
.Fa \&ll
was
.Dv NULL ) .
@@ -154,27 +130,17 @@
returns 1 on success, or 0 if the supplied file name was too long or
did not end with
.Sq x .
-.Pp
-.Fn updlastlogx
-and
-.Fn updwtmpx
-return 0 on success, or \-1 in case the database or file respectively
-could not be opened or the data not written into it.
.Sh SEE ALSO
.Xr endutxent 3 ,
-.Xr loginx 3 ,
.Xr utmpx 5
.Sh HISTORY
The functions
.Fn getutmp ,
.Fn getutmpx ,
-.Fn updwtmpx ,
and
.Fn utmpxname
first appeared in
.Tn Solaris .
.Nm getlastlogx
-and
-.Nm updlastlogx
first appeared in
.Nx 2.0 .