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

   1 '\" te
   2 .\" Copyright (c) 2004, Sun Microsystems, Inc. All Rights Reserved
   3 .\" 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.
   4 .\" 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.
   5 .\" 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]
   6 .TH GSSD 1M "Apr 25, 2007"
   7 .SH NAME
   8 gssd \- generates and validates GSS-API tokens for kernel RPC
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fB/usr/lib/gss/gssd\fR
  13 .fi
  14
  15 .SH DESCRIPTION
  16 .sp
  17 .LP
  18 \fB\fR\fBgssd\fR is the user mode daemon that operates between the kernel rpc
  19 and the Generic Security Service Application Program Interface (\fBGSS-API\fR)
  20 to generate and validate \fBGSS-API\fR security tokens. In addition, \fBgssd\fR
  21 maps the \fBGSS-API\fR principal names to the local user and group ids. By
  22 default, all groups that the requested user belongs to will be included in the
  23 grouplist credential. \fBgssd\fR is invoked by the Internet daemon
  24 \fBinetd\fR(1m) the first time that the kernel \fBRPC\fR requests \fBGSS-API\fR
  25 services.
  26 .SH EXIT STATUS
  27 .sp
  28 .LP
  29 The following exit values are returned:
  30 .sp
  31 .ne 2
  32 .na
  33 \fB\fB0\fR\fR
  34 .ad
  35 .RS 6n
  36 Successful completion.
  37 .RE
  38
  39 .sp
  40 .ne 2
  41 .na
  42 \fB>\fB0\fR\fR
  43 .ad
  44 .RS 6n
  45 An error occurred.
  46 .RE
  47
  48 .SH ATTRIBUTES
  49 .sp
  50 .LP
  51 See \fBattributes\fR(5) for descriptions of the following attributes:
  52 .sp
  53
  54 .sp
  55 .TS
  56 box;
  57 c | c
  58 l | l .
  59 ATTRIBUTE TYPE  ATTRIBUTE VALUE
  60 _
  61 Interface Stability     Evolving
  62 .TE
  63
  64 .SH SEE ALSO
  65 .sp
  66 .LP
  67 \fBkill\fR(1), \fBpkill\fR(1), \fBsvcs\fR(1), \fBinetadm\fR(1M),
  68 \fBinetd\fR(1M), \fBgsscred\fR(1M), \fBsvcadm\fR(1M), \fBgsscred.conf\fR(4),
  69 \fBresolv.conf\fR(4), \fBattributes\fR(5), \fBsmf\fR(5)
  70 .sp
  71 .LP
  72 \fIRFC 2078\fR
  73 .SH NOTES
  74 .sp
  75 .LP
  76 The following signal has the specified effect when sent to the server process
  77 using the \fBkill\fR(1) command:
  78 .sp
  79 .ne 2
  80 .na
  81 \fB\fBSIGHUP\fR\fR
  82 .ad
  83 .RS 10n
  84 \fBgssd\fR rereads the \fBgsscred.conf\fR(4) options.
  85 .RE
  86
  87 .sp
  88 .LP
  89 When one of the mechanisms being used is Kerberos, then the \fBgssd\fR process
  90 must be restarted after adding or changing the \fBresolv.conf\fR(4) file.
  91 .sp
  92 .LP
  93 The \fBgssd\fR service is managed by the service management facility,
  94 \fBsmf\fR(5), under the service identifier:
  95 .sp
  96 .in +2
  97 .nf
  98 svc:/network/rpc/gss:default
  99 .fi
 100 .in -2
 101 .sp
 102
 103 .sp
 104 .LP
 105 Administrative actions on this service, such as enabling, disabling, or
 106 requesting restart, can be performed using \fBsvcadm\fR(1M). Responsibility for
 107 initiating and restarting this service is delegated to \fBinetd\fR(1M). Use
 108 \fBinetadm\fR(1M) to make configuration changes and to view configuration
 109 information for this service. The service's status can be queried using the
 110 \fBsvcs\fR(1) command.