Hallo, dies ist ein Test.

PWD: /www/data-lst1/unixsoft/unixsoft/kaempfer/.public_html

Running in File Mode
Relative path: ././../../../../../../usr/man/man8/nscfg.8
Real path: /usr/share/man/man8/nscfg.8
Zurück

'\" te
.\" Copyright (c) 2012, 2023, Oracle and/or its affiliates.
.TH nscfg 8 "15 Feb 2023" "Oracle Solaris 11.4" "System Administration Commands"
.SH NAME
nscfg \- import, export name service configurations
.SH SYNOPSIS

.LP
.nf
\fB/usr/sbin/nscfg\fR \fIcommand\fR [\fIcmd_options\fR] [\fIoperands\fR]
.fi

.LP
.nf
\fB/usr/sbin/nscfg\fR import [\fB-fnvq\fR] \fIFMRI\fR]
.fi

.LP
.nf
\fB/usr/sbin/nscfg\fR export [\fB-nvq\fR] \fIFMRI\fR]
.fi

.LP
.nf
\fB/usr/sbin/nscfg\fR unconfig [\fB-nvq\fR] \fIFMRI\fR]
.fi

.LP
.nf
\fB/usr/sbin/nscfg\fR validate [\fB-vq\fR] \fIFMRI\fR]
.fi

.LP
.nf
\fB/usr/sbin/nscfg\fR adldap [\fB-nvqu\fR]
.fi

.LP
.nf
\fB/usr/sbin/nscfg\fR help
.fi
.SH DESCRIPTION
.sp
.LP
The \fBnscfg\fR utility imports or exports legacy name service configuration files into or out of the SMF repository. Given a valid SMF configuration and corresponding FMRI, \fBnscfg\fR will regenerate the legacy naming service configuration files, such as \fBnsswitch.conf\fR, \fBresolv.conf\fR, \fBnscd.conf\fR, and so forth, into their legacy locations. Alternatively, \fBnscfg\fR can import those same configuration files populating the SMF repository if it is currently unpopulated.
.sp
.LP
The following are SMF services that can be operands to \fBnscfg\fR. In many instances, the legacy configuration file that is replaced by the SMF service is listed.
.sp
.ne 2
.mk
.na
\fB\fBsvc:/system/name-service/switch:default\fR\fR
.ad
.br
.sp .6
.RS 4n
Legacy file: \fB/etc/nsswitch.conf\fR
.sp
Name service switch configuration (used by \fBnscd\fR).
.RE

.sp
.ne 2
.mk
.na
\fB\fBsvc:/system/name-service/cache:default\fR\fR
.ad
.br
.sp .6
.RS 4n
Legacy file: \fB/etc/nscd.conf\fR
.sp
Name service cache (\fBnscd\fR).
.RE

.sp
.ne 2
.mk
.na
\fB\fBsvc:/network/dns/client:default\fR\fR
.ad
.br
.sp .6
.RS 4n
Legacy file: \fB/etc/resolv.conf\fR
.sp
DNS naming service.
.RE

.sp
.ne 2
.mk
.na
\fB\fBsvc:/network/nis/domain:default\fR\fR
.ad
.br
.sp .6
.RS 4n
Legacy file: \fB/etc/defaultdomain\fR
.sp
Legacy file: \fB/var/yp/binding/$DOMAIN/*\fR
.sp
Shared NIS domain configuration. Used by all NIS services. Also (historical) shared use with LDAP naming services. Must be enabled when using \fBnis/client\fR or \fBldap/client\fR.
.RE

.sp
.ne 2
.mk
.na
\fB\fBsvc:/network/nis/client:default\fR\fR
.ad
.br
.sp .6
.RS 4n
NIS client naming service (\fBypbind\fR and related)
.RE

.sp
.ne 2
.mk
.na
\fB\fBsvc:/network/ldap/client:default\fR\fR
.ad
.br
.sp .6
.RS 4n
Legacy file: \fB/var/ldap/*\fR
.sp
LDAP client naming service (\fBldap_cachemgr\fR and related).
.RE

.sp
.ne 2
.mk
.na
\fB\fBsvc:/network/nis/server:default\fR\fR
.ad
.br
.sp .6
.RS 4n
NIS server service (\fBypserv\fR).
.RE

.sp
.ne 2
.mk
.na
\fB\fBsvc:/network/nis/passwd:default\fR\fR
.ad
.br
.sp .6
.RS 4n
NIS server \fBpasswd\fR service (\fBrpc.yppasswd\fR).
.RE

.sp
.ne 2
.mk
.na
\fB\fBsvc:/network/nis/xfr:default\fR\fR
.ad
.br
.sp .6
.RS 4n
NIS server \fBxfr\fR service (\fBypxfrd\fR)
.RE

.sp
.ne 2
.mk
.na
\fB\fBsvc:/network/nis/update:default\fR\fR
.ad
.br
.sp .6
.RS 4n
NIS server update service (\fBrpc.ypupdated\fR)
.RE

.SH SUB-COMMANDS
.sp
.LP
The \fBnscfg\fR utility supports the subcommands described below. Options are described in the context of the subcommands.
.sp
.ne 2
.mk
.na
\fB\fBimport\fR [\fB-fvq\fR] \fIFMRI\fR\fR
.ad
.br
.sp .6
.RS 4n
If none of the SMF repository properties for the specified FMRI are currently populated, import the legacy configuration files associated with the specified FMRI into the SMF repository.
.sp
With \fB-f\fR, force the repopulation of the SMF repository with the legacy configuration, even if currently populated.
.sp
With \fB-v\fR, issue verbose progress messages during the requested operation. With \fB-q\fR, issue no error or other messages during the requested operation.
.RE

.sp
.ne 2
.mk
.na
\fB\fBexport\fR [\fB-vq\fR] \fIFMRI\fR\fR
.ad
.br
.sp .6
.RS 4n
Export the SMF configuration for the specified FMRI to legacy configuration files. This operation removes any existing affected legacy file(s) and generates new one(s) using the SMF configuration.
.RE

.sp
.ne 2
.mk
.na
\fB\fBunconfig\fR [\fB-vq\fR] \fIFMRI\fR\fR
.ad
.br
.sp .6
.RS 4n
Unconfigure the SMF configuration for the specified FMRI. This operation resets the specified FMRI and any existing legacy file(s) to their initial unconfigured state.
.sp
With \fB-v\fR, issue verbose progress messages during the requested operation. With \fB-q\fR, issue no error or other messages during the requested operation.
.RE

.sp
.ne 2
.mk
.na
\fB\fBvalidate\fR [\fB-vq\fR] \fIFMRI\fR\fR
.ad
.br
.sp .6
.RS 4n
Validate the SMF configuration for the specified FMRI. This operation checks the current configuration and verifies whether any errors exist.
.sp
With \fB-v\fR, issue verbose progress messages during the requested operation. With \fB-q\fR, issue no error or other messages during the requested operation.
.RE

.sp
.ne 2
.mk
.na
\fB\fBadldap\fR [\fB-nvqu\fR]\fR
.ad
.br
.sp .6
.RS 4n
Configure LDAP naming services using the domain configuration supplied by the \fBsmbadm join\fR command. This option requires the previous configuration of the system to use Kerberos and an Active Directory domain prior to executing this operation. If the system is not properly configured using the \fBsmbadm\fR then an error will be issued and this operation will not proceed with LDAP naming services configuration.
.sp
Using the active Domain configuration, this operation inspects the Active Directory LDAP server to verify the required LDAP schema that can support users and groups for Solaris. Then if all pre-requisites are met, this operation will configure the system into LDAP "manual mode" with "proxy" authentication using sasl/GSSAPI (Kerberos) credentials to the LDAP server and the Kerberos host principal is used as the credential that connects to the AD LDAP server.
.sp
The configuration will include "service search descriptors" and proper configuration for both the user password and group databases. The SMF service configuration for the LDAP service \fBsvc:/network/ldap/client:default\fR will be updated and that service will automatically be started.
.sp
Additionally the name service/switch configuration \fBsvc:/system/name-service/switch:default\fR will be updated and both the name service switch service and the name service cache service \fBsvc:/system/name-service/cache:default\fR will automatically be restarted.
.sp
With \fB-v\fR, issue verbose progress messages during the requested operation. With \fB-q\fR, issue no error or other messages during the requested operation. With \fB-n\fR, perform all the AD LDAP server inspection and pre-requisite checks, but do not change the configuration. Exit after the checks are performed.
.sp
With \fB-u\fR, unconfigure the LDAP client service \fBsvc:/network/ldap/client:default\fR, unconfigure LDAP from the name switch service \fBsvc:/system/name-service/switch:default\fR and restore the all the switch databases except the host database back to "files only".
.RE

.SH EXAMPLES
.LP
\fBExample 1\fR Importing DNS Client Configuration

.sp
.LP
The following command imports the DNS client configuration, stored in \fBresolv.conf\fR, into the SMF repository.

.sp
.in +2
.nf
# \fBnscfg import svc:/network/dns/client:default\fR
.fi
.in -2
.sp
.LP
\fBExample 2\fR Exporting SMF LDAP Client Configuration

.sp
.LP
The following command exports the SMF LDAP client configuration to the legacy configuration files in \fB/var/ldap\fR.

.sp
.in +2
.nf
# \fBnscfg export svc:/network/ldap/client:default\fR
.fi
.in -2
.sp
.LP
\fBExample 3\fR Resetting Name Service Switch Configuration

.sp
.LP
The following command resets the name service switch configuration to its initial unconfigured state. The command generates no output and exits quietly with status only.

.sp
.in +2
.nf
# \fBnscfg unconfig -q svc:/system/name-service/switch:default\fR
.fi
.in -2
.sp
.LP
\fBExample 4\fR Validating LDAP Client Configuration

.sp
.LP
The following command validates the LDAP client configuration for errors or inconsistencies. The command generates no output and exits quietly with status only.

.sp
.in +2
.nf
# \fBnscfg validate -q svc:/network/ldap/client:default\fR
.fi
.in -2
.sp
.SH EXIT STATUS
.sp
.ne 2
.mk
.na
\fB\fB0\fR\fR
.ad
.br
.sp .6
.RS 4n
Command successfully executed.
.RE

.sp
.ne 2
.mk
.na
\fB\fB1\fR\fR
.ad
.br
.sp .6
.RS 4n
An error occurred.
.RE

.sp
.ne 2
.mk
.na
\fB\fB2\fR\fR
.ad
.br
.sp .6
.RS 4n
Configuration unmodified, no change necessary.
.RE

.sp
.ne 2
.mk
.na
\fB\fB3\fR\fR
.ad
.br
.sp .6
.RS 4n
No configuration to import.
.RE

.SH FILES
.RS +4
.TP
.ie t \(bu
.el o
\fB/etc/default/{nss, yppasswd}\fR

.RE
.RS +4
.TP
.ie t \(bu
.el o
\fB/etc/defaultdomain\fR

.RE
.RS +4
.TP
.ie t \(bu
.el o
\fB/etc/nscd.conf\fR

.RE
.RS +4
.TP
.ie t \(bu
.el o
\fB/etc/nsswitch.conf\fR

.RE
.RS +4
.TP
.ie t \(bu
.el o
\fB/etc/resolv.conf\fR

.RE
.RS +4
.TP
.ie t \(bu
.el o
\fB/var/ldap/ldap_client_cred\fR

.RE
.RS +4
.TP
.ie t \(bu
.el o
\fB/var/ldap/ldap_client_file\fR

.RE
.RS +4
.TP
.ie t \(bu
.el o
\fB/var/yp/binding/{\fInisdomainname\fR}/ypservers\fR

.RE
.RS +4
.TP
.ie t \(bu
.el o
\fB/var/yp/NISLDAPmapping\fR

.RE
.RS +4
.TP
.ie t \(bu
.el o
\fB/var/yp/securenets\fR

.RE
.RS +4
.TP
.ie t \(bu
.el o
\fB/var/yp/updaters\fR

.RE
.SH ATTRIBUTES
.sp
.LP
See \fBattributes\fR(7) for descriptions of the following attributes:
.sp
.TS
tab(
) box;
cw(2.75i) |cw(2.75i) 
lw(2.75i) |lw(2.75i) 
.
ATTRIBUTE TYPE
ATTRIBUTE VALUE
_
Availability
system/core-os
_
Interface Stability
Uncommitted
.TE
.sp
.SH SEE ALSO
.sp
.LP
\fBsvcs\fR(1), \fBdefaultdomain\fR(5), \fBnsswitch.conf\fR(5), \fBresolv.conf\fR(5), \fBypfiles\fR(5), \fBattributes\fR(7), \fBldapclient\fR(8), \fBnscd\fR(8), \fBsvcadm\fR(8), \fBsvccfg\fR(8), \fBypinit\fR(8)