mtbl_reader(3) [debian man page]

MTBL_READER(3)															    MTBL_READER(3)

NAME

       mtbl_reader - read an MTBL file

SYNOPSIS

       #include <mtbl.h>

       Reader objects:

       struct mtbl_reader *
       mtbl_reader_init(const char *fname, const struct mtbl_reader_options *ropt);

       struct mtbl_reader *
       mtbl_reader_init_fd(int fd, const struct mtbl_reader_options *ropt);

       void
       mtbl_reader_destroy(struct mtbl_reader **r);

       const struct mtbl_source *
       mtbl_reader_source(struct mtbl_reader *r);

       Reader options:

       struct mtbl_reader_options *
       mtbl_reader_options_init(void);

       void
       mtbl_reader_options_destroy(struct mtbl_reader_options **ropt);

       void
       mtbl_reader_options_set_verify_checksums(
	       struct mtbl_reader_options *ropt,
	       bool verify_checksums);

DESCRIPTION

       MTBL files are accessed by creating an mtbl_reader object, calling mtbl_reader_source() to obtain an mtbl_source handle, and using the
       mtbl_source(3) interface to read entries.

       mtbl_reader objects may be created by calling mtbl_reader_init() with an fname argument specifying the filename to be opened, or
       mtbl_reader_init_fd() may be called with an fd argument specifying an open, readable file descriptor. Since MTBL files are immutable, the
       same MTBL file may be opened and read from concurrently by independent threads or processes.

       If the ropt parameter to mtbl_reader_init() or mtbl_reader_init_fd() is non-NULL, the parameters specified in the mtbl_reader_options
       object will be configured into the mtbl_reader object.

   Reader options
       verify_checksums
	   Specifies whether or not the CRC32C checksum on each data block should be verified or not. If verify_checksums is enabled, a checksum
	   mismatch will cause a runtime error. Note that the checksum on the index block is always verified, since the overhead of doing this
	   once when the reader object is instantiated is minimal. The default is to not verify data block checksums.

RETURN VALUE

       mtbl_reader_init() and mtbl_reader_init_fd() return NULL on failure, and non-NULL on success.

								    05/29/2012							    MTBL_READER(3)

GETLASTLOGX(3)						   BSD Library Functions Manual 					    GETLASTLOGX(3)

NAME

     getlastlogx, getutmp, getutmpx, updlastlogx, updwtmpx, utmpxname -- user accounting database functions

LIBRARY

     Standard C Library (libc, -lc)

SYNOPSIS

     #include <utmpx.h>

     struct lastlogx *
     getlastlogx(const char *fname, uid_t uid, struct lastlogx *ll);

     void
     getutmp(const struct utmpx *ux, struct utmp *u);

     void
     getutmpx(const struct utmp *u, struct utmpx *ux);

     int
     updlastlogx(const char *fname, uid_t uid, struct lastlogx *ll);

     int
     updwtmpx(const char *file, const struct utmpx *utx);

     int
     utmpxname(const char *fname);

DESCRIPTION

     The getlastlogx() function looks up the entry for the user with user id uid in the lastlogx(5) file given by fname and returns it in ll.  If
     the provided ll is NULL, the necessary space will be allocated by getlastlogx() and should be free()d by the caller.

     The getutmp() function fills out the entries in the struct utmp u with the data provided in the struct utmpx ux.  getutmpx() does the oppo-
     site, filling out the entries in the struct utmpx ux with the data provided in the struct utmp u, and initializing all the unknown fields to
     0.  The sole exception is the ut_type field, which will be initialized to USER_PROCESS.

     The updlastlogx() function tries to update the information for the user with the user id uid in the lastlogx(5) file given by fname with the
     data supplied in ll.  A struct lastlogx is defined like this:

     struct lastlogx {
	     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 */
     };
     All the fields should be filled out by the caller.

     The updwtmpx() function updates the wtmpx(5) file file with the utmpx(5) entry utx.

     The utmpxname() function sets the default utmpx(5) database file name to fname.

RETURN VALUES

     getlastlogx() returns the found entry on success, or NULL if it could not open the database, could not find an entry matching uid in there,
     or could not allocate the necessary space (in case ll was NULL).

     utmpxname() returns 1 on success, or 0 if the supplied file name was too long or did not end with 'x'.

     updlastlogx() and 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.

SEE ALSO

     endutxent(3), loginx(3), utmpx(5)

HISTORY

     The functions getutmp(), getutmpx(), updwtmpx(), and utmpxname() first appeared in Solaris.  getlastlogx and updlastlogx first appeared in
     NetBSD 2.0.

BSD
								  August 26, 2003							       BSD