summaryrefslogtreecommitdiffstats
path: root/login-utils/chsh.1.adoc
blob: 939674ad500dd5fb43b8f3c0ff5ebc7175dfe022 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
//po4a: entry man manual
////
chsh.1 -- change your login shell
(c) 1994 by salvatore valente <svalente@athena.mit.edu>

This program is free software.  You can redistribute it and
modify it under the terms of the GNU General Public License.
There is no warranty.
////
= chsh(1)
:doctype: manpage
:man manual: User Commands
:man source: util-linux {release-version}
:page-layout: base
:command: chsh

== 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*(1), *lchsh*(1) 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.

include::man-common/help-version.adoc[]

== 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

mailto:svalente@mit.edu[Salvatore Valente]

== SEE ALSO

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

include::man-common/bugreports.adoc[]

include::man-common/footer.adoc[]

ifdef::translation[]
include::man-common/translation.adoc[]
endif::[]