usr/src/man/man1m/ypmake.1m

   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 1M "Aug 17, 2006"
   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
  15
  16 .SH DESCRIPTION
  17 .sp
  18 .LP
  19 The file called \fBMakefile\fR in \fB/var/yp\fR is used by \fBmake\fR(1S) to
  20 build the  Network Information Service (\fBNIS\fR) database. With no arguments,
  21 \fBmake\fR creates \fBdbm\fR databases for any \fBNIS\fR maps that are
  22 out-of-date, and then executes \fByppush\fR(1M) to notify slave databases that
  23 there has been a change.
  24 .sp
  25 .LP
  26 If you supply a \fImap\fR on the command line, \fBmake\fR will update that map
  27 only. Typing \fBmake passwd\fR will create and \fByppush\fR the password
  28 database (assuming it is out of date). Likewise, \fBmake ipnodes\fR and \fBmake
  29 networks\fR will create and \fByppush\fR the \fBipnodes\fR and \fBnetwork\fR
  30 files, \fB$(INETDIR)/ipnodes\fR and \fB$(DIR)/networks\fR.
  31 .sp
  32 .LP
  33 There are four special variables used by \fBmake\fR: \fBDIR\fR, which gives the
  34 directory of the source files; \fBNOPUSH\fR, which when non-null inhibits doing
  35 a \fByppush\fR of the new database files; \fBINETDIR\fR, which gives the
  36 directory of the \fBipnodes\fR source file; and \fBDOM\fR, which is used to
  37 construct a domain other than the master's default domain. The default for
  38 \fBDIR\fR is \fB/etc\fR, and the default for \fBINETDIR\fR is \fB/etc/inet\fR.
  39 The default for \fBNOPUSH\fR is the null string.
  40 .sp
  41 .LP
  42 Refer to \fBypfiles\fR(4) and \fBypserv\fR(1M) for an overview of the
  43 \fBNIS\fR service.
  44 .sp
  45 .LP
  46 If a \fBNIS\fR to LDAP (N2L) configuration file, \fB/var/yp/NISLDAPmapping\fR,
  47 is present, the \fBNIS\fR server components run in N2L mode. In N2L mode, the
  48 server components use a new set of map files with an LDAP-prefix, based on the
  49 LDAP DIT. In N2L mode, authoritative NIS information is obtained from the DIT.
  50 The NIS source files and \fBypmake\fR have no role, and they should not be
  51 used. If \fBypmake\fR is accidentally run, then the server components will
  52 detect this, and will log a warning message. For additional information, see
  53 \fBypfiles\fR(4).
  54 .SH FILES
  55 .sp
  56 .ne 2
  57 .na
  58 \fB\fB/var/yp\fR\fR
  59 .ad
  60 .RS 19n
  61 Directory containing  \fBNIS\fR configuration files.
  62 .RE
  63
  64 .sp
  65 .ne 2
  66 .na
  67 \fB\fB/etc/inet/hosts\fR\fR
  68 .ad
  69 .RS 19n
  70 System hosts file.
  71 .RE
  72
  73 .sp
  74 .ne 2
  75 .na
  76 \fB\fB/etc\fR\fR
  77 .ad
  78 .RS 19n
  79 Default directory for source files.
  80 .RE
  81
  82 .SH ATTRIBUTES
  83 .sp
  84 .LP
  85 See \fBattributes\fR(5)  for descriptions of the following attributes:
  86 .sp
  87
  88 .sp
  89 .TS
  90 box;
  91 c | c
  92 l | l .
  93 ATTRIBUTE TYPE  ATTRIBUTE VALUE
  94 _
  95 Interface Stability     Evolving
  96 .TE
  97
  98 .SH SEE ALSO
  99 .sp
 100 .LP
 101 \fBmake\fR(1S), \fBnis+\fR(1), \fBmakedbm\fR(1M), \fBrpc.nisd\fR(1M),
 102 \fBypbind\fR(1M), \fByppush\fR(1M), \fBypserv\fR(1M), \fBypclnt\fR(3NSL),
 103 \fBNISLDAPmapping\fR(4), \fBypfiles\fR(4), \fBypserv\fR(4)
 104 .SH NOTES
 105 .sp
 106 .LP
 107 The  \fBNIS\fR makefile is only used when running the  \fBypserv\fR(1M) server
 108 to provide  \fBNIS\fR services. If these are being provided by the  \fBNIS+\fR
 109 server running in \fBNIS\fR compatibility mode, see  \fBrpc.nisd\fR(1M); this
 110 makefile is not relevant.  See  \fBypfiles\fR(4) for more details.
 111 .sp
 112 .LP
 113 The Network Information Service (\fBNIS\fR) was formerly known as Sun Yellow
 114 Pages (\fBYP\fR).  The functionality of the two remains the same. Only the name
 115 has changed. The name Yellow Pages is a registered trademark in the United
 116 Kingdom of British Telecommunications plc, and may not be used without
 117 permission.