.\" -*- nroff -*-
.\" Copyright (C) 1998, 1999, 2001, 2002, 2007, 2010 Thorsten Kukuk
.\" This file is part of the yp-tools.
.\" Author: Thorsten Kukuk <kukuk@linux-nis.org>
.\"
.\" This program is free software; you can redistribute it and/or modify
.\" it under the terms of the GNU General Public License version 2 as
.\" published by the Free Software Foundation.
.\"
.\" This program is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with this program; if not, write to the Free Software Foundation,
.\" Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
.\"
.TH ypset 8 "April 2010" "YP Tools 4.2.3"
.SH NAME
ypset - bind ypbind to a particular NIS server
.SH SYNOPSIS
.B ypset
[
.BI \-d " domain"
]
[
.BI \-h " hostname"
]
.I server
.LP
.SH DESCRIPTION
In  order  to run
.BR ypset ,
.B ypbind
must be initiated with the
.B -ypset
or
.B -ypsetme
options.  See
.BR ypbind (8).
.B ypset
tells
.B ypbind
to get NIS services for the specified
.I domain
from the
.BR ypserv (8)
process running on
.IR server.
.LP
In cases where several hosts on the local net are supplying NIS services,
it is possible for
.B ypbind
to rebind to another host even while you attempt to find out if the
.B ypset
operation succeeded. For example, you can type:
.TP 25
.PD 0
.TP
\f3example% ypset host1
.TP
\f3example% ypwhich
.TP
\f3host2
.LP

which can be confusing. This is a function of the NIS subsystem's
attempt to know always a running NIS server, and occurs when host1
does not respond to ypbind because it is not running ypserv (or is
overloaded), and host2, running ypserv, gets the binding.
.LP

.I Server
indicates the NIS server to bind to,  and must be specified as a name
or an IP address. This will work only if the node has a current valid
binding for the domain in question, and
.B ypbind
has been set to allow use of
.BR ypset .
In most  cases,
.I server
should be specified as an IP address.
.LP
.SH OPTIONS
.TP
.BI \-d " domain"
Specify a domain other than the default domain as returned by
.BR domainname (8).
.TP
.BI \-h " hostname"
Set the NIS binding on host
.I hostname
 instead of the local machine.
.SH "SEE ALSO"
.BR domainname (8),
.BR ypbind (8),
.BR ypcat (8),
.BR ypmatch (1),
.BR ypserv (8),
.BR yppoll (8),
.BR ypwhich (1)
.LP
.SH AUTHOR
.B ypset
is part of the
.B yp-tools
package, which was written by Thorsten Kukuk <kukuk@linux-nis.org>.