Date: Tue, 09 Jan 1996 08:47:44 +0100 From: "Philippe Charnier" <charnier@lirmm.fr> To: doc@freebsd.org Subject: NIS/YP Message-ID: <199601090748.IAA03115@lirmm.lirmm.fr>
index | next in thread | raw e-mail
Hi,
You will find enclosed an introduction to NIS that comes with a new
file (nis.sgml) and 3 small patches needed to incorporate this file
into the handbook. Please correct my english. Also note that if you
decide to remove the ``Contributed .. '' do not remove the heading
<p>, compilation will fail if you do.
Have a nice day.
-------- --------
Philippe Charnier charnier@lirmm.fr
LIRMM, 161 rue Ada, 34392 Montpellier cedex 5 -- France
------------------------------------------------------------------------
cvs diff: Diffing .
Index: Makefile
===================================================================
RCS file: /home2h/FreeBSD.cvsroot/src/share/doc/handbook/Makefile,v
retrieving revision 1.7
diff -u -r1.7 Makefile
--- Makefile 1995/12/07 13:22:12 1.7
+++ Makefile 1996/01/06 23:46:42
@@ -6,7 +6,7 @@
SRCS+= firewalls.sgml glossary.sgml goals.sgml
SRCS+= handbook.sgml history.sgml hw.sgml install.sgml kerberos.sgml
SRCS+= kernelconfig.sgml kerneldebug.sgml memoryuse.sgml
-SRCS+= mirrors.sgml nfs.sgml nutshell.sgml
+SRCS+= mirrors.sgml nfs.sgml nis.sgml nutshell.sgml
SRCS+= porting.sgml ports.sgml ppp.sgml printing.sgml relnotes.sgml
SRCS+= routing.sgml scsi.sgml sections.sgml
SRCS+= skey.sgml slipc.sgml slips.sgml submitters.sgml sup.sgml
Index: handbook.sgml
===================================================================
RCS file: /home2h/FreeBSD.cvsroot/src/share/doc/handbook/handbook.sgml,v
retrieving revision 1.38
diff -u -r1.38 handbook.sgml
--- handbook.sgml 1995/12/21 17:16:29 1.38
+++ handbook.sgml 1996/01/07 00:54:55
@@ -121,7 +121,7 @@
&routing;
&nfs;
&diskless;
- <sect><heading>* Yellow Pages/NIS</heading>
+ ⋼
<sect><heading>* ISDN</heading>
<chapt><heading>* Mail</heading>
Index: sections.sgml
===================================================================
RCS file: /home2h/FreeBSD.cvsroot/src/share/doc/handbook/sections.sgml,v
retrieving revision 1.7
diff -u -r1.7 sections.sgml
--- sections.sgml 1995/12/07 13:22:17 1.7
+++ sections.sgml 1996/01/07 00:55:07
@@ -28,6 +28,7 @@
<!ENTITY memoryuse SYSTEM "memoryuse.sgml">
<!ENTITY mirrors SYSTEM "mirrors.sgml">
<!ENTITY nfs SYSTEM "nfs.sgml">
+<!ENTITY nis SYSTEM "nis.sgml">
<!ENTITY nutshell SYSTEM "nutshell.sgml">
<!ENTITY porting SYSTEM "porting.sgml">
<!ENTITY ports SYSTEM "ports.sgml">
===================================================================
--- /dev/null Sat Jan 6 02:05:01 1996
+++ nis.sgml Sun Jan 7 02:07:02 1996
@@ -0,0 +1,49 @@
+<!-- $Id$ -->
+<!-- The FreeBSD Documentation Project -->
+
+<sect><heading>Yellow Pages/NIS<label id="nis"></heading>
+
+<p><em>Contributed by Philippe Charnier <charnier@lirmm.fr>.</em>
+
+The Network Information Service provides a way to distribute certain
+system data files to a set of machines which are connected on the same
+ethernet. A single copy of these files under YP are centrally
+maintained on the YP server, and accessed by clients via the network
+when needed. This permits a system administrator to set up NIS client
+systems with only minimal configuration data and add, remove or modify
+configuration data from a single location. The group of machines
+containing the clients, the <em>master</em> server, and zero or more
+<em>slave</em> servers (where the distributed files are replicated for
+safety and are periodically updated by the master) is called an <em>YP
+domain</em>.<p>
+
+<bf>Note</bf>: on networks with a large number of hosts, it is often a
+good idea to use a master server and several slaves rather than just a
+single master server.<p>
+
+The files that are commonly distributed through the yellow pages are
+<tt>/etc/passwd</tt> and <tt>/etc/group</tt>. When a new user is added
+in these files on the master server, the internal database must be
+updated to take into account the changes. This is done through a
+Makefile in <tt>/var/yp</tt> directory by running <tt>make</tt> in
+that directory. As the changes are not done locally on the clients,
+any request from users are transmitted to the server via the
+<tt>yppasswd</tt> command instead of the <tt>passwd</tt> one.
+
+<bf>Note</bf>: on FreeBSD, the <tt>passwd</tt> command is smart enough
+to call <tt>yppasswd</tt> when needed.<p>
+
+The files <tt>/etc/passwd</tt> and <tt>/etc/group</tt> are special
+cases: they are considered to be local. They are consulted first and
+the YP server is queried for an entry only if they contain a magic
+token `+' as the first character of the line (see <tt>passwd(5)</tt>
+for more information about YP/NIS interaction).<p>
+
+Some others files are directly queried from NIS database, ignoring
+local copies. Have a look at <tt>/var/yp/Makefile</tt> for
+examples.<p>
+
+NIS master, slaves and clients are enabled on startup when
+<tt>/etc/rc</tt> is run. Configuration is set according to the flags
+you define by editing <tt>/etc/sysconfig</tt>.
+
help
Want to link to this message? Use this
URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?199601090748.IAA03115>