manual/netkit/draft/man3/login.3

   1 .\" Copyright (c) 1995
   2 .\"     The Regents of the University of California.  All rights reserved.
   3 .\"
   4 .\" This code is derived from software developed by the Computer Systems
   5 .\" Engineering group at Lawrence Berkeley Laboratory under DARPA contract
   6 .\" BG 91-66 and contributed to Berkeley.
   7 .\"
   8 .\" Redistribution and use in source and binary forms, with or without
   9 .\" modification, are permitted provided that the following conditions
  10 .\" are met:
  11 .\" 1. Redistributions of source code must retain the above copyright
  12 .\"    notice, this list of conditions and the following disclaimer.
  13 .\" 2. Redistributions in binary form must reproduce the above copyright
  14 .\"    notice, this list of conditions and the following disclaimer in the
  15 .\"    documentation and/or other materials provided with the distribution.
  16 .\" 3. All advertising materials mentioning features or use of this software
  17 .\"    must display the following acknowledgement:
  18 .\"     This product includes software developed by the University of
  19 .\"     California, Berkeley and its contributors.
  20 .\" 4. Neither the name of the University nor the names of its contributors
  21 .\"    may be used to endorse or promote products derived from this software
  22 .\"    without specific prior written permission.
  23 .\"
  24 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  25 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  26 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  27 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  28 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  29 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  30 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  31 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  32 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  33 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  34 .\" SUCH DAMAGE.
  35 .\"
  36 .\" Japanese Version Copyright (c) 2000 Yuichi SATO
  37 .\"         all rights reserved.
  38 .\" Translated Thu Dec 14 18:22:51 JST 2000
  39 .\"         by Yuichi SATO <sato@complex.eng.hokudai.ac.jp>
  40 .\"
  41 .Dd December 14, 1995
  42 .Dt LOGIN 3
  43 .Os "Linux NetKit (0.17)"
  44 .\"O .Sh NAME
  45 .Sh Ì¾Á°
  46 .Nm login ,
  47 .Nm logout ,
  48 .Nm logwtmp
  49 .\"O .Nd login utility functions
  50 .Nd ¥í¥°¥¤¥ó¥æ¡¼¥Æ¥£¥ê¥Æ¥£´Ø¿ô
  51 .\"O .Sh SYNOPSIS
  52 .Sh ½ñ¼°
  53 .Fd #include <utmp.h>
  54 .Ft void
  55 .Fn login "struct utmp *ut"
  56 .Ft int
  57 .Fn logout "const char *line"
  58 .Ft void
  59 .Fn logwtmp "const char *line" "const char *name" "const char *host"
  60 .\"O .Sh DESCRIPTION
  61 .Sh ÀâÌÀ
  62 .\"O The
  63 .\"O .Fn login ,
  64 .\"O .Fn logout ,
  65 .\"O and
  66 .\"O .Fn logwtmp
  67 .\"O functions operate on the database of current users in
  68 .\"O .Pa /var/run/utmp
  69 .\"O and on the logfile
  70 .\"O .Pa /var/log/wtmp
  71 .\"O of logins and logouts.
  72 ´Ø¿ô
  73 .Fn login ,
  74 .Fn logout ,
  75 .Fn logwtmp
  76 ¤Ï¡¢
  77 .Pa /var/run/utmp
  78 ¤Ë¤¢¤ë¸½ºß¤Î¥æ¡¼¥¶¡¼¤Î¥Ç¡¼¥¿¥Ù¡¼¥¹¤È¡¢
  79 ¥í¥°¥¤¥ó¡¦¥í¥°¥¢¥¦¥È¤Î¥í¥°¥Õ¥¡¥¤¥ë
  80 .Pa /var/log/wtmp
  81 ¤òÁàºî¤¹¤ë¡£
  82 .Pp
  83 .\"O The
  84 .\"O .Fn login
  85 .\"O function updates the
  86 .\"O .Pa /var/run/utmp
  87 .\"O and
  88 .\"O .Pa /var/log/wtmp
  89 .\"O files with user information contained in
  90 .\"O .Fa ut .
  91 .Fn login
  92 ´Ø¿ô¤Ï¡¢¹½Â¤ÂÎ
  93 .Fa ut
  94 ¤Ë´Þ¤Þ¤ì¤ë¥æ¡¼¥¶¡¼¾ðÊó¤Ç¥Õ¥¡¥¤¥ë
  95 .Pa /var/run/utmp
  96 ¤È
  97 .Pa /var/log/wtmp
  98 ¤ò¹¹¿·¤¹¤ë¡£
  99 .Pp
 100 .\"O The
 101 .\"O .Fn logout
 102 .\"O function removes the entry from
 103 .\"O .Pa /var/run/utmp
 104 .\"O corresponding to the device
 105 .\"O .Fa line .
 106 .Fn logout
 107 ´Ø¿ô¤Ï¡¢¥Ç¥Ð¥¤¥¹
 108 .Fa line
 109 ¤ËÂÐ±þ¤¹¤ë¥¨¥ó¥È¥ê¤ò
 110 .Pa /var/run/utmp
 111 ¤«¤éºï½ü¤¹¤ë¡£
 112 .Pp
 113 .\"O The
 114 .\"O .Fn logwtmp
 115 .\"O function adds an entry to
 116 .\"O .Pa /var/log/wtmp .
 117 .\"O Since
 118 .\"O .Fn login
 119 .\"O will add the appropriate entry for
 120 .\"O .Pa /var/log/wtmp
 121 .\"O during a login,
 122 .\"O .Fn logwtmp
 123 .\"O is usually used for logouts.
 124 .Fn logwtmp
 125 ´Ø¿ô¤Ï¡¢
 126 .Pa /var/log/wtmp
 127 ¤Ë¥¨¥ó¥È¥ê¤òÄÉ²Ã¤¹¤ë¡£
 128 .Fn login
 129 ¤Ï¡¢¥í¥°¥¤¥ó¤Î¤È¤¤ËÅ¬ÀÚ¤Ê¥¨¥ó¥È¥ê¤ò
 130 .Pa /var/log/wtmp
 131 ¤òÄÉ²Ã¤¹¤ë¤Î¤Ç¡¢
 132 .Fn logwtmp
 133 ¤ÏÄÌ¾ï¡¢¥í¥°¥¢¥¦¥È¤Î¤¿¤á¤Ë»È¤ï¤ì¤ë¡£
 134 .\"O .Sh RETURN VALUES
 135 .Sh ÊÖ¤êÃÍ
 136 .\"O .Fn logout
 137 .\"O returns non-zero if it was able to find and delete an entry for
 138 .\"O .Fa line ,
 139 .\"O and zero if there is no entry for
 140 .\"O .Fa line
 141 .\"O in
 142 .\"O .Pa /var/run/utmp .
 143 .Fn logout
 144 ¤Ï¡¢
 145 .Pa /var/run/utmp
 146 ¤Ç
 147 .Fa line
 148 ¤È¤¤¤¦¥¨¥ó¥È¥ê¤¬¸«¤Ä¤«¤Ã¤¿¤êºï½ü¤Ç¤¤¿¤ê¤·¤¿¾ì¹ç¡¢0 °Ê³°¤òÊÖ¤¹¡£
 149 .Fa line
 150 ¤È¤¤¤¦¥¨¥ó¥È¥ê¤¬¤Ê¤¤¾ì¹ç¡¢0 ¤òÊÖ¤¹¡£
 151 .\"O .Sh FILES
 152 .Sh ¥Õ¥¡¥¤¥ë
 153 .Bl -tag -width /var/run/wtmp -compact
 154 .It Pa /dev/\(**
 155 .It Pa /etc/ttys
 156 .It Pa /var/run/utmp
 157 .It Pa /var/log/wtmp
 158 .El
 159 .\"O .Sh SEE ALSO
 160 .Sh ´ØÏ¢¹àÌÜ
 161 .Xr utmp 5