Libc-498.tar.gz

[apple/libc.git] / gen / NetBSD / getlastlogx.3.patch

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