1 /*
2  * Copyright (C) 2008 The Android Open Source Project
3  * All rights reserved.
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions
7  * are met:
8  *  * Redistributions of source code must retain the above copyright
9  *    notice, this list of conditions and the following disclaimer.
10  *  * Redistributions in binary form must reproduce the above copyright
11  *    notice, this list of conditions and the following disclaimer in
12  *    the documentation and/or other materials provided with the
13  *    distribution.
14  *
15  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
16  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
17  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
18  * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
19  * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
20  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
21  * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
22  * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
23  * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
24  * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
25  * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
26  * SUCH DAMAGE.
27  */
28 
29 #pragma once
30 
31 /**
32  * @file utmp.h
33  * @brief POSIX login records.
34  */
35 
36 #include <sys/cdefs.h>
37 #include <sys/types.h>
38 #include <time.h>
39 
40 #define _PATH_UTMP      "/var/run/utmp"
41 #define _PATH_WTMP      "/var/log/wtmp"
42 #define _PATH_LASTLOG   "/var/log/lastlog"
43 
44 #ifdef __LP64__
45 #define UT_NAMESIZE 32
46 #define UT_LINESIZE 32
47 #define UT_HOSTSIZE 256
48 #else
49 #define UT_NAMESIZE 8
50 #define UT_LINESIZE 8
51 #define UT_HOSTSIZE 16
52 #endif
53 
54 #define EMPTY         0
55 #define RUN_LVL       1
56 #define BOOT_TIME     2
57 #define NEW_TIME      3
58 #define OLD_TIME      4
59 #define INIT_PROCESS  5
60 #define LOGIN_PROCESS 6
61 #define USER_PROCESS  7
62 #define DEAD_PROCESS  8
63 #define ACCOUNTING    9
64 
65 struct lastlog {
66   time_t ll_time;
67   char ll_line[UT_LINESIZE];
68   char ll_host[UT_HOSTSIZE];
69 };
70 
71 struct exit_status {
72   short int e_termination;
73   short int e_exit;
74 };
75 
76 struct utmp {
77   short int ut_type;
78   pid_t ut_pid;
79   char ut_line[UT_LINESIZE];
80   char ut_id[4];
81   char ut_user[UT_NAMESIZE];
82   char ut_host[UT_HOSTSIZE];
83 
84   struct exit_status ut_exit;
85 
86   long int ut_session;
87   struct timeval ut_tv;
88 
89   int32_t ut_addr_v6[4];
90   char unused[20];
91 };
92 
93 #define ut_name ut_user
94 #define ut_time ut_tv.tv_sec
95 #define ut_addr ut_addr_v6[0]
96 
97 __BEGIN_DECLS
98 
99 /**
100  * Does nothing.
101  */
102 int utmpname(const char* __path);
103 /**
104  * Does nothing.
105  */
106 void setutent(void);
107 /**
108  * Does nothing.
109  */
110 struct utmp* getutent(void);
111 /**
112  * Does nothing.
113  */
114 struct utmp* pututline(const struct utmp* __entry);
115 /**
116  * Does nothing.
117  */
118 void endutent(void);
119 
120 /**
121  * [login_tty(3)](https://www.man7.org/linux/man-pages/man3/login_tty.3.html)
122  * prepares for login on the given file descriptor.
123  *
124  * See also forkpty() which combines openpty(), fork(), and login_tty().
125  *
126  * Returns 0 on success and returns -1 and sets `errno` on failure.
127  *
128  * Available since API level 23.
129  */
130 int login_tty(int __fd) __INTRODUCED_IN(23);
131 
132 __END_DECLS
133