From b2240fc1c08ba82628285458b057b5f795a68a43 Mon Sep 17 00:00:00 2001 From: sheldonh Date: Wed, 1 Mar 2000 14:09:25 +0000 Subject: Remove single-space hard sentence breaks. These degrade the quality of the typeset output, tend to make diffs harder to read and provide bad examples for new-comers to mdoc. --- usr.sbin/yp_mkdb/yp_mkdb.8 | 45 ++++++++++++++++++++++++++++++--------------- 1 file changed, 30 insertions(+), 15 deletions(-) (limited to 'usr.sbin/yp_mkdb') diff --git a/usr.sbin/yp_mkdb/yp_mkdb.8 b/usr.sbin/yp_mkdb/yp_mkdb.8 index fc08d32..599aceb 100644 --- a/usr.sbin/yp_mkdb/yp_mkdb.8 +++ b/usr.sbin/yp_mkdb/yp_mkdb.8 @@ -68,7 +68,8 @@ format (using the hash table method). The input should be in 'key data' format, which is to say two fields of .Tn ASCII -data separated by white space. The first field +data separated by white space. +The first field is assumed to be the key, and everything else is assumed to be the data. These databases are typically stored in @@ -81,7 +82,8 @@ is usually invoked by .Pa /var/yp/Makefile . .Nm Yp_mkdb can also be used to dump an NIS database file so that its -contents can be examined. For security reasons, all databases that +contents can be examined. +For security reasons, all databases that .Nm creates are readable and writable by owner only (and usually the owner is root). @@ -93,9 +95,12 @@ Cause .Nm to send a YPPROC_CLEAR request to .Xr ypserv 8 -on the local host. This signal tells the server to close any open -database descriptors and flush out its database cache. If used alone, -this flag signals the server and does nothing else. If used as part +on the local host. +This signal tells the server to close any open +database descriptors and flush out its database cache. +If used alone, +this flag signals the server and does nothing else. +If used as part of a database creation command, .Nm will send the signal only after the new database has been successfully @@ -105,39 +110,47 @@ Cause .Nm to add a special entry to the database with a key of .Em YP_INTERDOMAIN -and an empty data field. If this key is present in a map, it alters the +and an empty data field. +If this key is present in a map, it alters the behavior of the 'match' procedure in .Xr ypserv 8 -slightly. If a match query fails (because the server couldn't find +slightly. +If a match query fails (because the server couldn't find a record that matched the supplied key), and the .Em YP_INTERDOMAIN key exists within the queried map, .Xr ypserv 8 -will try to match the entry again using a DNS lookup. Note that this +will try to match the entry again using a DNS lookup. +Note that this special behavior only applies to the .Em hosts -maps. Using the +maps. +Using the .Fl b flag for other maps has no effect. .It Fl s This flag is used to add a special entry to the database with a key of .Em YP_SECURE -and an empty data field. If this key is present in a map, +and an empty data field. +If this key is present in a map, .Xr ypserv 8 will deny access to the map to any client that is not using a -reserved port for its query. This is used mainly for the +reserved port for its query. +This is used mainly for the .Em master.passwd maps, which should be restricted to privileged access only. .It Fl f This flag is used to turn on filtering of lines in the source file -input that start with ``+'' or ``-'' characters. These characters +input that start with ``+'' or ``-'' characters. +These characters have special meaning for the .Pa group , .Pa passwd and .Pa master.passwd maps and hence should not be allowed to appear in them as the first -character of a key or datum. If the +character of a key or datum. +If the .Fl f flag is used, .Nm @@ -145,7 +158,8 @@ will reject any source line that starts with a ``+'' or ``-'' character and issue a warning message displaying the line that was dropped. .It Fl u Ar dbname -Dump (or 'unwind') an NIS database. This option can be used to +Dump (or 'unwind') an NIS database. +This option can be used to inspect the contents of an existing NIS database. .It Fl i Ar inputfile When generating an NIS map, encode @@ -168,7 +182,8 @@ When generating an NIS map, encode as a special entry in the database with a key of .Em YP_MASTER_NAME . This entry in the database is frequently used by various NIS utilities -to determine the name of an NIS master server for a domain. By default, +to determine the name of an NIS master server for a domain. +By default, .Nm assumes that the local host is the NIS master; the .Fl m -- cgit v1.1