diff options
| author | Ingo Schwarze <schwarze@cvs.openbsd.org> | 2020-01-25 17:08:35 +0000 |
|---|---|---|
| committer | Ingo Schwarze <schwarze@cvs.openbsd.org> | 2020-01-25 17:08:35 +0000 |
| commit | d4434ff7d8efa8411d99da1adfd7d74288023738 (patch) | |
| tree | 998c91f1ebe94837a0056fffd0159b169120ac77 /share | |
| parent | e5224b115ff55dcbcace9f7bb651e3df3a2cfae7 (diff) | |
add EXAMPLES and polish the wording and the order a bit;
patch from espie@ tweaked by me;
OK espie@, and millert@ agrees with the direction
Diffstat (limited to 'share')
| -rw-r--r-- | share/man/man5/netgroup.5 | 38 |
1 files changed, 23 insertions, 15 deletions
diff --git a/share/man/man5/netgroup.5 b/share/man/man5/netgroup.5 index 0ea9c292667..e36152cde2d 100644 --- a/share/man/man5/netgroup.5 +++ b/share/man/man5/netgroup.5 @@ -1,4 +1,4 @@ -.\" $OpenBSD: netgroup.5,v 1.16 2017/07/13 19:16:33 jmc Exp $ +.\" $OpenBSD: netgroup.5,v 1.17 2020/01/25 17:08:34 schwarze Exp $ .\" $NetBSD: netgroup.5,v 1.3 1995/03/18 14:58:34 cgd Exp $ .\" .\" Copyright (c) 1992, 1993 @@ -30,7 +30,7 @@ .\" .\" @(#)netgroup.5 8.2 (Berkeley) 12/11/93 .\" -.Dd $Mdocdate: July 13 2017 $ +.Dd $Mdocdate: January 25 2020 $ .Dt NETGROUP 5 .Os .Sh NAME @@ -68,17 +68,19 @@ to specify The members of the list may be separated by whitespace; the .Dq \e character may be used at the end of a line to specify line continuation. -The functions specified in +.Pp +Lines that begin with a +.Ql # +are treated as comments. +.Pp +After modification of +.Pa /etc/netgroup , +.Xr netgroup_mkdb 8 +should be run, as the .Xr getnetgrent 3 -should normally be used to access the -.Nm -database. +functions only operate on the Berkeley DB file +.Pa /etc/netgroup.db . .Pp -These functions operate on the Berkeley DB version of the -.Nm -.Pq Pa netgroup.db -file which can be generated using -.Xr netgroup_mkdb 8 . If that file is not present, and the system supports NIS, then the .Nm NIS maps are used. @@ -87,10 +89,6 @@ The NIS maps are also used if the file contains a .Dq + entry. -.Pp -Lines that begin with a -.Ql # -are treated as comments. .Sh FILES .Bl -tag -width /etc/netgroup.db -compact .It Pa /etc/netgroup @@ -98,6 +96,16 @@ default netgroup list .It Pa /etc/netgroup.db netgroup database .El +.Sh EXAMPLES +Define a group of three machines: +.Pp +.Dl friends (10.0.0.2,,) (10.0.0.3,,) (10.0.0.4,,) +.Pp +This group can be used in +.Xr exports 5 +as follows: +.Pp +.Dl /home -maproot=nobody friends .Sh SEE ALSO .Xr dbopen 3 , .Xr getnetgrent 3 , |