plan9fox/sys/man/9/eve
Ori Bernstein 0b6f0c70db add start of section 9 manpages (thanks rgl)
this change adds some of the kernel manpages from 9legacy,
fixed and updated to match the changes in 9front.
2019-11-19 12:30:40 -08:00

47 lines
1.1 KiB
Plaintext

.TH EVE 9
.SH NAME
eve, iseve \- privileged user
.SH SYNOPSIS
.ta \w'\fLchar* 'u
.B
char *eve;
.PP
.B
int iseve(void)
.SH DESCRIPTION
.I Eve
is a null-terminated string containing the name of the owner of
the Plan 9 system (sometimes called the `host owner',
see
.IR cons (3)).
The identity is set on a terminal to the name of the user who logs in.
It is set on a CPU server to the
.I authid
obtained either from NVRAM or by a console prompt.
The initial process created by system initialisation is given the
.I eve
identity.
.PP
.I Iseve
returns true if the current user is
.IR eve .
Several drivers use
.I iseve
to check the caller's identity
before granting permission to perform certain actions.
For example, the console driver allows only the user
.I eve
to write a new identity into the
.B /dev/user
file.
The privileges are strictly local and do not extend into the network
(in particular, to file servers—even ones running on the local machine).
.SH SOURCE
.B /sys/src/9/port/auth.c
.SH SEE ALSO
.IR auth (2),
.IR cap (3),
.IR cons (3),
.IR authsrv (6),
.IR auth (8)