Debian Codegraph @

upstream/mageia-cauldron/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 2025-03-22 "sessreg 1.1.4" "X Version 11"
26 .SH NAME
27 sessreg \- manage utmpx/wtmpx entries for non-init clients
28 .SH SYNOPSIS
29 .nf
30 \fBsessreg\fP \
31 [\fB\-w\fP \fIwtmpx-file\fP] \
32 [\fB\-u\fP \fIutmpx-file\fP] \
33 [\fB\-L\fP \fIlastlog-file\fP]
34 [\fB\-l\fP \fIline-name\fP] \
35 [\fB\-h\fP \fIhost-name\fP] \
36 [\fB\-s\fP \fIslot-number\fP]
37 [\fB\-x\fP \fIXservers-file\fP] \
38 [\fB\-t\fP \fIttys-file\fP] \
39 [\fB\-V\fP] \
40 [\fB\-a\fP] \
41 [\fB\-d\fP] \
42 \fIuser-name\fP
43 .fi
44 .SH DESCRIPTION
45 \fBSessreg\fP is a simple program for managing utmpx/wtmpx
46 and lastlog entries for xdm sessions.
47 .\" __BEGIN_UTMPX_ONLY__
48 .PP
49 This version of \fBsessreg\fP is built using the modern POSIX
50 .BR pututxline (3c)
51 interfaces, which no longer require the slot-number, ttys-file, or
52 Xservers-file mappings. For compatibility with older versions and other
53 operating systems, the \fB-s\fP, \fB-t\fP, and \fB-x\fP flags are accepted,
54 but ignored.
55 .\" __END_UTMPX_ONLY__
56 .SH USAGE
57 In Xstartup, place a call like:
58 .sp
59 .nf
60 sessreg -a -l $DISPLAY -x /etc/X11/xdm/Xservers $USER
61 .fi
62 .sp
63 and in Xreset:
64 .sp
65 .nf
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 "/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
88 .BR ttyname (3)
89 and stripped of leading components.
90 .IP "\fB-h\fP \fIhost-name\fP"
91 This is set to indicate that the session was initiated from
92 a remote host. In typical xdm usage, this options is not used.
93 .IP "\fB-s\fP \fIslot-number\fP"
94 .\" __BEGIN_UTMPX_ONLY__
95 This option is accepted for compatibility, but does nothing in
96 this version of \fBsessreg\fP.
97 .\" __END_UTMPX_ONLY__
98 .IP "\fB-x\fP \fIXservers-file\fP"
99 .\" __BEGIN_UTMPX_ONLY__
100 This option is accepted for compatibility, but does nothing in
101 this version of \fBsessreg\fP.
102 .\" __END_UTMPX_ONLY__
103 .IP "\fB-t\fP \fIttys-file\fP"
104 .\" __BEGIN_UTMPX_ONLY__
105 This option is accepted for compatibility, but does nothing in
106 this version of \fBsessreg\fP.
107 .\" __END_UTMPX_ONLY__
108 .IP "\fB-V\fP, \fB--version\fP"
109 This option causes the command to print its version and exit.
110 .IP "\fB-a\fP"
111 This session should be added to utmpx/wtmpx.
112 .IP "\fB-d\fP"
113 This session should be deleted from utmpx/wtmpx.
114 One of
115 .BR -a / -d
116 must be specified.
117 .SH "SEE ALSO"
118 .BR xdm (1),
119 .BR utmpx (5),
120 .BR wtmpx (5)
121 .SH AUTHOR
122 Keith Packard, MIT X Consortium