projects / thirdparty / util-linux.git / blame
| Commit | Line | Data |
|---|---|---|
| 6dbe3af9 KZ |
1 | .\" |
| 2 | .\" chsh.1 -- change your login shell | |
| 3 | .\" (c) 1994 by salvatore valente <svalente@athena.mit.edu> | |
| 4 | .\" | |
| bf967a6c BS |
5 | .\" This program is free software. You can redistribute it and |
| 6 | .\" modify it under the terms of the GNU General Public License. | |
| 7 | .\" There is no warranty. | |
| 6dbe3af9 | 8 | .\" |
| bf967a6c | 9 | .TH CHSH 1 "July 2014" "util-linux" "User Commands" |
| 6dbe3af9 KZ |
10 | .SH NAME |
| 11 | chsh \- change your login shell | |
| 12 | .SH SYNOPSIS | |
| 13 | .B chsh | |
| 2054a2b0 PB |
14 | .RB [ \-s |
| 15 | .IR shell ] | |
| 16 | .RB [ \-l ] | |
| 631a1954 | 17 | .RB [ \-h ] |
| 2054a2b0 PB |
18 | .RB [ \-v ] |
| 19 | .RI [ username ] | |
| 6dbe3af9 KZ |
20 | .SH DESCRIPTION |
| 21 | .B chsh | |
| 22 | is used to change your login shell. | |
| 23 | If a shell is not given on the command line, | |
| 24 | .B chsh | |
| 25 | prompts for one. | |
| ae705472 KZ |
26 | |
| 27 | .B chsh | |
| 802cb7db | 28 | supports non-local entries (kerberos, LDAP, etc.\&) if linked with libuser, |
| bf967a6c BS |
29 | otherwise use \fBypchsh\fR, \fBlchsh\fR or any other implementation for |
| 30 | non-local entries. | |
| 6dbe3af9 KZ |
31 | .SH OPTIONS |
| 32 | .TP | |
| bf967a6c | 33 | .BR \-s , " \-\-shell " \fIshell |
| 6dbe3af9 KZ |
34 | Specify your login shell. |
| 35 | .TP | |
| b06c1ca6 | 36 | .BR \-l , " \-\-list\-shells" |
| 6dbe3af9 KZ |
37 | Print the list of shells listed in |
| 38 | .I /etc/shells | |
| 39 | and exit. | |
| 40 | .TP | |
| 631a1954 | 41 | .BR \-h , " \-\-help" |
| b4362b6f | 42 | Display help text and exit. |
| 6dbe3af9 | 43 | .TP |
| bf967a6c | 44 | .BR \-v , " \-\-version" |
| b4362b6f | 45 | Display version information and exit. |
| 36f9133d KZ |
46 | .SH "VALID SHELLS" |
| 47 | .B chsh | |
| 48 | will accept the full pathname of any executable file on the system. | |
| 49 | However, it will issue a warning if the shell is not listed in the | |
| 50 | .I /etc/shells | |
| 51 | file. | |
| 52 | On the other hand, it can also be configured such that it will | |
| 53 | only accept shells listed in this file, unless you are root. | |
| 54 | .SH "EXIT STATUS" | |
| 55 | Returns 0 if operation was successful, 1 if operation failed or command syntax was not valid. | |
| 6dbe3af9 KZ |
56 | .SH "SEE ALSO" |
| 57 | .BR login (1), | |
| 3fe5e8ec | 58 | .BR login.defs (5), |
| 6dbe3af9 KZ |
59 | .BR passwd (5), |
| 60 | .BR shells (5) | |
| 61 | .SH AUTHOR | |
| 62 | Salvatore Valente <svalente@mit.edu> | |
| 86d62711 | 63 | .SH AVAILABILITY |
| 601d12fb | 64 | The chsh command is part of the util-linux package and is available from |
| d673b74e | 65 | https://www.kernel.org/pub/linux/utils/util-linux/. |