Merge commit 'c5bab7026b8e0ac44b25ee08507ea360f177d844' into merges
[unleashed.git] / share / man / man8 / ypmake.8
blob24a80b05b8178d0ce9926232749b3a83c5728271
1 '\" te
2 .\" Copyright (C) 2003, Sun Microsystems, Inc. All Rights Reserved
3 .\" Copyright 1989 AT&T
4 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
5 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
6 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
7 .TH YPMAKE 8 "Feb 25, 2017"
8 .SH NAME
9 ypmake \- rebuild NIS database
10 .SH SYNOPSIS
11 .LP
12 .nf
13 \fBcd\fR \fB/var/yp\fR ; \fBmake\fR [\fImap\fR]
14 .fi
16 .SH DESCRIPTION
17 .LP
18 The file called \fBMakefile\fR in \fB/var/yp\fR is used by \fBmake\fR(1S) to
19 build the  Network Information Service (\fBNIS\fR) database. With no arguments,
20 \fBmake\fR creates \fBdbm\fR databases for any \fBNIS\fR maps that are
21 out-of-date, and then executes \fByppush\fR(8) to notify slave databases that
22 there has been a change.
23 .sp
24 .LP
25 If you supply a \fImap\fR on the command line, \fBmake\fR will update that map
26 only. Typing \fBmake passwd\fR will create and \fByppush\fR the password
27 database (assuming it is out of date). Likewise, \fBmake ipnodes\fR and \fBmake
28 networks\fR will create and \fByppush\fR the \fBipnodes\fR and \fBnetwork\fR
29 files, \fB$(INETDIR)/ipnodes\fR and \fB$(DIR)/networks\fR.
30 .sp
31 .LP
32 There are four special variables used by \fBmake\fR: \fBDIR\fR, which gives the
33 directory of the source files; \fBNOPUSH\fR, which when non-null inhibits doing
34 a \fByppush\fR of the new database files; \fBINETDIR\fR, which gives the
35 directory of the \fBipnodes\fR source file; and \fBDOM\fR, which is used to
36 construct a domain other than the master's default domain. The default for
37 \fBDIR\fR is \fB/etc\fR, and the default for \fBINETDIR\fR is \fB/etc/inet\fR.
38 The default for \fBNOPUSH\fR is the null string.
39 .sp
40 .LP
41 Refer to \fBypfiles\fR(4) and \fBypserv\fR(8) for an overview of the
42 \fBNIS\fR service.
43 .sp
44 .LP
45 If a \fBNIS\fR to LDAP (N2L) configuration file, \fB/var/yp/NISLDAPmapping\fR,
46 is present, the \fBNIS\fR server components run in N2L mode. In N2L mode, the
47 server components use a new set of map files with an LDAP-prefix, based on the
48 LDAP DIT. In N2L mode, authoritative NIS information is obtained from the DIT.
49 The NIS source files and \fBypmake\fR have no role, and they should not be
50 used. If \fBypmake\fR is accidentally run, then the server components will
51 detect this, and will log a warning message. For additional information, see
52 \fBypfiles\fR(4).
53 .SH FILES
54 .ne 2
55 .na
56 \fB\fB/var/yp\fR\fR
57 .ad
58 .RS 19n
59 Directory containing  \fBNIS\fR configuration files.
60 .RE
62 .sp
63 .ne 2
64 .na
65 \fB\fB/etc/inet/hosts\fR\fR
66 .ad
67 .RS 19n
68 System hosts file.
69 .RE
71 .sp
72 .ne 2
73 .na
74 \fB\fB/etc\fR\fR
75 .ad
76 .RS 19n
77 Default directory for source files.
78 .RE
80 .SH ATTRIBUTES
81 .LP
82 See \fBattributes\fR(5)  for descriptions of the following attributes:
83 .sp
85 .sp
86 .TS
87 box;
88 c | c
89 l | l .
90 ATTRIBUTE TYPE  ATTRIBUTE VALUE
92 Interface Stability     Evolving
93 .TE
95 .SH SEE ALSO
96 .LP
97 \fBmake\fR(1S), \fBmakedbm\fR(8),
98 \fBypbind\fR(8), \fByppush\fR(8), \fBypserv\fR(8), \fBypclnt\fR(3NSL),
99 \fBNISLDAPmapping\fR(4), \fBypfiles\fR(4), \fBypserv\fR(4)
100 .SH NOTES
102 The Network Information Service (\fBNIS\fR) was formerly known as Sun Yellow
103 Pages (\fBYP\fR).  The functionality of the two remains the same. Only the name
104 has changed. The name Yellow Pages is a registered trademark in the United
105 Kingdom of British Telecommunications plc, and may not be used without
106 permission.