2947 prelim manpage changes, packaging manifests

*** 1,26 ****
  '\" te
  .\" Copyright (C) 2006, Sun Microsystems, Inc. All Rights Reserved.
  .\" 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.
  .\" 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.
  .\" 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]
! .TH PAM.CONF 4 "Jun 19, 2006"
  .SH NAME
! pam.conf \- configuration file for pluggable authentication modules
  .SH SYNOPSIS
  .LP
  .nf
  \fB/etc/pam.conf\fR
  .fi
  
  .SH DESCRIPTION
  .sp
  .LP
! \fBpam.conf\fR is the configuration file for the Pluggable Authentication
  Module architecture, or \fBPAM\fR. A \fBPAM\fR module provides functionality
  for one or more of four possible services: authentication, account management,
! session management, and password management.
  .sp
  .ne 2
  .na
  \fBauthentication service module\fR
  .ad
--- 1,32 ----
  '\" te
  .\" Copyright (C) 2006, Sun Microsystems, Inc. All Rights Reserved.
+ .\" Copyright 2012 Joshua M. Clulow <josh@sysmgr.org>
  .\" 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.
  .\" 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.
  .\" 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]
! .TH PAM.CONF 4 "Jun 30, 2012"
  .SH NAME
! pam.d, pam.conf \- configuration for pluggable authentication modules
  .SH SYNOPSIS
  .LP
  .nf
+ \fB/etc/pam.d\fR
+ .fi
+ .nf
  \fB/etc/pam.conf\fR
  .fi
  
  .SH DESCRIPTION
  .sp
  .LP
! 
! \fB/etc/pam.d\fR is the configuration directory for the Pluggable Authentication
  Module architecture, or \fBPAM\fR.  A \fBPAM\fR module provides functionality
  for one or more of four possible services: authentication, account management,
! session management, and password management.  The configuration directory
! contains per-service 'shards' of the legacy, monolithic \fBpam.conf\fR file.
  .sp
  .ne 2
  .na
  \fBauthentication service module\fR
  .ad
*** 80,89 ****
--- 86,103 ----
  .in -2
  .sp
  
  .sp
  .LP
+ If shard files are used in \fB/etc/pam.d\fR instead of the monolithic
+ \fBpam.conf\fR file, then the \fIservice_name\fR column is not present in
+ those files.  The \fIservice_name\fR is, instead, derived from the
+ filename of the shard.  As an example, for the service 'login' the configuration
+ would now be in \fB/etc/pam.d/login\fR and would omit the first column
+ (previously containing 'login').
+ .sp
+ .LP
  The following is an example of a \fBpam.conf\fR configuration file with support
  for authentication, account management, session management and password
  management modules (See the \fBpam.conf\fR file that is shipped with your
  system for the contents of this file):
  .sp
*** 130,142 ****
  .sp
  .LP
  The \fImodule_path\fR field specifies the relative pathname to a shared library
  object, or an included \fBPAM\fR configuration file, which implements the
  service functionality. If the pathname is not absolute, shared library objects
! are assumed to be relative to \fB/usr/lib/security/$ISA/\fR, and included
! \fBPAM\fR configuration files are assumed to be relative to
! \fB/usr/lib/security/\fR.
  .sp
  .LP
  The \fBISA\fR token is replaced by an implementation defined directory name
  which defines the path relative to the calling program's instruction set
  architecture.
--- 144,157 ----
  .sp
  .LP
  The \fImodule_path\fR field specifies the relative pathname to a shared library
  object, or an included \fBPAM\fR configuration file, which implements the
  service functionality. If the pathname is not absolute, shared library objects
! are assumed to be relative to \fB/usr/lib/security/$ISA/\fR, and \fBPAM\fR
! configuration files included in shards are assumed to be relative to
! \fB/etc/pam.d/\fR, or \fB/usr/lib/security/\fB if included in the legacy
! \fBpam.conf\fR.
  .sp
  .LP
  The \fBISA\fR token is replaced by an implementation defined directory name
  which defines the path relative to the calling program's instruction set
  architecture.
*** 343,352 ****
--- 358,376 ----
  .ad
  .RS 29n
  Configuration file
  .RE
  
+ .sp
+ .ne 2
+ .na
+ \fB\fB/etc/pam.d\fR\fR
+ .ad
+ .RS 29n
+ Configuration directory
+ .RE
+ 
  .sp
  .ne 2
  .na
  \fB\fB/usr/lib/$ISA/libpam.so.1\fR\fR
  .ad