utmpd(1m) - osol9

1utmpd(1M)               System Administration Commands               utmpd(1M)
2
3
4

NAME

6       utmpd - utmpx monitoring daemon
7

SYNOPSIS

9       utmpd [-debug]
10
11

DESCRIPTION

13       The  utmpd  daemon  monitors the /var/adm/utmpx file. See utmpx(4) (and
14       utmp(4) for historical information).
15
16
17       utmpd receives requests from pututxline(3C) by way of a named pipe.  It
18       maintains  a  table  of  processes  and  uses poll(2) on /proc files to
19       detect process termination. When utmpd detects that a process has  ter‐
20       minated,  it  checks  that the process has removed its utmpx entry from
21       /var/adm/utmpx. If the process' utmpx entry has not been removed, utmpd
22       removes  the  entry.  By periodically scanning the /var/adm/utmpx file,
23       utmpd also monitors processes that are not in its table.
24

OPTIONS

26       -debug
27
28           Run in debug mode, leaving the process connected to the controlling
29           terminal. Write debugging information to standard output.
30
31

EXIT STATUS

33       The following exit values are returned:
34
35       0
36
37           Successful completion.
38
39
40       >0
41
42           An error occurred.
43
44

FILES

46       /etc/default/utmpd
47
48           You can set default values for the flags listed below. For example:
49           SCAN_PERIOD=600
50
51           SCAN_PERIOD
52
53               The number of seconds that utmpd sleeps between checks of /proc
54               to  see  if monitored processes are still alive. The default is
55               300.
56
57
58           MAX_FDS
59
60               The maximum number of processes that utmpd attempts to monitor.
61               The default value is 4096.
62
63
64           WTMPX_UPDATE_FREQ
65
66               The  number  of seconds that utmpd sleeps between read accesses
67               of the wtmpx file. The wtmpx file's last access time is used by
68               init(1M)  on  reboot  to  determine  when  the operating system
69               became unavailable. The default is 60.
70
71
72
73       /var/adm/utmpx
74
75           File containing user and accounting information for  commands  such
76           as who(1), write(1), and login(1).
77
78
79       /proc
80
81           Directory  containing  files  for processes whose utmpx entries are
82           being monitored.
83
84

ATTRIBUTES

86       See attributes(5) for descriptions of the following attributes:
87
88
89
90
91       ┌─────────────────────────────┬─────────────────────────────┐
92       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
93       ├─────────────────────────────┼─────────────────────────────┤
94       │Availability                 │SUNWcsu                      │
95       └─────────────────────────────┴─────────────────────────────┘
96

NOTES

102       If  the filesystem holding /var/adm/wtmpx is mounted with options which
103       inhibit or defer access time updates, an unknown amount of  error  will
104       be  introduced  into the utmp DOWN_TIME record's timestamp in the event
105       of an uncontrolled shutdown (for example, a crash or loss of  power  ).
106       Controlled  shutdowns  will  update  the modify time of /var/adm/wtmpx,
107       which will be used on the next boot  to  determine  when  the  previous
108       shutdown ocurred, regardless of access time deferral or inhibition.
109
110
111       The  utmpd  service  is  managed  by  the  service management facility,
112       smf(5), under the service identifier:
113
114         svc:/system/utmp:default
115
116
117
118
119       Administrative actions on this service, such as enabling, disabling, or
120       requesting  restart,  can  be performed using svcadm(1M). The service's
121       status can be queried using the svcs(1) command.
122
123
124
125SunOS 5.11                        4 Jun 2008                         utmpd(1M)