1 '\" te
   2 .\" Copyright (C) 2003, 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 FTPGROUPS 4 "May 1, 2003"
   7 .SH NAME
   8 ftpgroups \- FTP Server enhanced group access file
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fB/etc/ftpd/ftpgroups\fR
  13 .fi
  14 
  15 .SH DESCRIPTION
  16 .sp
  17 .LP
  18 The \fBftpgroups\fR file contains the enhanced group access information.
  19 .sp
  20 .LP
  21 After login, if the \fBftpaccess\fR(4) file includes \fIprivate\fR \fIyes\fR,
  22 the user may use the \fBSITE GROUP\fR and \fBSITE GPASS\fR commands to specify
  23 an enhanced access group and a password for that group. If the access group
  24 name and password are valid, the FTP Server executes \fBsetuid\fR(2) to make
  25 the user a member of the real group listed in the \fBftpgroups\fR file.
  26 .sp
  27 .LP
  28 The format for the \fBftpgroups\fR file is:
  29 .sp
  30 .in +2
  31 .nf
  32 accessgroup:encrypted_password:real_group_name
  33 .fi
  34 .in -2
  35 
  36 .sp
  37 .LP
  38 The fields are defined as follows:
  39 .sp
  40 .ne 2
  41 .na
  42 \fB\fIaccessgroup\fR\fR
  43 .ad
  44 .RS 22n
  45 An arbitrary string of alphanumeric and punctuation characters.
  46 .RE
  47 
  48 .sp
  49 .ne 2
  50 .na
  51 \fB\fIencrypted_password\fR\fR
  52 .ad
  53 .RS 22n
  54 The group password encrypted exactly like in \fB/etc/shadow\fR.
  55 .RE
  56 
  57 .sp
  58 .ne 2
  59 .na
  60 \fB\fIreal_group_name\fR\fR
  61 .ad
  62 .RS 22n
  63 The name of a valid group returned by \fBgetgrnam\fR(3C).
  64 .RE
  65 
  66 .sp
  67 .LP
  68 The \fBprivatepw\fR utility is an administrative tool to add, delete and list
  69 enhanced access group information in the \fBftpgroups\fR file. See
  70 \fBprivatepw\fR(1M). Lines that begin with a \fB#\fR sign are treated as
  71 comment lines and are ignored.
  72 .SH FILES
  73 .sp
  74 .ne 2
  75 .na
  76 \fB\fB/etc/ftpd/ftpgroups\fR\fR
  77 .ad
  78 .RS 23n
  79 
  80 .RE
  81 
  82 .sp
  83 .ne 2
  84 .na
  85 \fB\fB/etc/ftpd/ftpaccess\fR\fR
  86 .ad
  87 .RS 23n
  88 
  89 .RE
  90 
  91 .SH ATTRIBUTES
  92 .sp
  93 .LP
  94 See \fBattributes\fR(5) for descriptions of the following attributes:
  95 .sp
  96 
  97 .sp
  98 .TS
  99 box;
 100 c | c
 101 l | l .
 102 ATTRIBUTE TYPE  ATTRIBUTE VALUE
 103 _
 104 Interface Stability     External
 105 .TE
 106 
 107 .SH SEE ALSO
 108 .sp
 109 .LP
 110 \fBin.ftpd\fR(1M), \fBprivatepw\fR(1M), \fBsetuid\fR(2), \fBgetgrnam\fR(3C),
 111 \fBftpaccess\fR(4), \fBgroup\fR(4), \fBshadow\fR(4), \fBattributes\fR(5)