xref: /csrg-svn/sbin/mountd/netgroup.5 (revision 65101)
161519Sbostic.\" Copyright (c) 1992, 1993
261519Sbostic.\"	The Regents of the University of California.  All rights reserved.
353169Smckusick.\"
453169Smckusick.\" %sccs.include.redist.roff%
553169Smckusick.\"
6*65101Smckusick.\"     @(#)netgroup.5	8.2 (Berkeley) 12/11/93
753169Smckusick.\"
853169Smckusick.Dd
953169Smckusick.Dt NETGROUP 5
1053169Smckusick.Os
1153169Smckusick.Sh NAME
1253169Smckusick.Nm netgroup
1353169Smckusick.Nd defines network groups
1453169Smckusick.Sh SYNOPSIS
1553169Smckusick.Nm netgroup
1653169Smckusick.Sh DESCRIPTION
1753169SmckusickThe
1853169Smckusick.Nm netgroup
1953169Smckusickfile
2053169Smckusickspecifies ``netgroups'', which are sets of
2153169Smckusick.Sy (host, user, domain)
2253169Smckusicktuples that are to be given similar network access.
2353169Smckusick.Pp
2453169SmckusickEach line in the file
2553169Smckusickconsists of a netgroup name followed by a list of the members of the
2653169Smckusicknetgroup.
2753169SmckusickEach member can be either the name of another netgroup or a specification
2853169Smckusickof a tuple as follows:
2953169Smckusick.Bd -literal -offset indent
3053169Smckusick(host, user, domain)
3153169Smckusick.Ed
3253169Smckusickwhere the
3353169Smckusick.Sy host ,
3453169Smckusick.Sy user ,
3553169Smckusickand
3653169Smckusick.Sy domain
3753169Smckusickare character string names for the corresponding component.
3853169SmckusickAny of the comma separated fields may be empty to specify a ``wildcard'' value
3953169Smckusickor may consist of the string ``-'' to specify ``no valid value''.
4053169SmckusickThe members of the list may be separated by whitespace and/or commas;
4153169Smckusickthe ``\e'' character may be used at the end of a line to specify
4253169Smckusickline continuation.
4353169SmckusickThe functions specified in
4453169Smckusick.Xr getnetgrent 3
4553169Smckusickshould normally be used to access the
4653169Smckusick.Nm netgroup
4753169Smckusickdatabase.
4853169Smckusick.Pp
4953169SmckusickLines that begin with a # are treated as comments.
5053169Smckusick.Sh FILES
5153169Smckusick.Bl -tag -width /etc/netgroup -compact
5253169Smckusick.It Pa /etc/netgroup
5353169Smckusickthe netgroup database.
5453169Smckusick.El
5553169Smckusick.Sh SEE ALSO
5653169Smckusick.Xr getnetgrent 3 ,
5753169Smckusick.Xr exports 5
5853169Smckusick.Sh COMPATIBILITY
5953169SmckusickThe file format is compatible with that of various vendors, however it
6053169Smckusickappears that not all vendors use an identical format.
6153169Smckusick.Sh BUGS
62*65101SmckusickThe interpretation of access restrictions based on the member tuples of a
6353169Smckusicknetgroup is left up to the various network applications.
6453169SmckusickAlso, it is not obvious how the domain specification
6553169Smckusickapplies to the BSD environment.
66