usr.bin/who/utmpentry.h

   1 /*      $NetBSD: utmpentry.h,v 1.6 2008/04/28 20:24:15 martin Exp $     */
   2
   3 /*-
   4  * Copyright (c) 2002 The NetBSD Foundation, Inc.
   5  * All rights reserved.
   6  *
   7  * This code is derived from software contributed to The NetBSD Foundation
   8  * by Christos Zoulas.
   9  *
  10  * Redistribution and use in source and binary forms, with or without
  11  * modification, are permitted provided that the following conditions
  12  * are met:
  13  * 1. Redistributions of source code must retain the above copyright
  14  *    notice, this list of conditions and the following disclaimer.
  15  * 2. Redistributions in binary form must reproduce the above copyright
  16  *    notice, this list of conditions and the following disclaimer in the
  17  *    documentation and/or other materials provided with the distribution.
  18  *
  19  * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
  20  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
  21  * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  22  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
  23  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
  24  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
  25  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
  26  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
  27  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  28  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  29  * POSSIBILITY OF SUCH DAMAGE.
  30  */
  31
  32 #include <utmpx.h>
  33 #define WHO_NAME_LEN            _UTX_USERSIZE
  34 #define WHO_LINE_LEN            _UTX_LINESIZE
  35 #define WHO_HOST_LEN            _UTX_HOSTSIZE
  36
  37
  38 struct utmpentry {
  39         char name[WHO_NAME_LEN + 1];
  40         char line[WHO_LINE_LEN + 1];
  41         char host[WHO_HOST_LEN + 1];
  42         struct timeval tv;
  43         pid_t pid;
  44         uint16_t term;
  45         uint16_t exit;
  46         uint16_t sess;
  47         short type;
  48         struct utmpentry *next;
  49 };
  50
  51 extern int maxname, maxline, maxhost;
  52 extern int etype;
  53
  54 /*
  55  * getutentries provides a linked list of struct utmpentry and returns
  56  * the number of entries. The first argument, if not null, names an
  57  * alternate utmpx file to look in.
  58  *
  59  * The memory returned by getutentries belongs to getutentries. The
  60  * list returned (or elements of it) may be returned again later if
  61  * utmpx hasn't changed in the meantime.
  62  *
  63  * endutentries clears and frees the cached data.
  64  */
  65
  66 int getutentries(const char *, struct utmpentry **);
  67 void endutentries(void);