CHSH

Section: User Commands (1)
Updated: July 2014
Page Index
 

NAME

chsh - change your login shell  

SYNOPSIS

chsh [-s shell] [-l] [-h] [-v] [username]  

DESCRIPTION

chsh is used to change your login shell. If a shell is not given on the command line, chsh prompts for one.

chsh supports non-local entries (kerberos, LDAP, etc.) if linked with libuser, otherwise use ypchsh, lchsh or any other implementation for non-local entries.  

OPTIONS

-s, --shell shell
Specify your login shell.
-l, --list-shells
Print the list of shells listed in /etc/shells and exit.
-h, --help
Display help text and exit.
-v, --version
Display version information and exit.
 

VALID SHELLS

chsh will accept the full pathname of any executable file on the system.

The default behavior for non-root users is to accept only shells listed in the /etc/shells file, and issue a warning for root user. It can also be configured at compile-time to only issue a warning for all users.

 

EXIT STATUS

Returns 0 if operation was successful, 1 if operation failed or command syntax was not valid.  

AUTHORS

Salvatore Valente <svalente@mit.edu>  

SEE ALSO

login(1), login.defs(5), passwd(5), shells(5)  

AVAILABILITY

The chsh command is part of the util-linux package and is available from https://www.kernel.org/pub/linux/utils/util-linux/.


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
VALID SHELLS
EXIT STATUS
AUTHORS
SEE ALSO
AVAILABILITY