blob: 8f949ffee3c13cf618507b05a6089b8a8270637e (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
|
.TH GETUSER 3
.SH NAME
getuser, sysname \- get user or system name
.SH SYNOPSIS
.B #include <u.h>
.br
.B #include <libc.h>
.PP
.B
char* getuser(void)
.PP
.B
char* sysname(void)
.SH DESCRIPTION
.I Getuser
returns a pointer to static data which contains the
null-terminated
name of the user who
owns the current process.
.I Getuser
calls
.MR getuid 2
and then reads
.B /etc/passwd
to find the corresponding name.
.PP
.I Sysname
returns a pointer to static data which contains the name
of the machine on which the current process is running.
.I Sysname
looks first for an environment variable
.BR $sysname .
If there is no such variable,
.I sysname
calls
.MR gethostname 2
and truncates the returned name at the first dot.
If
.I gethostname
fails,
.I sysname
returns the default name
.LR gnot .
.PP
Unlike
.IR getuser ,
.I sysname
caches the string, deriving the host name only once.
.SH SOURCE
.B \*9/src/lib9/getuser.c
.br
.B \*9/src/lib9/sysname.c
|