share/man/man4/shells.4

   1 '\" te
   2 .\" Copyright (c) 2007 Sun Microsystems, Inc. All Rights Reserved.
   3 .\" Portions Copyright (c) 1982-2007 AT&T Knowledge Ventures
   4 .\" 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.
   5 .\" 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.
   6 .\" 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]
   7 .TH SHELLS 4 "Nov 20, 2007"
   8 .SH NAME
   9 shells \- shell database
  10 .SH SYNOPSIS
  11 .LP
  12 .nf
  13 \fB/etc/shells\fR
  14 .fi
  15
  16 .SH DESCRIPTION
  17 .sp
  18 .LP
  19 The \fBshells\fR file contains a list of the shells on the system. Applications
  20 use this file to determine whether a shell is valid. See
  21 \fBgetusershell\fR(3C). For each shell a single line should be present,
  22 consisting of the shell's path, relative to root.
  23 .sp
  24 .LP
  25 A hash mark (\fB#\fR) indicates the beginning of a comment; subsequent
  26 characters up to the end of the line are not interpreted by the routines which
  27 search the file. Blank lines are also ignored.
  28 .sp
  29 .LP
  30 The following default shells are used by utilities: \fB/bin/bash\fR,
  31 \fB/bin/csh\fR, \fB/bin/jsh\fR, \fB/bin/ksh\fR, \fB/bin/ksh93\fR,
  32 \fB/bin/pfcsh\fR, \fB/bin/pfksh\fR, \fB/bin/pfsh\fR, \fB/bin/sh\fR,
  33 \fB/bin/tcsh\fR, \fB/bin/zsh\fR, \fB/sbin/jsh\fR, \fB/sbin/sh\fR,
  34 \fB/usr/bin/bash\fR, \fB/usr/bin/csh\fR, \fB/usr/bin/jsh\fR,
  35 \fB/usr/bin/ksh\fR, \fB/usr/bin/ksh93\fR, \fB/usr/bin/pfcsh\fR,
  36 \fB/usr/bin/pfksh\fR, \fB/usr/bin/pfsh\fR, and \fB/usr/bin/sh\fR,
  37 \fB/usr/bin/tcsh\fR, \fB/usr/bin/zsh\fR, and \fB/usr/sfw/bin/zsh\fR.
  38 \fB/etc/shells\fR overrides the default list.
  39 .sp
  40 .LP
  41 Invalid shells in \fB/etc/shells\fR could cause unexpected behavior, such as
  42 being unable to log in by way of \fBftp\fR(1).
  43 .SH FILES
  44 .sp
  45 .ne 2
  46 .na
  47 \fB\fB/etc/shells\fR\fR
  48 .ad
  49 .RS 15n
  50 list of shells on system
  51 .RE
  52
  53 .SH SEE ALSO
  54 .sp
  55 .LP
  56 \fBvipw\fR(1B), \fBftpd\fR(8), \fBgetusershell\fR(3C),
  57 \fBaliases\fR(4)