2 # Purpose: config file for zsh (z shell)
3 # Authors: grml-team (grml.org), (c) Michael Prokop <mika@grml.org>
4 # Bug-Reports: see http://grml.org/bugs/
5 # License: This file is licensed under the GPL v2.
6 # Latest change: Don Nov 30 16:15:06 CET 2006 [mika]
7 ################################################################################
8 # This file is sourced only for interactive shells. It
9 # should contain commands to set up aliases, functions,
10 # options, key bindings, etc.
12 # Global Order: zshenv, zprofile, zshrc, zlogin
13 ################################################################################
15 # {{{ check for version/system
16 # check for versions (compatibility reasons)
17 if autoload is-at-least && is-at-least 2>/dev/null ; then
18 is4() { is-at-least 4 }
19 is42() { is-at-least 4.2 }
22 [[ $ZSH_VERSION == 4.* ]] && return 0
26 [[ $ZSH_VERSION == 4.<2->* ]] && return 0
33 [ -f /etc/grml_version ] && return 0
38 [ -f /etc/grml_cd ] && return 0
44 [[ ${${${(f)"$(</etc/grml_version)"}%% *}##*-} == 'small' ]] && return 0 ; return 1
47 isgrmlsmall() { return 1 }
50 # are we running within an utf environment?
52 case "$LANG $CHARSET $LANGUAGE" in
58 # check for user, if not running as root set $SUDO to sudo
59 (( EUID != 0 )) && SUDO='sudo' || SUDO=''
61 # change directory to home on first invocation of zsh
62 # important for rungetty -> autologin
63 # Thanks go to Bart Schaefer!
64 isgrml && checkhome() {
65 if [[ -z "$ALREADY_DID_CD_HOME" ]]; then
66 export ALREADY_DID_CD_HOME=$HOME
72 # {{{ set some variables
73 export EDITOR=${EDITOR:-vim}
74 export MAIL=${MAIL:-/var/mail/$USER}
75 [[ -f ~/.terminfo/m/mostlike ]] && MYLESS='LESS=C TERMINFO=~/.terminfo TERM=mostlike less' || MYLESS='less'
76 [[ -x /usr/bin/dircolors ]] && eval `dircolors -b`
78 # Search path for the cd comman
81 # Support our own site-functions
82 [ -d /etc/zsh/site-functions ] && FPATH=/etc/zsh/site-functions:$FPATH
84 # automatically remove duplicates from these arrays
85 typeset -U path cdpath fpath manpath
89 if [[ "$TERM" != emacs ]]; then
90 [[ -z "$terminfo[kdch1]" ]] || bindkey -M emacs "$terminfo[kdch1]" delete-char
91 [[ -z "$terminfo[khome]" ]] || bindkey -M emacs "$terminfo[khome]" beginning-of-line
92 [[ -z "$terminfo[kend]" ]] || bindkey -M emacs "$terminfo[kend]" end-of-line
93 [[ -z "$terminfo[kdch1]" ]] || bindkey -M vicmd "$terminfo[kdch1]" vi-delete-char
94 [[ -z "$terminfo[khome]" ]] || bindkey -M vicmd "$terminfo[khome]" vi-beginning-of-line
95 [[ -z "$terminfo[kend]" ]] || bindkey -M vicmd "$terminfo[kend]" vi-end-of-line
96 [[ -z "$terminfo[cuu1]" ]] || bindkey -M viins "$terminfo[cuu1]" vi-up-line-or-history
97 [[ -z "$terminfo[cuf1]" ]] || bindkey -M viins "$terminfo[cuf1]" vi-forward-char
98 [[ -z "$terminfo[kcuu1]" ]] || bindkey -M viins "$terminfo[kcuu1]" vi-up-line-or-history
99 [[ -z "$terminfo[kcud1]" ]] || bindkey -M viins "$terminfo[kcud1]" vi-down-line-or-history
100 [[ -z "$terminfo[kcuf1]" ]] || bindkey -M viins "$terminfo[kcuf1]" vi-forward-char
101 [[ -z "$terminfo[kcub1]" ]] || bindkey -M viins "$terminfo[kcub1]" vi-backward-char
103 [[ "$terminfo[kcuu1]" == "
\eO"* ]] && bindkey -M viins "${terminfo[kcuu1]/O/[}" vi-up-line-or-history
104 [[ "$terminfo[kcud1]" == "
\eO"* ]] && bindkey -M viins "${terminfo[kcud1]/O/[}" vi-down-line-or-history
105 [[ "$terminfo[kcuf1]" == "
\eO"* ]] && bindkey -M viins "${terminfo[kcuf1]/O/[}" vi-forward-char
106 [[ "$terminfo[kcub1]" == "
\eO"* ]] && bindkey -M viins "${terminfo[kcub1]/O/[}" vi-backward-char
107 [[ "$terminfo[khome]" == "
\eO"* ]] && bindkey -M viins "${terminfo[khome]/O/[}" beginning-of-line
108 [[ "$terminfo[kend]" == "
\eO"* ]] && bindkey -M viins "${terminfo[kend]/O/[}" end-of-line
109 [[ "$terminfo[khome]" == "
\eO"* ]] && bindkey -M emacs "${terminfo[khome]/O/[}" beginning-of-line
110 [[ "$terminfo[kend]" == "
\eO"* ]] && bindkey -M emacs "${terminfo[kend]/O/[}" end-of-line
113 ## keybindings (run 'bindkeys' for details, more details via man zshzle)
114 # use emacs style per default:
119 #if [[ "$TERM" == screen ]]; then
120 bindkey '\e[1~' beginning-of-line # home
121 bindkey '\e[4~' end-of-line # end
122 bindkey "^[[A" up-line-or-search # cursor up
123 bindkey "^[[B" down-line-or-search # <ESC>-
124 bindkey '^x' history-beginning-search-backward # alternative ways of searching the shell history
125 # bindkey -s '^L' "|less\n" # ctrl-L pipes to less
126 # bindkey -s '^B' " &\n" # ctrl-B runs it in the background
127 # if terminal type is set to 'rxvt':
128 bindkey '\e[7~' beginning-of-line # home
129 bindkey '\e[8~' end-of-line # end
132 # bindkey '\eq' push-line-or-edit
135 # power completion - abbreviation expansion {{{
136 # power completion / abbreviation expansion / buffer expansion
137 # see http://zshwiki.org/home/examples/zleiab for details
138 # less risky than the global aliases but powerful as well
139 # just type the abbreviation key and afterwards ',.' to expand it
142 setopt interactivecomments
150 'G' '|& grep --color=auto'
152 'Hl' ' --help |& less -r'
157 'R' '| tr A-z N-za-m'
162 'hide' "echo -en '\033]50;nil2\007'"
163 'tiny' 'echo -en "\033]50;-misc-fixed-medium-r-normal-*-*-80-*-*-c-*-iso8859-15\007"'
164 'small' 'echo -en "\033]50;6x10\007"'
165 'medium' 'echo -en "\033]50;-misc-fixed-medium-r-normal--13-120-75-75-c-80-iso8859-15\007"'
166 'default' 'echo -e "\033]50;-misc-fixed-medium-r-normal-*-*-140-*-*-c-*-iso8859-15\007"'
167 'large' 'echo -en "\033]50;-misc-fixed-medium-r-normal-*-*-150-*-*-c-*-iso8859-15\007"'
168 'huge' 'echo -en "\033]50;-misc-fixed-medium-r-normal-*-*-210-*-*-c-*-iso8859-15\007"'
169 'smartfont' 'echo -en "\033]50;-artwiz-smoothansi-*-*-*-*-*-*-*-*-*-*-*-*\007"'
170 'semifont' 'echo -en "\033]50;-misc-fixed-medium-r-semicondensed-*-*-120-*-*-*-*-iso8859-15\007"'
174 'co' "./configure && make && sudo make install"
175 'CH' "./configure --help"
176 'conkeror' 'firefox -chrome chrome://conkeror/content'
178 'lad' $'ls -d .*(/)\n# only show dot-directories'
179 'lsa' $'ls -a .*(.)\n# only show dot-files'
180 'lss' $'ls -l *(s,S,t)\n# only files with setgid/setuid/sticky flag'
181 'lsl' $'ls -l *(@[1,10])\n# only symlinks'
182 'lsx' $'ls -l *(*[1,10])\n# only executables'
183 'lsw' $'ls -ld *(R,W,X.^ND/)\n# world-{readable,writable,executable} files'
184 'lsbig' $'ls -flh *(.OL[1,10])\n# display the biggest files'
185 'lsd' $'ls -d *(/)\n# only show directories'
186 'lse' $'ls -d *(/^F)\n# only show empty directories'
187 'lsnew' $'ls -rl *(D.om[1,10])\n# display the newest files'
188 'lsold' $'ls -rtlh *(D.om[-11,-1])\n # display the oldest files'
189 'lssmall' $'ls -Srl *(.oL[1,10])\n# display the smallest files'
191 '600' 'chmod u+rw-x,g-rwx,o-rwx'
193 '700' 'chmod u+rwx,g-rwx,o-rwx'
194 'r--' 'chmod u+r-wx,g-rwx,o-rwx'
195 '644' $'chmod u+rw-x,g+r-wx,o+r-wx\n # 4=r,2=w,1=x'
196 '755' 'chmod u+rwx,g+r-w+x,o+r-w+x'
198 'cmplayer' 'mplayer -vo -fs -zoom fbdev'
199 'fbmplayer' 'mplayer -vo -fs -zoom fbdev'
200 'fblinks' 'links2 -driver fb'
201 'insecssh' 'ssh -o "StrictHostKeyChecking=no" -o "UserKnownHostsFile=/dev/null"'
202 'fori' 'for i ({..}) { }'
205 'se' 'setopt interactivecomments'
206 'va' 'valac --vapidir=../vapi/ --pkg=gtk+-2.0 gtktest.vala'
207 'fb2' '=mplayer -vo fbdev -fs -zoom 1>/dev/null -xy 2'
208 'fb3' '=mplayer -vo fbdev -fs -zoom 1>/dev/null -xy 3'
210 'D' 'export DISPLAY=:0.0'
211 'mp' 'mplayer -vo xv -fs -zoom'
216 matched_chars='[.-|_a-zA-Z0-9]#'
217 LBUFFER=${LBUFFER%%(#m)[.-|_a-zA-Z0-9]#}
218 LBUFFER+=${abk[$MATCH]:-$MATCH}
222 bindkey ",." globalias
226 autoload -U zmv # who needs mmv or rename?
227 autoload history-search-end
229 # we don't want to quote/espace URLs on our own...
230 # avoid 'url-quote-magic: function definition file not found' on some older boxes
231 if [ -f "/usr/share/zsh/$ZSH_VERSION/functions/Zle/url-quote-magic" ] && \
232 autoload -U url-quote-magic && zle -N self-insert url-quote-magic ; then
233 zle -N self-insert url-quote-magic
235 print 'Notice: no url-quote-magic available :('
238 alias run-help >&/dev/null && unalias run-help
239 autoload run-help # use via 'esc-h'
242 if autoload -U compinit && [ -f "/usr/share/zsh/$ZSH_VERSION/functions/Completion/compinit" ] && compinit 2>/dev/null ; then
245 print 'Notice: no compinit available :('
250 is4 && autoload -U zed # use ZLE editor to edit a file or function
252 is4 && for mod in complist deltochar mathfunc ; do
253 zmodload -i zsh/${mod}
256 # autoload zsh modules when they are referenced
257 is4 && for opt mod in a stat \
261 zmodload -${opt} zsh/${mod} ${mod}
264 is4 && autoload -U insert-files && \
265 zle -N insert-files && \
266 bindkey "^Xf" insert-files # C-x-f
268 bindkey ' ' magic-space # also do history expansion on space
269 bindkey '\ei' menu-complete # menu completion via esc-i
271 # press esc-e for editing command line in $EDITOR or $VISUAL
272 is4 && autoload -U edit-command-line && \
273 zle -N edit-command-line && \
274 bindkey '\ee' edit-command-line
276 # menu selection: pick item but stay in the menu (press esc-return)
277 is4 && bindkey -M menuselect '\e^M' accept-and-menu-complete
279 # press "ctrl-e d" to insert the actual date in the form yyyy-mm-dd
280 _bkdate() { BUFFER="$BUFFER$(date '+%F')"; CURSOR=$#BUFFER; }
281 bindkey '\C-ed' _bkdate
284 # press esc-m for inserting last typed word again (thanks to caphuso!)
285 insert-last-typed-word() { zle insert-last-word -- 0 -1 }; \
286 zle -N insert-last-typed-word; bindkey "\em" insert-last-typed-word
288 # set command prediction from history, see 'man 1 zshcontrib'
289 # is4 && autoload -U predict-on && \
290 # zle -N predict-on && \
291 # zle -N predict-off && \
292 # bindkey "^X^Z" predict-on && \
293 # bindkey "^Z" predict-off
295 # put job into foreground via ctrl-z:
296 bindkey -s '^z' "fg\n"
298 # press ctrl-q to quote line:
300 # zle beginning-of-line
302 # # RBUFFER="'$RBUFFER'"
303 # RBUFFER=${(q)RBUFFER}
306 # zle -N mquote && bindkey '^q' mquote
308 # run command line as user root via sudo:
309 _sudo-command-line() {
310 [[ $BUFFER != sudo\ * ]] && LBUFFER="sudo $LBUFFER"
312 zle -N sudo-command-line _sudo-command-line
313 bindkey "^Os" sudo-command-line
316 # {{{ set some important options
321 setopt append_history # append history list to the history file (important for multiple parallel zsh sessions!)
322 is4 && setopt SHARE_HISTORY # import new commands from the history file also in other zsh-session
323 setopt extended_history # save each command's beginning timestamp and the duration to the history file
324 is4 && setopt histignorealldups # If a new command line being added to the history
325 # list duplicates an older one, the older command is removed from the list
326 setopt histignorespace # remove command lines from the history list when
327 # the first character on the line is a space
328 # setopt histallowclobber # add `|' to output redirections in the history
329 # setopt NO_clobber # warning if file exists ('cat /dev/null > ~/.zshrc')
330 setopt auto_cd # if a command is issued that can't be executed as a normal command,
331 # and the command is the name of a directory, perform the cd command to that directory
332 setopt extended_glob # in order to use #, ~ and ^ for filename generation
333 # grep word *~(*.gz|*.bz|*.bz2|*.zip|*.Z) ->
334 # -> searches for word not in compressed files
335 # don't forget to quote '^', '~' and '#'!
336 setopt notify # report the status of backgrounds jobs immediately
337 setopt hash_list_all # Whenever a command completion is attempted, make sure \
338 # the entire command path is hashed first.
339 setopt completeinword # not just at the end
340 # setopt nocheckjobs # don't warn me about bg processes when exiting
341 setopt nohup # and don't kill them, either
342 # setopt printexitvalue # alert me if something failed
343 # setopt dvorak # with spelling correction, assume dvorak kb
344 setopt auto_pushd # make cd push the old directory onto the directory stack.
345 setopt nonomatch # try to avoid the 'zsh: no matches found...'
346 setopt nobeep # avoid "beep"ing
348 MAILCHECK=30 # mailchecks
349 REPORTTIME=5 # report about cpu-/system-/user-time of command if running longer than 5 secondes
350 watch=(notme root) # watch for everyone but me and root
352 # define word separators (for stuff like backward-word, forward-word, backward-kill-word,..)
353 # WORDCHARS='*?_-.[]~=/&;!#$%^(){}<>' # the default
355 # WORDCHARS='*?_[]~=&;!#$%^(){}'
356 # WORDCHARS='${WORDCHARS:s@/@}'
358 # only slash should be considered as a word separator:
359 slash-backward-kill-word() {
360 local WORDCHARS="${WORDCHARS:s@/@}"
362 zle backward-kill-word
364 zle -N slash-backward-kill-word
365 bindkey '\ev' slash-backward-kill-word # press esc-v to delete a word until its last '/' (not the same as ctrl-w!)
369 export ZSHDIR=$HOME/.zsh
370 HISTFILE=$HOME/.zsh_history
371 isgrmlcd && HISTSIZE=500 || HISTSIZE=5000
372 isgrmlcd && SAVEHIST=1000 || SAVEHIST=10000 # useful for setopt append_history
375 # {{{ display battery status on right side of prompt via running 'BATTERY=1 zsh'
376 if [ -n "$BATTERY" ] ; then
377 if [ -x =acpi ] ; then
378 PERCENT="${(C)${(s| |)$(acpi 2>/dev/null)}[4]}"
379 [ -z "$PERCENT" ] && PERCENT='acpi not present'
380 if [ "${PERCENT%%%}" -lt 20 ] ; then
381 PERCENT="warning: ${PERCENT}%"
388 if [ -f "/usr/share/zsh/$ZSH_VERSION/functions/Prompts/promptinit" ] && autoload promptinit && promptinit 2>/dev/null ; then
389 promptinit # people should be able to use their favourite prompt
391 print 'Notice: no promptinit available :('
394 # precmd() => a function which is executed just before each prompt
395 # use 'NOPRECMD=1' to disable the precmd + preexec commands
397 # precmd () { setopt promptsubst; [[ -o interactive ]] && jobs -l;
399 is4 && ! [[ -n "$NOPRECMD" ]] && precmd () {
400 (( NOPRECMD > 0 )) && return 0
401 # just use DONTSETRPROMPT=1 to be able to overwrite RPROMPT
402 if [[ -z ${DONTSETRPROMPT} ]] ; then
403 if [ -n "$BATTERY" ] ; then
404 # RPROMPT="%(?..:()% ${PERCENT}${SCREENTITLE}"
405 RPROMPT="${PERCENT}${SCREENTITLE}"
407 # RPROMPT="%(?..:()% ${SCREENTITLE}"
408 RPROMPT="${SCREENTITLE}"
411 # adjust title of xterm
412 # see http://www.faqs.org/docs/Linux-mini/Xterm-Title.html
413 case $TERM in (xterm*|rxvt)
414 print -Pn "\e]0;%n@%m: %~\a"
419 # chpwd () => a function which is executed whenever the directory is changed
421 # preexec() => a function running before every command
422 is4 && ! [[ -n "$NOPRECMD" ]] && preexec () {
423 (( NOPRECMD > 0 )) && return 0
424 # set hostname if not running on host with name 'grml'
425 local HOSTNAME=$(hostname)
426 if [[ "$HOSTNAME" != grml ]] ; then
429 # get the name of the program currently running and hostname of local machine
430 # set screen window title if running in a screen
431 if [[ "$TERM" == screen* ]]; then
432 # local CMD=${1[(wr)^(*=*|sudo|ssh|-*)]} # dont't use hostname
433 local CMD="${1[(wr)^(*=*|sudo|ssh|-*)]}$NAME" # use hostname
434 echo -ne "\ek$CMD\e\\"
436 # set the screen title to "zsh" when sitting at the command prompt:
437 if [[ "$TERM" == screen* ]]; then
438 SCREENTITLE=$'%{\ekzsh\e\\%}'
442 # adjust title of xterm
443 case $TERM in (xterm*|rxvt)
444 print -Pn "\e]0;%n@%m: $1\a"
450 if autoload colors && colors 2>/dev/null ; then
451 BLUE="%{${fg[blue]}%}"
452 RED="%{${fg_bold[red]}%}"
453 GREEN="%{${fg[green]}%}"
454 CYAN="%{${fg[cyan]}%}"
455 WHITE="%{${fg[white]}%}"
456 NO_COLOUR="%{${reset_color}%}"
463 NO_COLOUR="%{
\e[0m%}"
466 EXITCODE="%(?..%?%1v )"
467 PS2='`%_> ' # secondary prompt, printed when the shell needs more information to complete a command.
468 PS3='?# ' # selection prompt used within a select loop.
469 PS4='+%N:%i:%_> ' # the execution trace prompt (setopt xtrace). default: '+%N:%i>'
471 # set variable debian_chroot if running in a chroot with /etc/debian_chroot
472 if [ -z "$debian_chroot" ] && [ -r /etc/debian_chroot ]; then
473 debian_chroot=$(cat /etc/debian_chroot)
476 # don't use colors on dumb terminals (like emacs):
477 if [[ "$TERM" == dumb ]] ; then
478 PROMPT="${EXITCODE}${debian_chroot:+($debian_chroot)}%n@%m %40<...<%B%~%b%<< %# "
480 # only if $GRMLPROMPT is set (e.g. via 'GRMLPROMPT=1 zsh') use the extended prompt
481 # set variable identifying the chroot you work in (used in the prompt below)
482 if [[ -n "$GRMLPROMPT" ]]; then
483 PROMPT="${RED}${EXITCODE}${CYAN}[%j running job(s)] ${GREEN}{history#%!} ${RED}%(3L.+.) ${BLUE}%* %D
484 ${BLUE}%n${NO_COLOUR}@%m %40<...<%B%~%b%<< %# "
486 if (( EUID != 0 )); then
487 PROMPT="${RED}${EXITCODE}${WHITE}${debian_chroot:+($debian_chroot)}${BLUE}%n${NO_COLOUR}@%m %40<...<%B%~%b%<< %# " # primary prompt string
489 PROMPT="${BLUE}${EXITCODE}${WHITE}${debian_chroot:+($debian_chroot)}${RED}%n${NO_COLOUR}@%m %40<...<%B%~%b%<< %# " # primary prompt string
494 # if we are inside a grml-chroot set a specific prompt theme
495 if [ -n "$GRML_CHROOT" ] ; then
496 PROMPT="%{$fg[red]%}(CHROOT) %{$fg_bold[red]%}%n%{$fg_no_bold[white]%}@%m %40<...<%B%~%b%<< %\# "
500 # {{{ 'hash' some often used directories
501 hash -d deb=/var/cache/apt/archives
502 hash -d doc=/usr/share/doc
503 hash -d linux=/lib/modules/$(command uname -r)/build/
505 hash -d slog=/var/log/syslog
507 hash -d templ=/usr/share/doc/grml-templates
508 hash -d tt=/usr/share/doc/texttools-doc
513 if [ $UID = 0 ] ; then
514 [ -r /etc/grml/screenrc ] && alias screen='/usr/bin/screen -c /etc/grml/screenrc'
515 elif [ -r $HOME/.screenrc ] ; then
516 alias screen="/usr/bin/screen -c $HOME/.screenrc"
518 [ -r /etc/grml/screenrc_grml ] && alias screen='/usr/bin/screen -c /etc/grml/screenrc_grml'
521 if ls --help 2>/dev/null |grep -- --color= >/dev/null && [ "$TERM" != dumb ] ; then
522 alias ls='ls -b -CF --color=auto' # do we have GNU ls with color-support?
523 alias la='ls -la --color=auto'
524 alias ll='ls -l --color=auto'
525 alias lh='ls -hAl --color=auto'
526 alias l='ls -lF --color=auto'
535 alias cp='nocorrect cp' # no spelling correction on cp
536 alias mkdir='nocorrect mkdir' # no spelling correction on mkdir
537 alias mv='nocorrect mv' # no spelling correction on mv
538 alias rm='nocorrect rm' # no spelling correction on rm
543 alias swspeak="setopt singlelinezle ; unsetopt prompt_cr ; export PS1='%m%# ' ; speechd-up" # set up software synth.
545 # truecrypt; use e.g. via 'truec /dev/ice' /mnt/ice' or 'truec -i'
546 if [ -x /usr/sbin/truecrypt ] ; then
548 alias truec='truecrypt --mount-options "rw,sync,dirsync,users,uid=1000,gid=users,umask=077,utf8" '
550 alias truec='truecrypt --mount-options "rw,sync,dirsync,users,uid=1000,gid=users,umask=077" '
554 zsh-help(){print "$bg[white]$fg[black]
555 zsh-help - hints for use of zsh on grml
556 =======================================$reset_color
558 Main configuration of zsh happens in /etc/zsh/zshrc (global)
559 and /etc/skel/.zshrc which is copied to \$HOME/.zshrc once.
560 The files are part of the package grml-etc-core, if you want to
561 use them on a non-grml-system just get the tar.gz from
562 http://deb.grml.org/ or get the files from the mercurial
565 http://hg.grml.org/grml-etc-core/raw-file/tip/etc/skel/.zshrc
566 http://hg.grml.org/grml-etc-core/raw-file/tip/etc/zsh/zshrc
568 If you want to stay in sync with zsh configuration of grml
569 run 'ln -sf /etc/skel/.zshrc \$HOME/.zshrc' and configure
570 your own stuff in \$HOME/.zshrc.local. System wide configuration
571 without touching configuration files of grml can take place
572 in /etc/zsh/zshrc.local.
574 If you want to use the configuration of user grml also when
575 running as user root just run 'zshskel' which will source
576 the file /etc/skel/.zshrc.
578 For information regarding zsh start at http://grml.org/zsh/
580 Take a look at grml's zsh refcard:
581 % xpdf =(zcat /usr/share/doc/grml-docs/zsh/grml-zsh-refcard.pdf.gz)
583 Check out the main zsh refcard:
584 % $BROWSER http://www.bash2zsh.com/zsh_refcard/refcard.pdf
586 And of course visit the zsh-lovers:
589 You can adjust some options through environment variables when
590 invoking zsh without having to edit configuration files.
591 Basically meant for bash users who are not used to the power of
594 \"NOCOR=1 zsh\" => deactivate automatic correction
595 \"NOMENU=1 zsh\" => do not use menu completion (note: use strg-d for completion instead!)
596 \"NOPRECMD=1 zsh\" => disable the precmd + preexec commands (set GNU screen title)
597 \"BATTERY=1 zsh\" => activate battery status (via acpi) on right side of prompt
599 Please report wishes + bugs to the grml-team: http://grml.org/bugs/
600 Enjoy your grml system with the zsh!$reset_color"
604 if [ -r /etc/debian_version ] ; then
605 alias acs='apt-cache search'
606 alias acsh='apt-cache show'
607 alias acp='apt-cache policy'
608 alias adg="$SUDO apt-get dist-upgrade"
609 alias agi="$SUDO apt-get install"
610 alias ag="$SUDO apt-get upgrade"
611 alias au="$SUDO apt-get update"
612 alias dbp='dpkg-buildpackage'
613 alias ge='grep-excuses'
617 if [ -z "$1" ] ; then
619 $SUDO apt-get -u upgrade
621 ssh $1 $SUDO apt-get update
622 # ask before the upgrade
624 ssh $1 $SUDO apt-get --no-act upgrade
625 echo -n 'Process the upgrade?'
627 if [[ $dummy == "y" ]] ; then
628 ssh $1 $SUDO apt-get -u upgrade --yes
633 isgrmlcd && alias su="sudo su" # change to user root
634 alias tlog="tail -f /var/log/syslog" # take a look at the syslog
635 alias zshskel="source /etc/skel/.zshrc" # source skeleton zshrc
638 # if cdrecord is a symlink (to wodim) or isn't present at all warn:
639 if [ -L /usr/bin/cdrecord -o ! -x =cdrecord ] ; then
640 if [ -x =wodim ] ; then
641 alias cdrecord="echo 'cdrecord is not provided under its original name by Debian anymore.
642 See #377109 in the BTS of Debian for more details.
644 Please use the wodim binary instead' ; return 1"
650 # {{{ Use hard limits, except for a smaller stack and no core dumps
653 isgrmlcd && limit core 0 # important for a live-cd-system
657 # {{{ completion stuff
659 # Where to look for autoloaded function definitions
660 if [ -d /etc/zsh/completion.d ] ; then
661 local comp=/etc/zsh/completion.d
662 for func in $comp/*(N-.:t); . ${comp}/${func}
665 # called later (via is4 && grmlcomp)
666 # notice: use 'zstyle' for getting current settings
667 # press ^Xh (control-x h) for getting tags in context; ^X? (control-x ?) to run complete_debug with trace output
670 zstyle ':completion:*:approximate:' max-errors 'reply=( $((($#PREFIX+$#SUFFIX)/3 )) numeric )' # allow one error for every three characters typed in approximate completer
671 zstyle ':completion:*:complete:-command-::commands' ignored-patterns '*\~' # don't complete backup files as executables
672 zstyle ':completion:*:correct:*' insert-unambiguous true # start menu completion only if it could find no unambiguous initial string
673 zstyle ':completion:*:corrections' format $'%{\e[0;31m%}%d (errors: %e)%{\e[0m%}' #
674 zstyle ':completion:*:correct:*' original true #
675 zstyle ':completion:*:default' list-colors ${(s.:.)LS_COLORS} # activate color-completion(!)
676 zstyle ':completion:*:descriptions' format $'%{\e[0;31m%}completing %B%d%b%{\e[0m%}' # format on completion
677 zstyle ':completion:*:*:cd:*:directory-stack' menu yes select # complete 'cd -<tab>' with menu
678 zstyle ':completion:*:expand:*' tag-order all-expansions # insert all expansions for expand completer
679 zstyle ':completion:*:history-words' list false #
680 zstyle ':completion:*:history-words' menu yes # activate menu
681 zstyle ':completion:*:history-words' remove-all-dups yes # ignore duplicate entries
682 zstyle ':completion:*:history-words' stop yes #
683 zstyle ':completion:*:*:linda:*' file-patterns '*.deb' # complete debian packages for command 'linda'
684 zstyle ':completion:*:*:lintian:*' file-patterns '*.deb' # complete debian packages for command 'lintian'
685 zstyle ':completion:*' matcher-list 'm:{a-z}={A-Z}' # match uppercase from lowercase
686 zstyle ':completion:*:matches' group 'yes' # separate matches into groups
687 zstyle ':completion:*' group-name ''
688 if [[ -z "$NOMENU" ]] ; then
689 zstyle ':completion:*' menu select=5 # if there are more than 5 options allow selecting from a menu
691 setopt no_auto_menu # don't use any menus at all
693 zstyle ':completion:*:messages' format '%d' #
694 zstyle ':completion:*:options' auto-description '%d' #
695 zstyle ':completion:*:options' description 'yes' # describe options in full
696 zstyle ':completion:*:processes' command 'ps -au$USER' # on processes completion complete all user processes
697 zstyle ':completion:*:*:-subscript-:*' tag-order indexes parameters # offer indexes before parameters in subscripts
698 zstyle ':completion:*' verbose true # provide verbose completion information
699 zstyle ':completion:*:warnings' format $'%{\e[0;31m%}No matches for:%{\e[0m%} %d' # set format for warnings
700 zstyle ':completion:*:*:zcompile:*' ignored-patterns '(*~|*.zwc)' # define files to ignore for zcompile
701 zstyle ':completion:correct:' prompt 'correct to: %e' #
702 zstyle ':completion::(^approximate*):*:functions' ignored-patterns '_*' # Ignore completion functions for commands you don't have:
704 # complete manual by their section
705 zstyle ':completion:*:manuals' separate-sections true
706 zstyle ':completion:*:manuals.*' insert-sections true
707 zstyle ':completion:*:man:*' menu yes select
710 # run rehash on completion so new installed program are found automatically:
712 (( CURRENT == 1 )) && rehash
713 return 1 # Because we didn't really complete anything
715 # some people don't like the automatic correction - so run 'NOCOR=1 zsh' to deactivate it
716 if [[ -n "$NOCOR" ]] ; then
717 zstyle ':completion:*' completer _oldlist _expand _force_rehash _complete
718 setopt nocorrect # do not try to correct the spelling if possible
720 # zstyle ':completion:*' completer _oldlist _expand _force_rehash _complete _correct _approximate
721 setopt correct # try to correct the spelling if possible
722 zstyle -e ':completion:*' completer '
723 if [[ $_last_try != "$HISTNO$BUFFER$CURSOR" ]]; then
724 _last_try="$HISTNO$BUFFER$CURSOR"
725 reply=(_complete _match _prefix)
727 if [[ $words[1] = (rm|mv) ]]; then
730 reply=(_oldlist _expand _force_rehash _complete _correct _approximate)
734 # zstyle ':completion:*' completer _complete _correct _approximate
735 # zstyle ':completion:*' expand prefix suffix
737 # automatic rehash? Credits go to Frank Terbeck
738 # function my_accept () {
740 # [[ -z ${BUFFER} ]] && zle accept-line && return
741 # buf=( ${(z)BUFFER} )
742 # [[ -z ${commands[${buf[1]}]} ]] && rehash
746 # bindkey "^M" my_accept
748 # command for process lists, the local web server details and host completion
749 hosts=(`hostname` grml.org)
750 zstyle '*' hosts $hosts
751 zstyle ':completion:*:urls' local 'www' '/var/www/' 'public_html'
754 [ -d $ZSHDIR/cache ] && zstyle ':completion:*' use-cache yes && \
755 zstyle ':completion::complete:*' cache-path $ZSHDIR/cache/
757 # use ~/.ssh/known_hosts for completion [does not work with hashing of new ssh versions anymore]
758 if [ -f "$HOME/.ssh/known_hosts" ] ; then
759 hosts=(${${${${(f)"$(<$HOME/.ssh/known_hosts)"}:#[\|]*}%%\ *}%%,*})
760 zstyle ':completion:*:hosts' hosts $hosts
763 # use generic completion system for programs not yet defined:
764 compdef _gnu_generic tail head feh cp mv gpg df stow uname ipacsum fetchipac
766 # see upgrade function in this file
767 compdef _hosts upgrade
773 # people should use 'grml-x'!
775 if [ -e /etc/X11/xorg.conf ] ; then
776 [ -x /usr/bin/startx ] && /usr/bin/startx || /usr/X11R6/bin/startx
778 echo "Please use the script \"grml-x\" for starting the X Window System
779 because there does not exist /etc/X11/xorg.conf yet.
780 If you want to use startx anyway please call \"/usr/bin/startx\"."
786 if [ -e /etc/X11/xorg.conf ] ; then
787 [ -x /usr/bin/xinit ] && /usr/bin/xinit || /usr/X11R6/bin/xinit
789 echo "Please use the script \"grml-x\" for starting the X Window System.
790 because there does not exist /etc/X11/xorg.conf yet.
791 If you want to use xinit anyway please call \"/usr/bin/xinit\"."
796 if [ -x /usr/sbin/915resolution ] ; then
797 alias 855resolution='echo -e "Please use 915resolution as resolution modify tool for Intel graphic chipset."; return -1'
800 alias grml-version='cat /etc/grml_version'
802 if [ -x /usr/sbin/rebuildfstab ] ; then
803 alias grml-rebuildfstab='rebuildfstab -v -r -config'
808 # {{{ now run the functions
810 is4 && isgrml && grmlstuff
815 [ -r /etc/zsh/keephack ] && is4 && source /etc/zsh/keephack
818 # {{{ wonderful idea of using "e" glob qualifier by Peter Stephenson
819 # You use it as follows:
820 # $ NTREF=/reference/file
822 # This lists all the files in the current directory newer than the reference file.
823 # You can also specify the reference file inline; note quotes:
824 # $ ls -l *(e:'nt ~/.zshenv':)
829 [[ $REPLY -nt $NTREF ]]
833 # shell functions {{{
834 setenv() { typeset -x "${1}${1:+=}${(@)argv[2,$#]}" } # csh compatibility
835 freload() { while (( $# )); do; unfunction $1; autoload -U $1; shift; done }
838 if type -p qma &>/dev/null ; then
839 manzsh() { qma zshall "$1" }
841 manzsh() { /usr/bin/man zshall | vim -c "se ft=man| se hlsearch" +/"$1" - ; }
842 # manzsh() { /usr/bin/man zshall | most +/"$1" ; }
843 # manzsh() { man zshall | $MYLESS -p $1 ; }
846 # use "dchange <package-name>" to view Debian's changelog of the package:
848 if [ -r /usr/share/doc/${1}/changelog.Debian.gz ] ; then
849 most /usr/share/doc/${1}/changelog.Debian.gz
851 if [ -r /usr/share/doc/${1}/changelog.gz ] ; then
852 most /usr/share/doc/${1}/changelog.gz
854 echo "No changelog for package $1 found, sorry."
859 _dchange() { _files -W /usr/share/doc -/ }
860 compdef _dchange dchange
862 # use "uchange <package-name>" to view upstream's changelog of the package:
864 if [ -r /usr/share/doc/${1}/changelog.gz ] ; then
865 most /usr/share/doc/${1}/changelog.gz
867 echo "No changelog for package $1 found, sorry."
871 _uchange() { _files -W /usr/share/doc -/ }
872 compdef _uchange uchange
874 # edit alias via zle:
876 [ -z "$1" ] && { echo "Usage: edalias <alias_to_edit>" ; return 1 } || vared aliases'[$1]' ;
878 compdef _aliases edalias
880 # edit function via zle:
882 [ -z "$1" ] && { echo "Usage: edfun <function_to_edit>" ; return 1 } || zed -f "$1" ;
884 compdef _functions edfun
886 # use it e.g. via 'Restart apache2'
887 if [ -d /etc/init.d ] ; then
888 for i in Start Restart Stop Force-Reload Reload ; do
889 eval "$i() { $SUDO /etc/init.d/\$1 ${i:l} \$2 ; }"
891 # now the completion for this:
892 compctl -g "$(echo /etc/init.d/*(:t))" Start Restart Stop Force-Reload Reload
895 # provide useful information on globbing
902 p named pipes (FIFOs)
903 * executable plain files (0100)
904 % device files (character or block special)
905 %b block special files
906 %c character special files
907 r owner-readable files (0400)
908 w owner-writable files (0200)
909 x owner-executable files (0100)
910 A group-readable files (0040)
911 I group-writable files (0020)
912 E group-executable files (0010)
913 R world-readable files (0004)
914 W world-writable files (0002)
915 X world-executable files (0001)
916 s setuid files (04000)
917 S setgid files (02000)
918 t files with the sticky bit (01000)
920 print *(m-1) # Files modified up to a day ago
921 print *(a1) # Files accessed a day ago
922 print *(@) # Just symlinks
923 print *(Lk+50) # Files bigger than 50 kilobytes
924 print *(Lk-50) # Files smaller than 50 kilobytes
925 print **/*.c # All *.c files recursively starting in \$PWD
926 print **/*.c~file.c # Same as above, but excluding 'file.c'
927 print (foo|bar).* # Files starting with 'foo' or 'bar'
928 print *~*.* # All Files that do not contain a dot
929 chmod 644 *(.^x) # make all plain non-executable files publically readable
930 print -l *(.c|.h) # Lists *.c and *.h
931 print **/*(g:users:) # Recursively match all files that are owned by group 'users'
932 echo /proc/*/cwd(:h:t:s/self//) # Analogous to >ps ax | awk '{print $1}'<"
934 alias help-zshglob=H-Glob
936 type -p qma &>/dev/null && alias ?='qma zshall'
938 # grep for running process, like: 'any vim'
940 if [ -z "$1" ] ; then
941 echo "any - grep for process(es) by keyword" >&2
942 echo "Usage: any <keyword>" >&2 ; return 1
945 local LENGTH=$(expr length $STRING)
946 local FIRSCHAR=$(echo $(expr substr $STRING 1 1))
947 local REST=$(echo $(expr substr $STRING 2 $LENGTH))
948 ps xauwww| grep [$FIRSCHAR]$REST
954 # {{{ make sure our environment is clean regarding colors
955 for color in BLUE RED GREEN CYAN WHITE ; unset $color
958 # source another config file if present {{{
959 if [ -r /etc/zsh/zshrc.local ]; then
960 source /etc/zsh/zshrc.local
964 # "persistent history" {{{
965 # just write important commands you always need to ~/.important_commands
966 if [ -r ~/.important_commands ] ; then
967 fc -R ~/.important_commands
971 ## END OF FILE #################################################################
972 # vim:foldmethod=marker