Changes between Version 20 and Version 21 of jazz/09-02-01

Timestamp:

Feb 2, 2009, 2:12:30 AM (17 years ago)

Author:

jazz

Comment:

--

jazz/09-02-01

@@ -421 +421 @@
        CESS, LOGIN_PROCESS, USER_PROCESS, or DEAD_PROCESS, getutid() will find
        the first entry whose ut_id field matches ut->ut_id.
+
+RETURN VALUE
+       getutent(), getutid(), getutline() and pututline() return a pointer  to
+       a  struct  utmp  on  success, and NULL on failure.  This struct utmp is
+       allocated in static storage,  and  may  be  overwritten  by  subsequent
+       calls.
+
+FILES
+       /var/run/utmp  database of currently logged-in users
+       /var/log/wtmp  database of past user logins
+
+NOTES
+   Glibc Notes
+       The above functions are not thread-safe.  Glibc adds reentrant versions
+
+       #define _GNU_SOURCE    /* or _SVID_SOURCE or _BSD_SOURCE */
+       #include <utmp.h>
+
+       int getutent_r(struct utmp *ubuf, struct utmp **ubufp);
+
+       int getutid_r(struct utmp *ut,
+                     struct utmp *ubuf, struct utmp **ubufp);
+
+       int getutline_r(struct utmp *ut,
+                       struct utmp *ubuf, struct utmp **ubufp);
+
+       These  functions  are  GNU  extensions, analogs of the functions of the
+       same name without the _r suffix.  The ubuf parameter gives these  func-
+       tions  a  place to store their result.  On success they return 0, and a
+       pointer to the result is written in *ubufp.  On error  these  functions
+       return -1.
+
 }}}
 {{{