Debian Codegraph @

upstream/debian-unstable/man1/sessreg.1

raw
1 .\" Copyright 1994, 1998 The Open Group
2 .\"
3 .\" Permission to use, copy, modify, distribute, and sell this software and its
4 .\" documentation for any purpose is hereby granted without fee, provided that
5 .\" the above copyright notice appear in all copies and that both that
6 .\" copyright notice and this permission notice appear in supporting
7 .\" documentation.
8 .\"
9 .\" The above copyright notice and this permission notice shall be included
10 .\" in all copies or substantial portions of the Software.
11 .\"
12 .\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
13 .\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
14 .\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
15 .\" IN NO EVENT SHALL THE OPEN GROUP BE LIABLE FOR ANY CLAIM, DAMAGES OR
16 .\" OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
17 .\" ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
18 .\" OTHER DEALINGS IN THE SOFTWARE.
19 .\"
20 .\" Except as contained in this notice, the name of The Open Group shall
21 .\" not be used in advertising or otherwise to promote the sale, use or
22 .\" other dealings in this Software without prior written authorization
23 .\" from The Open Group.
24 .\"
25 .TH SESSREG 1 "sessreg 1.1.3" "X Version 11"
26 .SH NAME
27 sessreg \- manage utmpx/wtmpx entries for non-init clients
28 .SH SYNOPSIS
29 .B sessreg
30 [-w \fIwtmpx-file\fP]
31 [-u \fIutmpx-file\fP]
32 [-L \fIlastlog-file\fP]
33 [-l \fIline-name\fP]
34 [-h \fIhost-name\fP]
35 [-s \fIslot-number\fP]
36 [-x \fIXservers-file\fP]
37 [-t \fIttys-file\fP]
38 [-V]
39 [-a]
40 [-d]
41 \fIuser-name\fP
42 .SH DESCRIPTION
43 .PP
44 \fISessreg\fP is a simple program for managing utmpx/wtmpx and lastlog
45 entries for xdm sessions.
46 .\" __BEGIN_UTMPX_ONLY__
47 .PP
48 This version of \fIsessreg\fP is built using the modern POSIX
49 .BR pututxline (3c)
50 interfaces, which no longer require the slot-number, ttys-file, or
51 Xservers-file mappings. For compatibility with older versions and other
52 operating systems, the \fB-s\fP, \fB-t\fP, and \fB-x\fP flags are accepted,
53 but ignored.
54 .\" __END_UTMPX_ONLY__
55 .SH USAGE
56 .PP
57 In Xstartup, place a call like:
58 .nf
59
60 sessreg -a -l $DISPLAY -x /etc/X11/xdm/Xservers $USER
61
62 .fi
63 and in Xreset:
64 .nf
65
66 sessreg -d -l $DISPLAY -x /etc/X11/xdm/Xservers $USER
67 .fi
68 .SH OPTIONS
69 .IP "\fB-w\fP \fIwtmpx-file\fP"
70 This specifies an alternate wtmpx file, instead of
71 .BR "/var/log/wtmp" .
72 The special name "none" disables writing records to the wtmpx file.
73 .IP "\fB-u\fP \fIutmpx-file\fP"
74 This specifies an alternate utmpx file, instead of
75 .BR "/var/run/utmp" .
76 The special name "none" disables writing records to the utmpx file.
77 .IP "\fB-L\fP \fIlastlog-file\fP"
78 This specifies an alternate lastlog file, instead of
79 .BR "/var/log/lastlog" ,
80 if the platform supports lastlog files.
81 The special name "none" disables writing records to the lastlog file.
82 .IP "\fB-l\fP \fIline-name\fP"
83 This describes the "line" name of the entry. For terminal sessions,
84 this is the final pathname segment of the terminal device filename
85 (e.g. ttyd0). For X sessions, it should probably be the local display name
86 given to the users session (e.g. :0). If none is specified, the
87 terminal name will be determined with ttyname(3) and stripped of leading
88 components.
89 .IP "\fB-h\fP \fIhost-name\fP"
90 This is set to indicate that the session was initiated from
91 a remote host. In typical xdm usage, this options is not used.
92 .IP "\fB-s\fP \fIslot-number\fP"
93 .\" __BEGIN_UTMPX_ONLY__
94 This option is accepted for compatibility, but does nothing in
95 this version of \fIsessreg\fP.
96 .\" __END_UTMPX_ONLY__
97 .IP "\fB-x\fP \fIXservers-file\fP"
98 .\" __BEGIN_UTMPX_ONLY__
99 This option is accepted for compatibility, but does nothing in
100 this version of \fIsessreg\fP.
101 .\" __END_UTMPX_ONLY__
102 .IP "\fB-t\fP \fIttys-file\fP"
103 .\" __BEGIN_UTMPX_ONLY__
104 This option is accepted for compatibility, but does nothing in
105 this version of \fIsessreg\fP.
106 .\" __END_UTMPX_ONLY__
107 .IP "\fB-V\fP"
108 This option causes the command to print its version and exit.
109 .IP "\fB-a\fP"
110 This session should be added to utmpx/wtmpx.
111 .IP "\fB-d\fP"
112 This session should be deleted from utmpx/wtmpx. One of -a/-d must
113 be specified.
114 .SH "SEE ALSO"
115 .BR xdm (1),
116 .BR utmpx (5),
117 .BR wtmpx (5)
118 .SH AUTHOR
119 Keith Packard, MIT X Consortium