| 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.3 1992-01-28 11:00:25 probe Exp $ |
|---|
| 3 | .\" $Author: probe $ |
|---|
| 4 | .\" |
|---|
| 5 | .TH SESSION_GATE 1 "30 November 1990" |
|---|
| 6 | .ds ]W MIT Project Athena |
|---|
| 7 | .SH NAME |
|---|
| 8 | session_gate, end_session \- control lifetime of a session |
|---|
| 9 | |
|---|
| 10 | .SH SYNOPSIS |
|---|
| 11 | .nf |
|---|
| 12 | session_gate [-logout] |
|---|
| 13 | end_session [ -force | -f ] |
|---|
| 14 | .fi |
|---|
| 15 | .SH DESCRIPTION |
|---|
| 16 | |
|---|
| 17 | \fISession_gate\fR is a process that waits for a user's session to |
|---|
| 18 | end, and then optionally executes their logout script. Normally, |
|---|
| 19 | \fIsession_gate\fR appears at or near the end of a session file used |
|---|
| 20 | by \fIxlogin\fR(1). When used in this fashion, \fIsession_gate\fR |
|---|
| 21 | should not be run in the background. If invoked with the |
|---|
| 22 | \fI-logout\fR option, it will run a \fI/bin/athena/tcsh\fR on the file |
|---|
| 23 | \fI\&.logout\fR in the directory it was started in. |
|---|
| 24 | |
|---|
| 25 | \fIEnd_session\fR is a command that attempts to send a hangup signal to |
|---|
| 26 | each \fIsession_gate\fR process that is running. Normally, the user |
|---|
| 27 | invokes \fIend_session\fR to indicate that the current session is to be |
|---|
| 28 | terminated. The \fIlogout\fR can be aliased (in the shell) to invoke |
|---|
| 29 | \fIend_session\fR, for example. |
|---|
| 30 | |
|---|
| 31 | \fIEnd_session\fR determines the process id of each \fIsession_gate\fR |
|---|
| 32 | process by reading the file /tmp/session_gate_pid.\fIuid\fR, where |
|---|
| 33 | \fIuid\fR is the user's uid number. If the \fI-force\fR or \fI-f\fR option |
|---|
| 34 | is specified, then a combination of \fIps\fR(1) and \fIawk\fR(1) is used |
|---|
| 35 | for determining the process id's. |
|---|
| 36 | |
|---|
| 37 | Note that at Athena, the environment variable \fBXSESSION\fR is |
|---|
| 38 | usually set to the process ID of the \fIsession_gate\fR so that logout |
|---|
| 39 | is just aliased to 'kill -HUP $XSESSION' and \fIend_session\fR is now |
|---|
| 40 | obsolete. |
|---|
| 41 | |
|---|
| 42 | .SH DIAGNOSTICS |
|---|
| 43 | |
|---|
| 44 | \fISession_gate\fR always exits with status 0. |
|---|
| 45 | |
|---|
| 46 | \fIEnd_session\fR will exit with one of the following status values: |
|---|
| 47 | .TP 5 |
|---|
| 48 | 0 |
|---|
| 49 | No error encountered. |
|---|
| 50 | .TP 5 |
|---|
| 51 | 1 |
|---|
| 52 | Bad arguments. |
|---|
| 53 | .TP 5 |
|---|
| 54 | 2 |
|---|
| 55 | No \fIsession_gate\fR processes found (\fI-force\fR or \fI-f\fR option). |
|---|
| 56 | .TP 5 |
|---|
| 57 | 3 |
|---|
| 58 | The file /tmp/session_gate_pid.\fIuid\fR does not exist or is not readable. |
|---|
| 59 | .TP 5 |
|---|
| 60 | 4 |
|---|
| 61 | The file /tmp/session_gate_pid.\fIuid\fR has been modified. |
|---|
| 62 | .PP |
|---|
| 63 | |
|---|
| 64 | .SH FILES |
|---|
| 65 | /tmp/session_gate_pid.\fIuid\fR |
|---|
| 66 | |
|---|
| 67 | .SH "SEE ALSO" |
|---|
| 68 | \fIxlogin\fR(1) |
|---|
| 69 | |
|---|
| 70 | .SH AUTHOR |
|---|
| 71 | .nf |
|---|
| 72 | David J Flanagan, John E Elsbree |
|---|
| 73 | MIT Project Athena |
|---|
| 74 | Copyright 1989, Massachusetts Institute of Technology |
|---|
| 75 | .fi |
|---|
| 76 | |
|---|
| 77 | .SH BUGS |
|---|
| 78 | The \fI-force\fR (\fI-f\fR) option is, admittedly, a kludge. It is very |
|---|
| 79 | dependent on the format of the output produced by \fIps\fR(1). |
|---|
