blob: afbf67412bfe03318ba9bffa1c9e2e9208b22820 (
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
|
.TH GETSHARES 3 SHARE
.SH NAME
getshares \- get shares file entry given uid
.SH SYNOPSIS
.B "#include <shares.h>"
.br
.sp
.B "unsigned long getshares(lp, uid, lock)"
.br
.B "struct lnode * lp;"
.br
.B "int uid;"
.br
.B "int lock;"
.SH DESCRIPTION
.I Getshares
finds the shares entry with the same uid as
.I uid
and reads it into an area pointed to by
.IR lp .
.I lock
should be non-zero if the shares data-base should be opened for writing.
Returns zero if no entry exists,
(in which case all
.RI non- uid
fields of
.I *lp
will have been cleared),
or the ``last used'' time of the entry.
.I lp\->l_uid
will always have been set to
.I uid
on return.
.SH "SEE ALSO"
closeshares(3),
getshput(3),
openshares(3),
putshares(3),
sharesfile(3).
.SH DIAGNOSTICS
.I Getshares
returns 0
if entry can't be found, or on error.
|