Loading...
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 | --- 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 . |