source: trunk/athena/bin/session/session_gate.1 @ 3888

Revision 3888, 2.1 KB checked in by probe, 34 years ago (diff)
Initial revision
Line 
1.\"     $Source: /afs/dev.mit.edu/source/repository/athena/bin/session/session_gate.1,v $
2.\"     $Header: /afs/dev.mit.edu/source/repository/athena/bin/session/session_gate.1,v 1.1 1990-11-30 17:57:29 probe Exp $
3.\"     $Author: probe $
4.\"
5.TH SESSION_GATE 1 "5 August 1989"
6.ds ]W MIT Project Athena
7.SH NAME
8session_gate, end_session \- control lifetime of a session
9
10.SH SYNOPSIS
11.nf
12session_gate
13end_session [ -force | -f ]
14.fi
15.SH DESCRIPTION
16
17\fISession_gate\fR is a process that has the sole purpose of preventing a
18session file from exiting.  Normally, \fIsession_gate\fR appears at or near
19the end of a session file used by \fIxlogin\fR(1).  When used in this
20fashion, \fIsession_gate\fR should not be run in the background.
21
22\fIEnd_session\fR is a command that attempts to send a hangup signal to
23each \fIsession_gate\fR process that is running.  Normally, the user
24invokes \fIend_session\fR to indicate that the current session is to be
25terminated.  The \fIlogout\fR can be aliased (in the shell) to invoke
26\fIend_session\fR, for example.
27
28\fIEnd_session\fR determines the process id of each \fIsession_gate\fR
29process by reading the file /tmp/session_gate_pid.\fIuid\fR, where
30\fIuid\fR is the user's uid number.  If the \fI-force\fR or \fI-f\fR option
31is specified, then a combination of \fIps\fR(1) and \fIawk\fR(1) is used
32for determining the process id's.
33
34.SH DIAGNOSTICS
35
36\fISession_gate\fR always exits with status 0.
37
38\fIEnd_session\fR will exit with one of the following status values:
39.TP 5
400
41No error encountered.
42.TP 5
431
44Bad arguments.
45.TP 5
462
47No \fIsession_gate\fR processes found (\fI-force\fR or \fI-f\fR option).
48.TP 5
493
50The file /tmp/session_gate_pid.\fIuid\fR does not exist or is not readable.
51.TP 5
524
53The file /tmp/session_gate_pid.\fIuid\fR has been modified.
54.PP
55
56.SH FILES
57/tmp/session_gate_pid.\fIuid\fR
58
59.SH "SEE ALSO"
60\fIxlogin\fR(1)
61
62.SH AUTHOR
63.nf
64David J Flanagan, John E Elsbree
65MIT Project Athena
66Copyright 1989, Massachusetts Institute of Technology
67.fi
68
69.SH BUGS
70The \fI-force\fR (\fI-f\fR) option is, admittedly, a kludge.  It is very
71dependent on the format of the output produced by \fIps\fR(1).
Note: See TracBrowser for help on using the repository browser.