ZSHOPTIONS(1) General Commands Manual ZSHOPTIONS(1) (NAME) zshoptions - zsh (SPECIFYING OPTIONS) . . `allexport' `A__lleXP_ort' . `no' `setopt No_Beep' `unsetopt beep' . `nonobeep' `beep' . `tify' `nonotify' ( `notify') . . : sh/ksh ( SH_OPTION_LETTERS ). set setopt unsetopt `-' . `+' `-' . . `+n' `exec' `-n' `noexec' . `-f ' `-f' `-f i' . `#!' . . LOCAL_OPTIONS . (DESCRIPTION OF OPTIONS) csh ksh sh zsh . ( `setopt' `unsetopt' `set -o' `set +o') `no' . ( KSH_OPTION_PRINT ) `setopt' . AUTO_CD (-J) cd . SHIN_STDIN . cd . AUTO_PUSHD (-N) cd . CDABLE_VARS (-T) cd ( cd AUTO_CD) `~' ( `Filename Expansion' ). CD_SILENT cd ( AUTO_CD) . cd - CDPATH . pushd PUSHD_SILENT . POSIX_CD . CHASE_DOTS `..' ( `foo/..' `..' ) . CHASE_LINKS . /foo/bar /alt/rod . `cd /foo/bar/..' /foo /alt . /foo/bar `cd ..' . . CHASE_LINKS (-w) . CHASE_DOTS `..' . POSIX_CD cd chdir pushd POSIX . cd zshbuiltins(1) . (`.') cdpath cd chdir `{+|-}n' . . ( pushd ) CDPATH `.' `.' . PUSHD_IGNORE_DUPS . PUSHD_MINUS `+' `-' . PUSHD_SILENT (-E) pushd popd . PUSHD_TO_HOME (-D) pushd `pushd $HOME' . ALWAYS_LAST_PROMPT (prompt) . . ALWAYS_TO_END . . AUTO_LIST (-9) . AUTO_MENU tab . MENU_COMPLETE . AUTO_NAME_DIRS `%~' `~' . ( `~param' .) AUTO_PARAM_KEYS ( ) ( `}' `:' ) . : `,' `}' . AUTO_PARAM_SLASH . AUTO_REMOVE_SLASH ( ) . BASH_AUTO_LIST . AUTO_LIST . LIST_AMBIGUOUS . AUTO_MENU . MENU_COMPLETE . COMPLETE_ALIASES . . COMPLETE_IN_WORD . . GLOB_COMPLETE glob MENU_COMPLETE . `*' COMPLETE_IN_WORD . globbing . ( ) . GLOB_COMPLETE . HASH_LIST_ALL . . LIST_AMBIGUOUS AUTO_LIST BASH_AUTO_LIST . . BASH_AUTO_LIST . LIST_BEEP . BEEP . LIST_PACKED ( ) . LIST_ROWS_FIRST . LIST_TYPES (-X) . MENU_COMPLETE (-Y) . . . reverse-menu-complete . AUTO_MENU . REC_EXACT (-S) ( ) . BAD_PATTERN (+2) . ( .) BARE_GLOB_QUAL glob `|' `(' ( ) `~' (qualifier list) . `Filename Generation' . BRACE_CCL . `Brace Expansion' . CASE_GLOB ( ) . . . cvs(/) CVS ( BARE_GLOB_QUAL ). CASE_MATCH zsh/regex ( =~) . CASE_PATHS CASE_PATHS () CASE_GLOB . CASE_PATHS NO_CASE_GLOB . CASE_PATHS . CSH_NULL_GLOB . NOMATCH . EQUALS = . ( `Filename Expansion' .) EXTENDED_GLOB `#' `~' `^' . ( `~' .) FORCE_FLOAT (floating point) . . GLOB (+F, ksh: +f) (globbing) . ( `Filename Generation' .) GLOB_ASSIGN (globbing) `name=pattern ( `foo=*') . . : `name=(value)' ( `foo=(*)') . GLOB_DOTS (-4) `.' . GLOB_STAR_SHORT zsh `**/*' `**' `***/*' *** . `**.c' .c `***.c' . / `**' `***' . GLOB_SUBST . ( ) . HIST_SUBST_PATTERN :s :& . glob . `Modifiers' zshexpn(1) . IGNORE_BRACES (-I) . IGNORE_CLOSE_BRACES . IGNORE_CLOSE_BRACES IGNORE_BRACES `}' . . . IGNORE_BRACES . : args() { echo $# } : args() { echo $#; } KSH_GLOB `@' `*' `+' `?' `!' . `Filename Generation' . MAGIC_EQUAL_SUBST `anything=expression' expression ( expression `~' `=' ) . . echo foo=~/bar:~/rod ~ . typeset . KSH_TYPESET . . MARK_DIRS (-8, ksh: -X) `/' (globbing) . MULTIBYTE . (locale) . . MULTIBYTE_SUPPORT . . . . (locale) . . NOMATCH (+3) . `~' `=' . NULL_GLOB (-G) . NOMATCH . NUMERIC_GLOB_SORT . RC_EXPAND_PARAM (-P) `foo${xx}bar' xx (a b c) `fooa b cbar' `fooabar foobbar foocbar' . . REMATCH_PCRE =~ (PCRE) PCRE . ( zsh/pcre .) . SH_GLOB `(' `|' `)' '<' . SH_GLOB KSH_GLOB (subshell) !(true) ! . zsh sh ksh . UNSET (+u, ksh: +u) . . WARN_CREATE_GLOBAL . . typeset -g . . WARN_NESTED_VAR . . WARN_CREATE_GLOBAL . typeset -g . `functions -W' . nested toplevel : toplevel() { local foo="in fn" nested } nested() { foo="in nested" } setopt warn_nested_var toplevel APPEND_HISTORY zsh (append) . zsh . $SAVEHIST ( HIST_SAVE_BY_COPY ). BANG_HIST (+K) csh `!' . EXTENDED_HISTORY ( epoch) ( ) . : `: :;'. HIST_ALLOW_CLOBBER `|' . CLOBBER (clobber) . HIST_BEEP ZLE . HIST_EXPIRE_DUPS_FIRST . HISTSIZE SAVEHIST HIST_IGNORE_ALL_DUPS . HIST_FCNTL_LOCK zsh (ad-hoc) . fcntl . NFS . HIST_FIND_NO_DUPS . HIST_IGNORE_ALL_DUPS ( ). HIST_IGNORE_DUPS (-h) . HIST_IGNORE_SPACE (-g) . ( ) . . (return) . HIST_LEX_WORDS (whitespace) . . . . . HIST_NO_FUNCTIONS . . HIST_NO_STORE history (fc -l) . . HIST_REDUCE_BLANKS . HIST_SAVE_BY_COPY $HISTFILE.new . (truncate) . . zsh . zsh . HIST_SAVE_NO_DUPS . HIST_VERIFY . INC_APPEND_HISTORY APPEND_HISTORY ( ) $HISTFILE . $SAVEHIST ( HIST_SAVE_BY_COPY ). INC_APPEND_HISTORY_TIME INC_APPEND_HISTORY EXTENDED_HISTORY . . INC_APPEND_HISTORY SHARE_HISTORY . () . SHARE_HISTORY (import) ( INC_APPEND_HISTORY ). EXTENDED_HISTORY ( ). zle set-local-history . zle . SHARE_HISTORY INC_APPEND_HISTORY INC_APPEND_HISTORY_TIME ( ) `fc -RI' . ALL_EXPORT (-a, ksh: -a) (export) . GLOBAL_EXPORT -x declare float integer readonly typeset ( local) -g +g . . . export -x -g . GLOBAL_RCS (+d) /etc/zsh/zprofile /etc/zsh/zshrc /etc/zsh/zlogin /etc/zsh/zlogout . (.zshrc ) . RCS (+f) /etc/zsh/zshenv .zshenv /etc/zsh/zprofile .zprofile /etc/zsh/zshrc .zshrc /etc/zsh/zlogin .zlogin .zlogout <> . /etc/zsh/zshenv . / (Input/Output) ALIASES (aliases). CLOBBER (+C, ksh: +C) `>' (truncate) . `>!' `>|' . APPEND_CREATE `>>!' `>>|' . `>>' . CLOBBER_EMPTY CLOBBER : . (`clobbered'). . . CORRECT (-0) . HASH_LIST_ALL . CORRECT_IGNORE . CORRECT_ALL (-O) . CORRECT_IGNORE_FILE . DVORAK Dvorak qwerty CORRECT CORRECT_ALL spell-word. FLOW_CONTROL start/stop ( ^S/^Q ) . IGNORE_EOF (-7) (end-of-file) . exit logout . EOF tty . Zsh Line Editor (widgets) EOF ( Control-D) (bind) . (completion). INTERACTIVE_COMMENTS (-k) (comments) . HASH_CMDS . . . CORRECT . HASH_DIRS . HASH_CMDS CORRECT . HASH_EXECUTABLES_ONLY HASH_CMDS . . . MAIL_WARNING (-U) (mail) . PATH_DIRS (-Q) . `/usr/local/bin' `X11/xinit' `/usr/local/bin/X11/xinit' ( ). `/' `./' `../' . `.' source . . `.' . PATH_SCRIPT . . INVOCATION zsh(1) . PRINT_EIGHT_BIT . ( ctype(3)). PRINT_EXIT_VALUE (-1) . . RC_QUOTES `''' (single quote) . $'...' . RM_STAR_SILENT (-H) `rm *' `rm path/*' ..TP RM_STAR_WAIT `rm *' `rm path/*' . <> . `*' ZLE ( tab) . SHORT_LOOPS for repeat select if function . SHORT_REPEAT repeat SHORT_LOOPS . SUN_KEYBOARD_HACK (-L) (backquote) . return . KEYBOARD_HACK . (Job Control) AUTO_CONTINUE disown CONT . AUTO_RESUME (-W) . BG_NICE (-6) . . CHECK_JOBS . NO_CHECK_JOBS NO_HUP . `jobs' . `jobs' SPECIAL FUNCTIONS zshmisc(1) . CHECK_RUNNING_JOBS CHECK_JOBS . zsh bash . CHECK_JOBS . HUP HUP . LONG_LIST_JOBS (-R) . MONITOR (-m, ksh: -m) . . NOTIFY (-5, ksh: -b) . POSIX_JOBS POSIX . MONITOR . MONITOR . bg fg jobs . . jobs . ( ) . jobs . POSIX_JOBS wait . . PROMPT_BANG <> . EXPANSION OF PROMPT SEQUENCES zshmisc(1) . PROMPT_CR (+V) (carriage return) . . PROMPT_SP ( ) PROMPT_CR . ( (automatic margins) ). + (inverse+bold) : <<%>> <<#>> (root). PROMPT_EOL_MARK . : PROMPT_CR . . PROMPT_PERCENT <<%>> . EXPANSION OF PROMPT SEQUENCES zshmisc(1) . PROMPT_SUBST . . TRANSIENT_RPROMPT . / (cut/paste) . (Scripts and Functions) ALIAS_FUNC_DEF zsh <> name (alias) : . . . . alias foo=bar foo() { print This probably does not do what you expect. } foo () bar bar . . function . C_BASES C <<0xFF>> <<16#FF>>. OCTAL_ZEROES ( ) () <<8#77>> <<077>> . . C_BASES . C_PRECEDENCES C ARITHMETIC EVALUATION zshmisc(1) . DEBUG_BEFORE_CMD DEBUG . ksh 93 ksh 88 . ERR_EXIT (-e, ksh: -e) ZERR . . DEBUG . : . DEBUG_BEFORE_CMD ( ) ERR_EXIT DEBUG . . && || . false && true . ERR_EXIT (asynchronous jobs) JOBS zshmisc(1) . ERR_RETURN . ERR_EXIT exit return . . ERR_EXIT <<&&>> <<||>> . : summit || true . summit : summit ( summit ) . ERR_EXIT . EVAL_LINENO eval . LINENO %i . %N <<(eval)>> . ( PS4 XTRACE .) EVAL_LINENO . EXEC (+n, ksh: +n) . . <<-n>> . FUNCTION_ARGZERO $0 / . FUNCTION_ARGZERO ( ) $0 . . POSIX_ARGZERO..TP LOCAL_LOOPS break continue . break continue ( ) . LOCAL_OPTIONS ( ) PRIVILEGED RESTRICTED . LOCAL_LOOPS XTRACE PRINT_EXIT_VALUE . . `emulate -L zsh' -L LOCAL_OPTIONS . LOCAL_PATTERNS `disable -p' . LOCAL_OPTIONS `emulate -L sh' ( -L) LOCAL_PATTERNS . LOCAL_TRAPS (signal trap) . LOCAL_OPTIONS . . unsetopt localtraps trap - INT fn() { setopt localtraps; trap '' INT; sleep 3; } SIGINT . MULTI_FUNC_DEF `fn1 fn2...()' (parse error) . function . . MULTIOS (redirection) tee cat ( `Redirection' ). OCTAL_ZEROES IEEE Std 1003.2-1992 (ISO 9945-2:1993) 0 (octal) . . `08' `08#77' . PIPE_FAIL $? . . SOURCE_TRACE zsh . XTRACE . (Startup/Shutdown Files) `source' `dot' . TYPESET_SILENT `typeset' . `-m' . `-p' . TYPESET_TO_UNSET `typeset' (unset) `typeset' . VERBOSE (-v, ksh: -v) . XTRACE (-x, ksh: -x) . $PS4 EXPANSION OF PROMPT SEQUENCES zshmisc(1) . APPEND_CREATE NO_CLOBBER (-C) . (>>) ( zsh NO_CLOBBER). ( POSIX). BASH_REMATCH =~ MATCH match BASH_REMATCH . BASH_REMATCH . KSH_ARRAYS 0 1 . MATCH match . BSD_ECHO echo echo(1) BSD . (backslash) echo -e . CONTINUE_ON_ERROR ( ERRORS zshmisc(1) ) . zsh 5.0.1 . CSH_JUNKIE_HISTORY . . CSH_JUNKIE_LOOPS `do list; done' `list; end' . CSH_JUNKIE_QUOTES (single- double-quoted) csh . (backslash) . (escape) `$' ``' `"' ( `\' ). . CSH_NULLCMD NULLCMD READNULLCMD . ( `Redirection' ). KSH_ARRAYS ksh . (`${path[2]}' `$path[2]') (`${PWD:h}' `$PWD:h') . KSH_AUTOLOAD ksh . . ( . ksh - - ksh .) KSH_OPTION_PRINT : `on' `off' . KSH_TYPESET : declare export float integer local readonly typeset . . typeset declare export float integer local readonly . zsh . KSH_ZERO_SUBSCRIPT 1 . KSH_ARRAYS . KSH_ARRAYS . . KSH_ZERO_SUBSCRIPT array[0]=(element) array[0,1]=(element) . . POSIX_ALIASES : . RESERVED WORDS zshmisc(1) . . . `zsh -c' `zsh -o posixaliases -c' . . POSIX_ARGZERO FUNCTION_ARGZERO $0 ( -c ) . POSIX_ARGZERO NO_FUNCTION_ARGZERO (scoping) $0 . POSIX_ARGZERO emulate : emulate sh -o POSIX_ARGZERO NO_POSIX_ARGZERO FUNCTION_ARGZERO . POSIX_BUILTINS command . command . : . : break continue declare eval exit export integer local readonly return set shift source times trap unset. exec . exec (path) . getopts POSIX OPTIND . [[ -o non_existent_option ]] . POSIX_IDENTIFIERS a z A Z 0 9 _ ( ) . $# $# . zsh $#name $name $#- $#*. . `unset t; (( t = 3 ))'. POSIX_IDENTIFIERS t . ( MULTIBYTE ) - . variable=value . . zsh . POSIX_STRINGS . null 0 US ASCII . null $'...' . null . $'...' null . . a$'b\0c'd a b null c d a b d . POSIX_TRAPS zsh EXIT . EXIT LOCAL_TRAPS EXIT . return . . . SH_FILE_EXPANSION ( ~) . `~$USERNAME' `~{pfalstad,rc}' . SH_NULLCMD NULLCMD READNULLCMD `:' ( <> ). SH_OPTION_LETTERS ( set setopt ) ksh . - . SH_WORD_SPLIT (-y) . . ( zshexpn(1).) TRAPS_ASYNC . . . INTERACTIVE (-i, ksh: -i) . tty . ( SHIN_STDIN .) . . zsh . LOGIN (-l, ksh: -l) (login shell) . argv[0] <<->> . PRIVILEGED (-p, ksh: -p) (privileged mode) . . -p zsh . #!/bin/zsh -p () () . . : unsetopt privileged || exit PRIVILEGED (source ) . zsh <> <> /etc/suid_profile ( /etc/profile). ~/.profile ENV . -m setopt unsetopt LOCAL_OPTIONS . RESTRICTED (-r) (restricted mode) . unsetopt LOCAL_OPTIONS . <> . SHIN_STDIN (-s, ksh: -s) . -c . SHIN_STDIN (positional parameter) . - . . zsh . SINGLE_COMMAND (-t, ksh: -t) . INTERACTIVE . . zsh . BEEP (+B) ZLE. COMBINING_CHARS . - (zero-width) . . . [[:WORD:]] . . EMACS ZLE <> . VI . . . bindkey . OVERSTRIKE (overstrike). SINGLE_LINE_ZLE (-M) . ksh ksh zsh . ksh . VI ZLE <> . EMACS . . . bindkey . ZLE (-Z) zsh. . (OPTION ALIASES) . . BRACE_EXPAND NO_IGNORE_BRACES ( ksh bash) DOT_GLOB GLOB_DOTS ( bash) HASH_ALL HASH_CMDS ( bash) HIST_APPEND APPEND_HISTORY ( bash) HIST_EXPAND BANG_HIST ( bash) LOG NO_HIST_NO_FUNCTIONS ( ksh) MAIL_WARN MAIL_WARNING ( bash) ONE_CMD SINGLE_COMMAND ( bash) PHYSICAL CHASE_LINKS ( ksh bash) PROMPT_VARS PROMPT_SUBST ( bash) STDIN SHIN_STDIN ( ksh) TRACK_ALL HASH_CMDS ( ksh).SH " (SINGLE LETTER OPTIONS)" (Default set) -0 CORRECT -1 PRINT_EXIT_VALUE -2 NO_BAD_PATTERN -3 NO_NOMATCH -4 GLOB_DOTS -5 NOTIFY -6 BG_NICE -7 IGNORE_EOF -8 MARK_DIRS -9 AUTO_LIST -B NO_BEEP -C NO_CLOBBER -D PUSHD_TO_HOME -E PUSHD_SILENT -F NO_GLOB -G NULL_GLOB -H RM_STAR_SILENT -I IGNORE_BRACES -J AUTO_CD -K NO_BANG_HIST -L SUN_KEYBOARD_HACK -M SINGLE_LINE_ZLE -N AUTO_PUSHD -O CORRECT_ALL -P RC_EXPAND_PARAM -Q PATH_DIRS -R LONG_LIST_JOBS -S REC_EXACT -T CDABLE_VARS -U MAIL_WARNING -V NO_PROMPT_CR -W AUTO_RESUME -X LIST_TYPES -Y MENU_COMPLETE -Z ZLE -a ALL_EXPORT -e ERR_EXIT -f NO_RCS -g HIST_IGNORE_SPACE -h HIST_IGNORE_DUPS -i INTERACTIVE -k INTERACTIVE_COMMENTS -l LOGIN -m MONITOR -n NO_EXEC -p PRIVILEGED -r RESTRICTED -s SHIN_STDIN -t SINGLE_COMMAND -u NO_UNSET -v VERBOSE -w CHASE_LINKS -x XTRACE -y SH_WORD_SPLIT -C NO_CLOBBER -T TRAPS_ASYNC -X MARK_DIRS -a ALL_EXPORT -b NOTIFY -e ERR_EXIT -f NO_GLOB -i INTERACTIVE -l LOGIN -m MONITOR -n NO_EXEC -p PRIVILEGED -r RESTRICTED -s SHIN_STDIN -t SINGLE_COMMAND -u NO_UNSET -v VERBOSE -x XTRACE -A set -b -c -m setopt -o -s set zsh 5.9.2 July 12, 2026 ZSHOPTIONS(1)