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: Sam Dez 22 19:17:27 CET 2007 [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 # zsh-refcard-tag documentation: {{{
16 # You may notice strange looking comments in the zshrc (and ~/.zshrc as
17 # well). These are there for a purpose. grml's zsh-refcard can now be
18 # automatically generated from the contents of the actual configuration
19 # files. However, we need a little extra information on which comments
20 # and what lines of code to take into account (and for what purpose).
22 # Here is what they mean:
24 # List of tags (comment types) used:
25 # #a# Next line contains an important alias, that should
26 # be included in the grml-zsh-refcard.
27 # (placement tag: @@INSERT-aliases@@)
28 # #f# Next line contains the beginning of an important function.
29 # (placement tag: @@INSERT-functions@@)
30 # #v# Next line contains an important variable.
31 # (placement tag: @@INSERT-variables@@)
32 # #k# Next line contains an important keybinding.
33 # (placement tag: @@INSERT-keybindings@@)
34 # #d# Hashed directories list generation:
35 # start denotes the start of a list of 'hash -d'
37 # end denotes its end.
38 # (placement tag: @@INSERT-hasheddirs@@)
39 # #A# Abbreviation expansion list generation:
40 # start denotes the beginning of abbreviations.
41 # end denotes their end.
42 # Lines within this section that end in '#d .*' provide
43 # extra documentation to be included in the refcard.
44 # (placement tag: @@INSERT-abbrev@@)
45 # #m# This tag allows you to manually generate refcard entries
46 # for code lines that are hard/impossible to parse.
48 # #m# k ESC-h Call the run-help function
49 # That would add a refcard entry in the keybindings table
50 # for 'ESC-h' with the given comment.
51 # So the syntax is: #m# <section> <argument> <comment>
52 # #o# This tag lets you insert entries to the 'other' hash.
53 # Generally, this should not be used. It is there for
54 # things that cannot be done easily in another way.
55 # (placement tag: @@INSERT-other-foobar@@)
57 # All of these tags (except for m and o) take two arguments, the first
58 # within the tag, the other after the tag:
60 # #<tag><section># <comment>
62 # Where <section> is really just a number, which are defined by the
63 # @secmap array on top of 'genrefcard.pl'. The reason for numbers
64 # instead of names is, that for the reader, the tag should not differ
65 # much from a regular comment. For zsh, it is a regular comment indeed.
66 # The numbers have got the following meanings:
75 # So, the following will add an entry to the 'functions' table in the
76 # 'system' section, with a (hopefully) descriptive comment:
77 # #f1# Edit an alias via zle
80 # It will then show up in the @@INSERT-aliases-system@@ replacement tag
81 # that can be found in 'grml-zsh-refcard.tex.in'.
82 # If the section number is omitted, the 'default' section is assumed.
83 # Furthermore, in 'grml-zsh-refcard.tex.in' @@INSERT-aliases@@ is
84 # exactly the same as @@INSERT-aliases-default@@. If you want a list of
85 # *all* aliases, for example, use @@INSERT-aliases-all@@.
89 # just execute 'ZSH_PROFILE_RC=1 zsh' and run 'zprof' to get the details
90 if [[ -n $ZSH_PROFILE_RC ]] ; then
95 # utility functions {{{
96 # this function checks if a command exists and returns either true
97 # or false. This avoids using 'which' and 'whence', which will
98 # avoid problems with aliases for which on certain weird systems. :-)
102 if [[ ${1} == '-c' ]] ; then
109 if (( ${#argv} != 1 )) ; then
110 printf 'usage: check_com [-c] <command>\n' >&2
114 if (( comonly > 0 )) ; then
115 [[ -n ${commands[$1]} ]] && return 0
119 if [[ -n ${commands[$1]} ]] \
120 || [[ -n ${functions[$1]} ]] \
121 || [[ -n ${aliases[$1]} ]] \
122 || [[ -n ${reswords[(r)$1]} ]] ; then
130 # creates an alias and precedes the command with
131 # sudo if $EUID is not zero.
133 local only=0 ; local multi=0
134 while [[ ${1} == -* ]] ; do
138 (--) shift ; break ;;
140 printf 'usage: salias [-h|-o|-a] <alias-expression>\n'
141 printf ' -h shows this help text.\n'
142 printf ' -a replace '\'' ; '\'' sequences with '\'' ; sudo '\''.\n'
143 printf ' be careful using this option.\n'
144 printf ' -o only sets an alias if a preceding sudo would be needed.\n'
147 (*) printf "unkown option: '%s'\n" "${1}" ; return 1 ;;
152 if (( ${#argv} > 1 )) ; then
153 printf 'Too many arguments %s\n' "${#argv}"
157 key="${1%%\=*}" ; val="${1#*\=}"
158 if (( EUID == 0 )) && (( only == 0 )); then
159 alias -- "${key}=${val}"
160 elif (( EUID > 0 )) ; then
161 (( multi > 0 )) && val="${val// ; / ; sudo }"
162 alias -- "${key}=sudo ${val}"
168 # Check if we can read given files and source those we can.
170 if (( ${#argv} < 1 )) ; then
171 printf 'usage: xsource FILE(s)...\n' >&2
175 while (( ${#argv} > 0 )) ; do
176 [[ -r ${1} ]] && source ${1}
182 # Check if we can read a given file and 'cat(1)' it.
184 if (( ${#argv} != 1 )) ; then
185 printf 'usage: xcat FILE\n' >&2
189 [[ -r ${1} ]] && cat ${1}
193 # Remove these functions again, they are of use only in these
194 # setup files. This should be called at the end of .zshrc.
197 funcs=(check_com salias xcat xsource xunfunction)
199 for func in $funcs ; do
200 [[ -n ${functions[$func]} ]] \
208 if [[ -z "$LANG" ]] ; then
209 xsource "/etc/default/locale"
212 export LANG=${LANG:-en_US.iso885915}
213 for var in LC_ALL LC_MESSAGES ; do
214 [[ -n ${(P)var} ]] && export $var
217 xsource "/etc/sysconfig/keyboard"
219 TZ=$(xcat /etc/timezone)
222 # check for potentially old files in 'completion.d' {{{
224 xof=(/etc/zsh/completion.d/*~/etc/zsh/completion.d/_*(N))
225 if (( ${#xof} > 0 )) ; then
226 printf '\n -!- INFORMATION\n\n'
227 printf ' -!- %s file(s) not starting with an underscore (_) found in\n' ${#xof}
228 printf ' -!- /etc/zsh/completion.d/.\n\n'
229 printf ' -!- While this has been the case in old versions of grml-etc-core,\n'
230 printf ' -!- recent versions of the grml-zsh-setup have all these files rewritten\n'
231 printf ' -!- and renamed. Furthermore, the grml-zsh-setup will *only* add files\n'
232 printf ' -!- named _* to that directory.\n\n'
233 printf ' -!- If you added functions to completion.d yourself, please consider\n'
234 printf ' -!- moving them to /etc/zsh/functions.d/. Files in that directory, not\n'
235 printf ' -!- starting with an underscore are marked for automatic loading\n'
236 printf ' -!- by default (so that is quite convenient).\n\n'
237 printf ' -!- If there are files *not* starting with an underscore from an older\n'
238 printf ' -!- grml-etc-core in completion.d, you may safely remove them.\n\n'
239 printf ' -!- Delete the files for example via running:\n\n'
240 printf " rm ${xof}\n\n"
241 printf ' -!- Note, that this message will *not* go away, unless you yourself\n'
242 printf ' -!- resolve the situation manually.\n\n'
243 BROKEN_COMPLETION_DIR=1
248 # {{{ check for version/system
249 # check for versions (compatibility reasons)
250 if autoload is-at-least && is-at-least 2>/dev/null ; then
251 is4() { is-at-least 4 }
252 is41() { is-at-least 4.1 }
253 is42() { is-at-least 4.2 }
256 [[ $ZSH_VERSION == 4.* ]] && return 0
260 [[ $ZSH_VERSION == 4.<2->* ]] && return 0
265 #f1# Checks whether or not you're running grml
267 [[ -f /etc/grml_version ]] && return 0
271 #f1# Checks whether or not you're running a grml cd
273 [[ -f /etc/grml_cd ]] && return 0
278 #f1# Checks whether or not you're running grml-small
280 [[ ${${${(f)"$(</etc/grml_version)"}%% *}##*-} == 'small' ]] && return 0 ; return 1
283 isgrmlsmall() { return 1 }
286 #f1# are we running within an utf environment?
288 case "$LANG $CHARSET $LANGUAGE" in
295 # check for user, if not running as root set $SUDO to sudo
296 (( EUID != 0 )) && SUDO='sudo' || SUDO=''
298 # change directory to home on first invocation of zsh
299 # important for rungetty -> autologin
300 # Thanks go to Bart Schaefer!
301 isgrml && checkhome() {
302 if [[ -z "$ALREADY_DID_CD_HOME" ]] ; then
303 export ALREADY_DID_CD_HOME=$HOME
309 # {{{ set some variables
310 if check_com -c vim ; then
312 export EDITOR=${EDITOR:-vim}
314 export EDITOR=${EDITOR:-vi}
318 (( ${+PAGER} )) || export PAGER="less"
321 export MAIL=${MAIL:-/var/mail/$USER}
323 # if we don't set $SHELL then aterm, rxvt,.. will use /bin/sh or /bin/bash :-/
324 export SHELL='/bin/zsh'
326 # color setup for ls:
327 check_com -c dircolors && eval $(dircolors -b)
329 # set width of man pages to 80 for more convenient reading
330 # (( ${+MANWIDTH} )) || export MANWIDTH=80
332 # Search path for the cd command
335 # completion functions go to /etc/zsh/completion.d
336 # function files may be put into /etc/zsh/functions.d, from where they
337 # will be automatically autoloaded.
338 if [[ -n "$BROKEN_COMPLETION_DIR" ]] ; then
339 print 'Warning: not setting completion directories because broken files have been found.' >&2
341 [[ -d /etc/zsh/completion.d ]] && fpath+=( /etc/zsh/completion.d )
342 if [[ -d /etc/zsh/functions.d ]] ; then
343 fpath+=( /etc/zsh/functions.d )
344 for func in /etc/zsh/functions.d/[^_]*[^~] ; do
345 autoload -U ${func:t}
350 # automatically remove duplicates from these arrays
351 typeset -U path cdpath fpath manpath
355 if [[ "$TERM" != emacs ]] ; then
356 [[ -z "$terminfo[kdch1]" ]] || bindkey -M emacs "$terminfo[kdch1]" delete-char
357 [[ -z "$terminfo[khome]" ]] || bindkey -M emacs "$terminfo[khome]" beginning-of-line
358 [[ -z "$terminfo[kend]" ]] || bindkey -M emacs "$terminfo[kend]" end-of-line
359 [[ -z "$terminfo[kdch1]" ]] || bindkey -M vicmd "$terminfo[kdch1]" vi-delete-char
360 [[ -z "$terminfo[khome]" ]] || bindkey -M vicmd "$terminfo[khome]" vi-beginning-of-line
361 [[ -z "$terminfo[kend]" ]] || bindkey -M vicmd "$terminfo[kend]" vi-end-of-line
362 [[ -z "$terminfo[cuu1]" ]] || bindkey -M viins "$terminfo[cuu1]" vi-up-line-or-history
363 [[ -z "$terminfo[cuf1]" ]] || bindkey -M viins "$terminfo[cuf1]" vi-forward-char
364 [[ -z "$terminfo[kcuu1]" ]] || bindkey -M viins "$terminfo[kcuu1]" vi-up-line-or-history
365 [[ -z "$terminfo[kcud1]" ]] || bindkey -M viins "$terminfo[kcud1]" vi-down-line-or-history
366 [[ -z "$terminfo[kcuf1]" ]] || bindkey -M viins "$terminfo[kcuf1]" vi-forward-char
367 [[ -z "$terminfo[kcub1]" ]] || bindkey -M viins "$terminfo[kcub1]" vi-backward-char
369 [[ "$terminfo[kcuu1]" == $'\eO'* ]] && bindkey -M viins "${terminfo[kcuu1]/O/[}" vi-up-line-or-history
370 [[ "$terminfo[kcud1]" == $'\eO'* ]] && bindkey -M viins "${terminfo[kcud1]/O/[}" vi-down-line-or-history
371 [[ "$terminfo[kcuf1]" == $'\eO'* ]] && bindkey -M viins "${terminfo[kcuf1]/O/[}" vi-forward-char
372 [[ "$terminfo[kcub1]" == $'\eO'* ]] && bindkey -M viins "${terminfo[kcub1]/O/[}" vi-backward-char
373 [[ "$terminfo[khome]" == $'\eO'* ]] && bindkey -M viins "${terminfo[khome]/O/[}" beginning-of-line
374 [[ "$terminfo[kend]" == $'\eO'* ]] && bindkey -M viins "${terminfo[kend]/O/[}" end-of-line
375 [[ "$terminfo[khome]" == $'\eO'* ]] && bindkey -M emacs "${terminfo[khome]/O/[}" beginning-of-line
376 [[ "$terminfo[kend]" == $'\eO'* ]] && bindkey -M emacs "${terminfo[kend]/O/[}" end-of-line
379 ## keybindings (run 'bindkeys' for details, more details via man zshzle)
380 # use emacs style per default:
385 #if [[ "$TERM" == screen ]] ; then
386 bindkey '\e[1~' beginning-of-line # home
387 bindkey '\e[4~' end-of-line # end
388 bindkey '\e[A' up-line-or-search # cursor up
389 bindkey '\e[B' down-line-or-search # <ESC>-
390 bindkey '^x' history-beginning-search-backward # alternative ways of searching the shell history
391 # bindkey -s '^L' "|less\n" # ctrl-L pipes to less
392 # bindkey -s '^B' " &\n" # ctrl-B runs it in the background
393 # if terminal type is set to 'rxvt':
394 bindkey '\e[7~' beginning-of-line # home
395 bindkey '\e[8~' end-of-line # end
398 # insert unicode character
399 # usage example: 'ctrl-x i' 00A7 'ctrl-x i' will give you an §
400 # See for example http://unicode.org/charts/ for unicode characters code
401 autoload insert-unicode-char
402 zle -N insert-unicode-char
403 #k# Insert Unicode character
404 bindkey '^Xi' insert-unicode-char
406 # just type 'cd ...' to get 'cd ../..'
407 # rationalise-dot() {
408 # if [[ $LBUFFER == *.. ]] ; then
414 # zle -N rationalise-dot
415 # bindkey . rationalise-dot
417 # bindkey '\eq' push-line-or-edit
420 # a generic accept-line wrapper {{{
422 # This widget can prevent unwanted autocorrections from command-name
423 # to _command-name, rehash automatically on enter and call any number
424 # of builtin and user-defined widgets in different contexts.
426 # For a broader description, see:
427 # <http://bewatermyfriend.org/posts/2007/12-26.11-50-38-tooltime.html>
429 # The code is imported from the file 'zsh/functions/accept-line' from
430 # <http://ft.bewatermyfriend.org/comp/zsh/zsh-dotfiles.tar.bz2>, which
431 # distributed under the same terms as zsh itself.
433 # A newly added command will may not be found or will cause false
434 # correction attempts, if you got auto-correction set. By setting the
435 # following style, we force accept-line() to rehash, if it cannot
436 # find the first word on the command line in the $command[] hash.
437 zstyle ':acceptline:*' rehash true
439 function Accept-Line() {
440 setopt localoptions noksharrays
445 zstyle -a ":acceptline:${alcontext}" actions subs
447 (( ${#subs} < 1 )) && return 0
450 for sub in ${subs} ; do
451 [[ ${sub} == 'accept-line' ]] && sub='.accept-line'
454 (( aldone > 0 )) && break
458 function Accept-Line-getdefault() {
461 zstyle -s ":acceptline:${alcontext}" default_action default_action
462 case ${default_action} in
464 printf ".accept-line"
467 printf ${default_action}
472 function accept-line() {
473 setopt localoptions noksharrays
476 local buf com fname format msg default_action
480 cmdline=(${(z)BUFFER})
484 zstyle -t ":acceptline:${alcontext}" rehash \
485 && [[ -z ${commands[$com]} ]] \
488 if [[ -n ${reswords[(r)$com]} ]] \
489 || [[ -n ${aliases[$com]} ]] \
490 || [[ -n ${functions[$com]} ]] \
491 || [[ -n ${builtins[$com]} ]] \
492 || [[ -n ${commands[$com]} ]] ; then
494 # there is something sensible to execute, just do it.
498 default_action=$(Accept-Line-getdefault)
499 zstyle -T ":acceptline:${alcontext}" call_default \
500 && zle ${default_action}
504 if [[ -o correct ]] \
505 || [[ -o correctall ]] \
506 && [[ -n ${functions[$fname]} ]] ; then
508 # nothing there to execute but there is a function called
509 # _command_name; a completion widget. Makes no sense to
510 # call it on the commandline, but the correct{,all} options
511 # will ask for it nevertheless, so warn the user.
512 if [[ ${LASTWIDGET} == 'accept-line' ]] ; then
513 # Okay, we warned the user before, he called us again,
514 # so have it his way.
518 default_action=$(Accept-Line-getdefault)
519 zstyle -T ":acceptline:${alcontext}" call_default \
520 && zle ${default_action}
524 # prepare warning message for the user, configurable via zstyle.
525 zstyle -s ":acceptline:${alcontext}" compwarnfmt msg
527 if [[ -z ${msg} ]] ; then
528 msg="%c will not execute and completion %f exists."
531 zformat -f msg "${msg}" "c:${com}" "f:${fname}"
535 elif [[ -n ${buf//[$' \t\n']##/} ]] ; then
536 # If we are here, the commandline contains something that is not
537 # executable, which is neither subject to _command_name correction
538 # and is not empty. might be a variable assignment
542 default_action=$(Accept-Line-getdefault)
543 zstyle -T ":acceptline:${alcontext}" call_default \
544 && zle ${default_action}
548 # If we got this far, the commandline only contains whitespace, or is empty.
552 default_action=$(Accept-Line-getdefault)
553 zstyle -T ":acceptline:${alcontext}" call_default \
554 && zle ${default_action}
562 # power completion - abbreviation expansion {{{
563 # power completion / abbreviation expansion / buffer expansion
564 # see http://zshwiki.org/home/examples/zleiab for details
565 # less risky than the global aliases but powerful as well
566 # just type the abbreviation key and afterwards ',.' to expand it
569 setopt interactivecomments
571 # key # value (#d additional doc string)
577 'G' '|& grep --color=auto'
579 'Hl' ' --help |& less -r' #d (Display help in pager)
583 'N' '&>/dev/null' #d (No Output)
584 'R' '| tr A-z N-za-m' #d (ROT13)
590 'hide' "echo -en '\033]50;nil2\007'"
591 'tiny' 'echo -en "\033]50;-misc-fixed-medium-r-normal-*-*-80-*-*-c-*-iso8859-15\007"'
592 'small' 'echo -en "\033]50;6x10\007"'
593 'medium' 'echo -en "\033]50;-misc-fixed-medium-r-normal--13-120-75-75-c-80-iso8859-15\007"'
594 'default' 'echo -e "\033]50;-misc-fixed-medium-r-normal-*-*-140-*-*-c-*-iso8859-15\007"'
595 'large' 'echo -en "\033]50;-misc-fixed-medium-r-normal-*-*-150-*-*-c-*-iso8859-15\007"'
596 'huge' 'echo -en "\033]50;-misc-fixed-medium-r-normal-*-*-210-*-*-c-*-iso8859-15\007"'
597 'smartfont' 'echo -en "\033]50;-artwiz-smoothansi-*-*-*-*-*-*-*-*-*-*-*-*\007"'
598 'semifont' 'echo -en "\033]50;-misc-fixed-medium-r-semicondensed-*-*-120-*-*-*-*-iso8859-15\007"'
602 'co' "./configure && make && sudo make install"
603 'CH' "./configure --help"
604 'conkeror' 'firefox -chrome chrome://conkeror/content'
606 'lad' $'ls -d .*(/)\n# only show dot-directories'
607 'lsa' $'ls -a .*(.)\n# only show dot-files'
608 'lss' $'ls -l *(s,S,t)\n# only files with setgid/setuid/sticky flag'
609 'lsl' $'ls -l *(@[1,10])\n# only symlinks'
610 'lsx' $'ls -l *(*[1,10])\n# only executables'
611 'lsw' $'ls -ld *(R,W,X.^ND/)\n# world-{readable,writable,executable} files'
612 'lsbig' $'ls -flh *(.OL[1,10])\n# display the biggest files'
613 'lsd' $'ls -d *(/)\n# only show directories'
614 'lse' $'ls -d *(/^F)\n# only show empty directories'
615 'lsnew' $'ls -rl *(D.om[1,10])\n# display the newest files'
616 'lsold' $'ls -rtlh *(D.om[-11,-1])\n # display the oldest files'
617 'lssmall' $'ls -Srl *(.oL[1,10])\n# display the smallest files'
619 '600' 'chmod u+rw-x,g-rwx,o-rwx'
621 '700' 'chmod u+rwx,g-rwx,o-rwx'
622 'r--' 'chmod u+r-wx,g-rwx,o-rwx'
623 '644' $'chmod u+rw-x,g+r-wx,o+r-wx\n # 4=r,2=w,1=x'
624 '755' 'chmod u+rwx,g+r-w+x,o+r-w+x'
626 'cmplayer' 'mplayer -vo -fs -zoom fbdev'
627 'fbmplayer' 'mplayer -vo -fs -zoom fbdev'
628 'fblinks' 'links2 -driver fb'
629 'insecssh' 'ssh -o "StrictHostKeyChecking=no" -o "UserKnownHostsFile=/dev/null"'
630 'insecscp' 'scp -o "StrictHostKeyChecking=no" -o "UserKnownHostsFile=/dev/null"'
631 'fori' 'for i ({..}) { }'
634 'se' 'setopt interactivecomments'
635 'va' 'valac --vapidir=../vapi/ --pkg=gtk+-2.0 gtktest.vala'
636 'fb2' '=mplayer -vo fbdev -fs -zoom 1>/dev/null -xy 2'
637 'fb3' '=mplayer -vo fbdev -fs -zoom 1>/dev/null -xy 3'
639 'D' 'export DISPLAY=:0.0'
640 'mp' 'mplayer -vo xv -fs -zoom'
645 matched_chars='[.-|_a-zA-Z0-9]#'
646 LBUFFER=${LBUFFER%%(#m)[.-|_a-zA-Z0-9]#}
647 LBUFFER+=${abk[$MATCH]:-$MATCH}
651 bindkey ",." globalias
655 autoload -U zmv # who needs mmv or rename?
656 autoload history-search-end
658 # we don't want to quote/espace URLs on our own...
659 # if autoload -U url-quote-magic ; then
660 # zle -N self-insert url-quote-magic
661 # zstyle ':url-quote-magic:*' url-metas '*?[]^()~#{}='
663 # print 'Notice: no url-quote-magic available :('
665 alias url-quote='autoload -U url-quote-magic ; zle -N self-insert url-quote-magic'
667 #m# k ESC-h Call \kbd{run-help} for the 1st word on the command line
668 alias run-help >&/dev/null && unalias run-help
669 autoload run-help # use via 'esc-h'
672 if autoload -U compinit && compinit 2>/dev/null ; then
673 compinit 2>/dev/null || print 'Notice: no compinit available :('
675 print 'Notice: no compinit available :('
680 is4 && autoload -U zed # use ZLE editor to edit a file or function
683 for mod in complist deltochar mathfunc ; do
684 zmodload -i zsh/${mod} 2>/dev/null || print "Notice: no ${mod} available :("
687 # autoload zsh modules when they are referenced
696 while (( ${#tmpargs} > 0 )) ; do
697 zmodload -${tmpargs[1]} zsh/${tmpargs[2]} ${tmpargs[2]}
703 if is4 && autoload -U insert-files && zle -N insert-files ; then
705 bindkey "^Xf" insert-files # C-x-f
708 bindkey ' ' magic-space # also do history expansion on space
709 #k# Trigger menu-complete
710 bindkey '\ei' menu-complete # menu completion via esc-i
712 # press esc-e for editing command line in $EDITOR or $VISUAL
713 if is4 && autoload -U edit-command-line && zle -N edit-command-line ; then
714 #k# Edit the current line in \kbd{\$EDITOR}
715 bindkey '\ee' edit-command-line
718 if is4 && [[ -n ${(k)modules[zsh/complist]} ]] ; then
719 #k# menu selection: pick item but stay in the menu
720 bindkey -M menuselect '\e^M' accept-and-menu-complete
722 # use the vi navigation keys (hjkl) besides cursor keys in menu completion
723 #bindkey -M menuselect 'h' vi-backward-char # left
724 #bindkey -M menuselect 'k' vi-up-line-or-history # up
725 #bindkey -M menuselect 'l' vi-forward-char # right
726 #bindkey -M menuselect 'j' vi-down-line-or-history # bottom
728 # accept a completion and try to complete again by using menu
729 # completion; very useful with completing directories
730 # by using 'undo' one's got a simple file browser
731 bindkey -M menuselect '^o' accept-and-infer-next-history
734 # press "ctrl-e d" to insert the actual date in the form yyyy-mm-dd
735 _bkdate() { BUFFER="$BUFFER$(date '+%F')"; CURSOR=$#BUFFER; }
738 #k# Insert a timestamp on the command line (yyyy-mm-dd)
739 bindkey '^Ed' _bkdate
741 # press esc-m for inserting last typed word again (thanks to caphuso!)
742 insert-last-typed-word() { zle insert-last-word -- 0 -1 };
743 zle -N insert-last-typed-word;
745 #k# Insert last typed word
746 bindkey "\em" insert-last-typed-word
748 # set command prediction from history, see 'man 1 zshcontrib'
749 # is4 && autoload -U predict-on && \
750 # zle -N predict-on && \
751 # zle -N predict-off && \
752 # bindkey "^X^Z" predict-on && \
753 # bindkey "^Z" predict-off
755 #k# Shortcut for \kbd{fg<enter>}
756 bindkey -s '^z' "fg\n"
758 # press ctrl-q to quote line:
760 # zle beginning-of-line
762 # # RBUFFER="'$RBUFFER'"
763 # RBUFFER=${(q)RBUFFER}
766 # zle -N mquote && bindkey '^q' mquote
768 # run command line as user root via sudo:
769 sudo-command-line() {
770 [[ -z $BUFFER ]] && zle up-history
771 [[ $BUFFER != sudo\ * ]] && BUFFER="sudo $BUFFER"
773 zle -N sudo-command-line
775 #k# Put the current command line into a \kbd{sudo} call
776 bindkey "^Os" sudo-command-line
778 ### jump behind the first word on the cmdline.
779 ### useful to add options.
780 function jump_after_first_word() {
784 if (( ${#words} <= 1 )) ; then
787 CURSOR=${#${words[1]}}
790 zle -N jump_after_first_word
792 bindkey '^x1' jump_after_first_word
796 # {{{ set some important options
797 # Please update these tags, if you change the umask settings below.
799 #o# r_umaskstr rwxrwxr-x
801 #o# umaskstr rwxr-xr-x
802 (( EUID != 0 )) && umask 002 || umask 022
805 setopt append_history # append history list to the history file (important for multiple parallel zsh sessions!)
806 is4 && setopt SHARE_HISTORY # import new commands from the history file also in other zsh-session
807 setopt extended_history # save each command's beginning timestamp and the duration to the history file
808 is4 && setopt histignorealldups # If a new command line being added to the history
809 # list duplicates an older one, the older command is removed from the list
810 setopt histignorespace # remove command lines from the history list when
811 # the first character on the line is a space
812 # setopt histallowclobber # add `|' to output redirections in the history
813 # setopt NO_clobber # warning if file exists ('cat /dev/null > ~/.zshrc')
814 setopt auto_cd # if a command is issued that can't be executed as a normal command,
815 # and the command is the name of a directory, perform the cd command to that directory
816 setopt extended_glob # in order to use #, ~ and ^ for filename generation
817 # grep word *~(*.gz|*.bz|*.bz2|*.zip|*.Z) ->
818 # -> searches for word not in compressed files
819 # don't forget to quote '^', '~' and '#'!
820 setopt notify # report the status of backgrounds jobs immediately
821 setopt hash_list_all # Whenever a command completion is attempted, make sure \
822 # the entire command path is hashed first.
823 setopt completeinword # not just at the end
824 # setopt nocheckjobs # don't warn me about bg processes when exiting
825 setopt nohup # and don't kill them, either
826 # setopt printexitvalue # alert me if something failed
827 # setopt dvorak # with spelling correction, assume dvorak kb
828 setopt auto_pushd # make cd push the old directory onto the directory stack.
829 setopt nonomatch # try to avoid the 'zsh: no matches found...'
830 setopt nobeep # avoid "beep"ing
831 setopt pushd_ignore_dups # don't push the same dir twice.
833 MAILCHECK=30 # mailchecks
834 REPORTTIME=5 # report about cpu-/system-/user-time of command if running longer than 5 seconds
835 watch=(notme root) # watch for everyone but me and root
837 # define word separators (for stuff like backward-word, forward-word, backward-kill-word,..)
838 # WORDCHARS='*?_-.[]~=/&;!#$%^(){}<>' # the default
840 # WORDCHARS='*?_[]~=&;!#$%^(){}'
841 # WORDCHARS='${WORDCHARS:s@/@}'
843 # only slash should be considered as a word separator:
844 slash-backward-kill-word() {
845 local WORDCHARS="${WORDCHARS:s@/@}"
847 zle backward-kill-word
849 zle -N slash-backward-kill-word
851 #k# Kill everything in a word up to its last \kbd{/}
852 bindkey '\ev' slash-backward-kill-word
861 HISTFILE=$HOME/.zsh_history
862 isgrmlcd && HISTSIZE=500 || HISTSIZE=5000
863 isgrmlcd && SAVEHIST=1000 || SAVEHIST=10000 # useful for setopt append_history
867 # dirstack handling {{{
870 if [[ -f ~/.zdirs ]] && [[ ${#dirstack[*]} -eq 0 ]] ; then
871 dirstack=( ${(f)"$(< ~/.zdirs)"} )
872 # "cd -" won't work after login by just setting $OLDPWD, so
873 [[ -d $dirstack[0] ]] && cd $dirstack[0] && cd $OLDPWD
877 builtin print -l ${(u)dirstack} >! ~/.zdirs
882 # {{{ display battery status on right side of prompt via running 'BATTERY=1 zsh'
883 if [[ -n "$BATTERY" ]] ; then
884 if check_com -c acpi ; then
885 PERCENT="${(C)${(s| |)$(acpi 2>/dev/null)}[4]}"
886 [[ -z "$PERCENT" ]] && PERCENT='acpi not present'
888 if [[ "${PERCENT%%%}" -lt 20 ]] ; then
889 PERCENT="warning: ${PERCENT}%"
895 # display version control information on right side of prompt if $VCS is set {{{
896 # based on Mike Hommey's http://web.glandium.org/blog/?p=170
898 local vcs base_dir sub_dir ref
902 sub_dir=$(readlink -f "${PWD}")
903 sub_dir=${sub_dir#$1}
908 base_dir=$(git-rev-parse --show-cdup 2>/dev/null) || return 1
909 base_dir=$(readlink -f "$base_dir/..")
910 sub_dir=$(git-rev-parse --show-prefix)
912 ref=$(git-symbolic-ref -q HEAD || git-name-rev --name-only HEAD 2>/dev/null)
913 ref=${ref#refs/heads/}
918 [[ -d ".svn" ]] || return 1
920 while [[ -d "$base_dir/../.svn" ]]; do base_dir="$base_dir/.."; done
921 base_dir=$(readlink -f "$base_dir")
922 sub_dir=$(sub_dir "${base_dir}")
923 ref=$(svn info "$base_dir" | awk '/^URL/ { sub(".*/","",$0); r=$0 } /^Revision/ { sub("[^0-9]*","",$0); print r":"$0 }')
928 [[ -f ~/.svk/config ]] || return 1
929 base_dir=$(awk '/: *$/ { sub(/^ */,"",$0); sub(/: *$/,"",$0); if (match("'${PWD}'", $0"(/|$)")) { print $0; d=1; } } /depotpath/ && d == 1 { sub(".*/","",$0); r=$0 } /revision/ && d == 1 { print r ":" $2; exit 1 }' ~/.svk/config) && return 1
932 base_dir=${base_dir%%
934 sub_dir=$(sub_dir "${base_dir}")
940 while [[ ! -d "$base_dir/.hg" ]]; do
941 base_dir="$base_dir/.."
942 [[ $(readlink -f "${base_dir}") = "/" ]] && return 1
944 base_dir=$(readlink -f "$base_dir")
945 sub_dir=$(sub_dir "${base_dir}")
946 ref=$(< "${base_dir}/.hg/branch")
955 # echo "${vcs:+($vcs)}${base_dir/$HOME/~}${vcs:+[$ref]${sub_dir}}"
956 echo "${vcs:+($vcs)}${base_dir}${vcs:+[$ref]${sub_dir}}"
961 if autoload promptinit && promptinit 2>/dev/null ; then
962 promptinit # people should be able to use their favourite prompt
964 print 'Notice: no promptinit available :('
968 # precmd() => a function which is executed just before each prompt
969 # use 'NOPRECMD=1' to disable the precmd + preexec commands
971 # precmd () { setopt promptsubst; [[ -o interactive ]] && jobs -l;
973 # make sure to use right prompt only when not running a command
974 is41 && setopt transient_rprompt
976 is4 && [[ -z $NOPRECMD ]] && precmd () {
977 [[ -n $NOPRECMD ]] && return 0
978 # allow manual overwriting of RPROMPT
979 if [[ -n $RPROMPT ]] ; then
980 [[ $TERM == screen* ]] && echo -n $'\ekzsh\e\\'
983 # just use DONTSETRPROMPT=1 to be able to overwrite RPROMPT
984 if [[ -z $DONTSETRPROMPT ]] ; then
985 if [[ -n $BATTERY ]] ; then
986 RPROMPT="%(?..:()% ${PERCENT}${SCREENTITLE}"
987 # RPROMPT="${PERCENT}${SCREENTITLE}"
988 elif [[ -n $VCS ]] ; then
989 RPROMPT="%(?..:()% $(__vcs_dir)${SCREENTITLE}"
991 RPROMPT="%(?..:()% ${SCREENTITLE}"
992 # RPROMPT="${SCREENTITLE}"
995 # adjust title of xterm
996 # see http://www.faqs.org/docs/Linux-mini/Xterm-Title.html
999 print -Pn "\e]0;%n@%m: %~\a"
1004 # chpwd () => a function which is executed whenever the directory is changed
1006 # preexec() => a function running before every command
1007 is4 && [[ -z $NOPRECMD ]] && \
1009 [[ -n $NOPRECMD ]] && return 0
1010 # set hostname if not running on host with name 'grml'
1011 if [[ -n "$HOSTNAME" ]] && [[ "$HOSTNAME" != $(hostname) ]] ; then
1014 # get the name of the program currently running and hostname of local machine
1015 # set screen window title if running in a screen
1016 if [[ "$TERM" == screen* ]] ; then
1017 # local CMD=${1[(wr)^(*=*|sudo|ssh|-*)]} # don't use hostname
1018 local CMD="${1[(wr)^(*=*|sudo|ssh|-*)]}$NAME" # use hostname
1019 echo -ne "\ek$CMD\e\\"
1021 # set the screen title to "zsh" when sitting at the command prompt:
1022 if [[ "$TERM" == screen* ]] ; then
1023 SCREENTITLE=$'%{\ekzsh\e\\%}'
1027 # adjust title of xterm
1030 print -Pn "\e]0;%n@%m: $1\a"
1036 if autoload colors && colors 2>/dev/null ; then
1037 BLUE="%{${fg[blue]}%}"
1038 RED="%{${fg_bold[red]}%}"
1039 GREEN="%{${fg[green]}%}"
1040 CYAN="%{${fg[cyan]}%}"
1041 WHITE="%{${fg[white]}%}"
1042 NO_COLOUR="%{${reset_color}%}"
1044 BLUE=$'%{\e[1;34m%}'
1046 GREEN=$'%{\e[1;32m%}'
1047 CYAN=$'%{\e[1;36m%}'
1048 WHITE=$'%{\e[1;37m%}'
1049 NO_COLOUR=$'%{\e[0m%}'
1052 EXITCODE="%(?..%?%1v )"
1053 PS2='`%_> ' # secondary prompt, printed when the shell needs more information to complete a command.
1054 PS3='?# ' # selection prompt used within a select loop.
1055 PS4='+%N:%i:%_> ' # the execution trace prompt (setopt xtrace). default: '+%N:%i>'
1057 # set variable debian_chroot if running in a chroot with /etc/debian_chroot
1058 if [[ -z "$debian_chroot" ]] && [[ -r /etc/debian_chroot ]] ; then
1059 debian_chroot=$(cat /etc/debian_chroot)
1062 # don't use colors on dumb terminals (like emacs):
1063 if [[ "$TERM" == dumb ]] ; then
1064 PROMPT="${EXITCODE}${debian_chroot:+($debian_chroot)}%n@%m %40<...<%B%~%b%<< %# "
1066 # only if $GRMLPROMPT is set (e.g. via 'GRMLPROMPT=1 zsh') use the extended prompt
1067 # set variable identifying the chroot you work in (used in the prompt below)
1068 if [[ -n $GRMLPROMPT ]] ; then
1069 PROMPT="${RED}${EXITCODE}${CYAN}[%j running job(s)] ${GREEN}{history#%!} ${RED}%(3L.+.) ${BLUE}%* %D
1070 ${BLUE}%n${NO_COLOUR}@%m %40<...<%B%~%b%<< %# "
1072 if (( EUID != 0 )); then
1073 PROMPT="${RED}${EXITCODE}${WHITE}${debian_chroot:+($debian_chroot)}${BLUE}%n${NO_COLOUR}@%m %40<...<%B%~%b%<< %# " # primary prompt string
1075 PROMPT="${BLUE}${EXITCODE}${WHITE}${debian_chroot:+($debian_chroot)}${RED}%n${NO_COLOUR}@%m %40<...<%B%~%b%<< %# " # primary prompt string
1080 # if we are inside a grml-chroot set a specific prompt theme
1081 if [[ -n "$GRML_CHROOT" ]] ; then
1082 PROMPT="%{$fg[red]%}(CHROOT) %{$fg_bold[red]%}%n%{$fg_no_bold[white]%}@%m %40<...<%B%~%b%<< %\# "
1086 # {{{ 'hash' some often used directories
1088 hash -d deb=/var/cache/apt/archives
1089 hash -d doc=/usr/share/doc
1090 hash -d linux=/lib/modules/$(command uname -r)/build/
1091 hash -d log=/var/log
1092 hash -d slog=/var/log/syslog
1093 hash -d src=/usr/src
1094 hash -d templ=/usr/share/doc/grml-templates
1095 hash -d tt=/usr/share/doc/texttools-doc
1096 hash -d www=/var/www
1101 if [[ $UID -eq 0 ]] ; then
1102 [[ -r /etc/grml/screenrc ]] && alias screen='/usr/bin/screen -c /etc/grml/screenrc'
1103 elif [[ -r $HOME/.screenrc ]] ; then
1104 alias screen="/usr/bin/screen -c $HOME/.screenrc"
1106 [[ -r /etc/grml/screenrc_grml ]] && alias screen='/usr/bin/screen -c /etc/grml/screenrc_grml'
1109 # do we have GNU ls with color-support?
1110 if ls --help 2>/dev/null | grep -- --color= >/dev/null && [[ "$TERM" != dumb ]] ; then
1111 #a1# execute \kbd{@a@}:\quad ls with colors
1112 alias ls='ls -b -CF --color=auto'
1113 #a1# execute \kbd{@a@}:\quad list all files, with colors
1114 alias la='ls -la --color=auto'
1115 #a1# long colored list, without dotfiles (@a@)
1116 alias ll='ls -l --color=auto'
1117 #a1# long colored list, human readable sizes (@a@)
1118 alias lh='ls -hAl --color=auto'
1119 #a1# List files, append qualifier to filenames \\&\quad(\kbd{/} for directories, \kbd{@} for symlinks ...)
1120 alias l='ls -lF --color=auto'
1122 alias ls='ls -b -CF'
1129 alias mdstat='cat /proc/mdstat'
1130 alias ...='cd ../../'
1132 # generate alias named "$KERNELVERSION-reboot" so you can use boot with kexec:
1133 if [[ -x /sbin/kexec ]] && [[ -r /proc/cmdline ]] ; then
1134 alias "$(uname -r)-reboot"="kexec -l --initrd=/boot/initrd.img-"$(uname -r)" --command-line=\"$(cat /proc/cmdline)\" /boot/vmlinuz-"$(uname -r)""
1137 alias cp='nocorrect cp' # no spelling correction on cp
1138 alias mkdir='nocorrect mkdir' # no spelling correction on mkdir
1139 alias mv='nocorrect mv' # no spelling correction on mv
1140 alias rm='nocorrect rm' # no spelling correction on rm
1142 #a1# Execute \kbd{rmdir}
1144 #a1# Execute \kbd{rmdir}
1147 # see http://www.cl.cam.ac.uk/~mgk25/unicode.html#term for details
1148 alias term2iso="echo 'Setting terminal to iso mode' ; print -n '\e%@'"
1149 alias term2utf="echo 'Setting terminal to utf-8 mode'; print -n '\e%G'"
1151 # make sure it is not assigned yet
1152 [[ $(whence -w utf2iso &>/dev/null) == 'utf2iso: alias' ]] && unalias utf2iso
1156 for ENV in $(env | command grep -i '.utf') ; do
1157 eval export "$(echo $ENV | sed 's/UTF-8/iso885915/ ; s/utf8/iso885915/')"
1162 # make sure it is not assigned yet
1163 [[ $(whence -w iso2utf &>/dev/null) == 'iso2utf: alias' ]] && unalias iso2utf
1165 if ! isutfenv ; then
1166 for ENV in $(env | command grep -i '\.iso') ; do
1167 eval export "$(echo $ENV | sed 's/iso.*/UTF-8/ ; s/ISO.*/UTF-8/')"
1172 # set up software synthesizer via speakup
1174 aumix -w 90 -v 90 -p 90 -m 90
1175 if ! [[ -r /dev/softsynth ]] ; then
1176 flite -o play -t "Sorry, software synthesizer not available. Did you boot with swspeak bootoption?"
1179 setopt singlelinezle
1182 nice -n -20 speechd-up
1184 flite -o play -t "Finished setting up software synthesizer"
1188 # I like clean prompt, so provide simple way to get that
1189 check_com 0 || alias 0='return 0'
1191 # for really lazy people like mika:
1192 check_com S &>/dev/null || alias S='screen'
1193 check_com s &>/dev/null || alias s='ssh'
1195 # get top 10 shell commands:
1196 alias top10='print -l ? ${(o)history%% *} | uniq -c | sort -nr | head -n 10'
1198 # truecrypt; use e.g. via 'truec /dev/ice /mnt/ice' or 'truec -i'
1199 if check_com -c truecrypt ; then
1201 alias truec='truecrypt --mount-options "rw,sync,dirsync,users,uid=1000,gid=users,umask=077,utf8" '
1203 alias truec='truecrypt --mount-options "rw,sync,dirsync,users,uid=1000,gid=users,umask=077" '
1207 #f1# Hints for the use of zsh on grml
1209 print "$bg[white]$fg[black]
1210 zsh-help - hints for use of zsh on grml
1211 =======================================$reset_color"
1214 Main configuration of zsh happens in /etc/zsh/zshrc (global)
1215 and /etc/skel/.zshrc which is copied to $HOME/.zshrc once.
1216 The files are part of the package grml-etc-core, if you want to
1217 use them on a non-grml-system just get the tar.gz from
1218 http://deb.grml.org/ or get the files from the mercurial
1221 http://hg.grml.org/grml-etc-core/raw-file/tip/etc/skel/.zshrc
1222 http://hg.grml.org/grml-etc-core/raw-file/tip/etc/zsh/zshrc
1224 If you want to stay in sync with zsh configuration of grml
1225 run '\''ln -sf /etc/skel/.zshrc $HOME/.zshrc'\'' and configure
1226 your own stuff in $HOME/.zshrc.local. System wide configuration
1227 without touching configuration files of grml can take place
1228 in /etc/zsh/zshrc.local.
1230 If you want to use the configuration of user grml also when
1231 running as user root just run '\''zshskel'\'' which will source
1232 the file /etc/skel/.zshrc.
1234 For information regarding zsh start at http://grml.org/zsh/
1236 Take a look at grml'\''s zsh refcard:
1237 % xpdf =(zcat /usr/share/doc/grml-docs/zsh/grml-zsh-refcard.pdf.gz)
1239 Check out the main zsh refcard:
1240 % '$BROWSER' http://www.bash2zsh.com/zsh_refcard/refcard.pdf
1242 And of course visit the zsh-lovers:
1245 You can adjust some options through environment variables when
1246 invoking zsh without having to edit configuration files.
1247 Basically meant for bash users who are not used to the power of
1250 "NOCOR=1 zsh" => deactivate automatic correction
1251 "NOMENU=1 zsh" => do not use menu completion (note: use strg-d for completion instead!)
1252 "NOPRECMD=1 zsh" => disable the precmd + preexec commands (set GNU screen title)
1253 "BATTERY=1 zsh" => activate battery status (via acpi) on right side of prompt'
1256 $bg[white]$fg[black]
1257 Please report wishes + bugs to the grml-team: http://grml.org/bugs/
1258 Enjoy your grml system with the zsh!$reset_color"
1262 if [[ -r /etc/debian_version ]] ; then
1263 #a3# Execute \kbd{apt-cache search}
1264 alias acs='apt-cache search'
1265 #a3# Execute \kbd{apt-cache show}
1266 alias acsh='apt-cache show'
1267 #a3# Execute \kbd{apt-cache policy}
1268 alias acp='apt-cache policy'
1269 #a3# Execute \kbd{apt-get dist-upgrade}
1270 salias adg="apt-get dist-upgrade"
1271 #a3# Execute \kbd{apt-get install}
1272 salias agi="apt-get install"
1273 #a3# Execute \kbd{aptitude install}
1274 salias ati="aptitude install"
1275 #a3# Execute \kbd{apt-get upgrade}
1276 salias ag="apt-get upgrade"
1277 #a3# Execute \kbd{apt-get update}
1278 salias au="apt-get update"
1279 #a3# Execute \kbd{aptitude update ; aptitude safe-upgrade}
1280 salias -a up="aptitude update ; aptitude safe-upgrade"
1281 #a3# Execute \kbd{dpkg-buildpackage}
1282 alias dbp='dpkg-buildpackage'
1283 #a3# Execute \kbd{grep-excuses}
1284 alias ge='grep-excuses'
1287 #f3# Execute \kbd{apt-get update \&\& }\\&\quad \kbd{apt-get dist-upgrade}
1289 if [[ -z "$1" ]] ; then
1290 $SUDO apt-get update
1291 $SUDO apt-get -u upgrade
1293 ssh $1 $SUDO apt-get update
1294 # ask before the upgrade
1296 ssh $1 $SUDO apt-get --no-act upgrade
1297 echo -n 'Process the upgrade?'
1299 if [[ $dummy == "y" ]] ; then
1300 ssh $1 $SUDO apt-get -u upgrade --yes
1305 isgrmlcd && alias su="sudo -s" # get a root shell
1306 #a1# Take a look at the syslog: \kbd{\$PAGER /var/log/syslog}
1307 alias llog="$PAGER /var/log/syslog" # take a look at the syslog
1308 #a1# Take a look at the syslog: \kbd{tail -f /var/log/syslog}
1309 alias tlog="tail -f /var/log/syslog" # follow the syslog
1310 #a1# (Re)-source \kbd{/etc/skel/.zshrc}
1311 alias zshskel="source /etc/skel/.zshrc" # source skeleton zshrc
1314 # sort installed Debian-packages by size
1315 if check_com -c grep-status ; then
1316 #a3# List installed Debian-packages sorted by size
1317 alias debs-by-size='grep-status -FStatus -sInstalled-Size,Package -n "install ok installed" | paste -sd " \n" | sort -rn'
1320 # if cdrecord is a symlink (to wodim) or isn't present at all warn:
1321 if [[ -L /usr/bin/cdrecord ]] || ! check_com -c cdrecord ; then
1322 if check_com -c wodim ; then
1323 alias cdrecord="echo 'cdrecord is not provided under its original name by Debian anymore.
1324 See #377109 in the BTS of Debian for more details.
1326 Please use the wodim binary instead' ; return 1"
1330 # get_tw_cli has been renamed into get_3ware
1331 if check_com -c get_3ware ; then
1333 echo 'Warning: get_tw_cli has been renamed into get_3ware. Invoking get_3ware for you.'>&2
1338 # I hate lacking backward compatibility, so provide an alternative therefore
1339 if ! check_com -c apache2-ssl-certificate ; then
1341 apache2-ssl-certificate() {
1343 print 'Debian does not ship apache2-ssl-certificate anymore (see #398520). :('
1344 print 'You might want to take a look at Debian the package ssl-cert as well.'
1345 print 'To generate a certificate for use with apache2 follow the instructions:'
1349 export RANDFILE=/dev/random
1350 mkdir /etc/apache2/ssl/
1351 openssl req $@ -new -x509 -days 365 -nodes -out /etc/apache2/ssl/apache.pem -keyout /etc/apache2/ssl/apache.pem
1352 chmod 600 /etc/apache2/ssl/apache.pem
1354 Run "grml-tips ssl-certificate" if you need further instructions.
1360 # {{{ Use hard limits, except for a smaller stack and no core dumps
1363 isgrmlcd && limit core 0 # important for a live-cd-system
1367 # {{{ completion system
1369 # called later (via is4 && grmlcomp)
1370 # notice: use 'zstyle' for getting current settings
1371 # press ^Xh (control-x h) for getting tags in context; ^X? (control-x ?) to run complete_debug with trace output
1373 # TODO: This could use some additional information
1375 # allow one error for every three characters typed in approximate completer
1376 zstyle ':completion:*:approximate:' max-errors 'reply=( $((($#PREFIX+$#SUFFIX)/3 )) numeric )'
1378 # don't complete backup files as executables
1379 zstyle ':completion:*:complete:-command-::commands' ignored-patterns '(aptitude-*|*\~)'
1381 # start menu completion only if it could find no unambiguous initial string
1382 zstyle ':completion:*:correct:*' insert-unambiguous true
1383 zstyle ':completion:*:corrections' format $'%{\e[0;31m%}%d (errors: %e)%{\e[0m%}'
1384 zstyle ':completion:*:correct:*' original true
1386 # activate color-completion
1387 zstyle ':completion:*:default' list-colors ${(s.:.)LS_COLORS}
1389 # format on completion
1390 zstyle ':completion:*:descriptions' format $'%{\e[0;31m%}completing %B%d%b%{\e[0m%}'
1392 # complete 'cd -<tab>' with menu
1393 zstyle ':completion:*:*:cd:*:directory-stack' menu yes select
1395 # insert all expansions for expand completer
1396 zstyle ':completion:*:expand:*' tag-order all-expansions
1397 zstyle ':completion:*:history-words' list false
1400 zstyle ':completion:*:history-words' menu yes
1402 # ignore duplicate entries
1403 zstyle ':completion:*:history-words' remove-all-dups yes
1404 zstyle ':completion:*:history-words' stop yes
1406 # match uppercase from lowercase
1407 zstyle ':completion:*' matcher-list 'm:{a-z}={A-Z}'
1409 # separate matches into groups
1410 zstyle ':completion:*:matches' group 'yes'
1411 zstyle ':completion:*' group-name ''
1413 if [[ -z "$NOMENU" ]] ; then
1414 # if there are more than 5 options allow selecting from a menu
1415 zstyle ':completion:*' menu select=5
1417 # don't use any menus at all
1421 zstyle ':completion:*:messages' format '%d'
1422 zstyle ':completion:*:options' auto-description '%d'
1424 # describe options in full
1425 zstyle ':completion:*:options' description 'yes'
1427 # on processes completion complete all user processes
1428 zstyle ':completion:*:processes' command 'ps -au$USER'
1430 # offer indexes before parameters in subscripts
1431 zstyle ':completion:*:*:-subscript-:*' tag-order indexes parameters
1433 # provide verbose completion information
1434 zstyle ':completion:*' verbose true
1436 # recent (as of Dec 2007) zsh versions are able to provide descriptions
1437 # for commands (read: 1st word in the line) that it will list for the user
1438 # to choose from. The following disables that, because it's not exactly fast.
1439 zstyle ':completion:*:-command-:*:' verbose false
1441 # set format for warnings
1442 zstyle ':completion:*:warnings' format $'%{\e[0;31m%}No matches for:%{\e[0m%} %d'
1444 # define files to ignore for zcompile
1445 zstyle ':completion:*:*:zcompile:*' ignored-patterns '(*~|*.zwc)'
1446 zstyle ':completion:correct:' prompt 'correct to: %e'
1448 # Ignore completion functions for commands you don't have:
1449 zstyle ':completion::(^approximate*):*:functions' ignored-patterns '_*'
1451 # complete manual by their section
1452 zstyle ':completion:*:manuals' separate-sections true
1453 zstyle ':completion:*:manuals.*' insert-sections true
1454 zstyle ':completion:*:man:*' menu yes select
1456 # run rehash on completion so new installed program are found automatically:
1458 (( CURRENT == 1 )) && rehash
1463 # some people don't like the automatic correction - so run 'NOCOR=1 zsh' to deactivate it
1464 if [[ -n "$NOCOR" ]] ; then
1465 zstyle ':completion:*' completer _oldlist _expand _force_rehash _complete _files _ignored
1468 # try to be smart about when to use what completer...
1470 zstyle -e ':completion:*' completer '
1471 if [[ $_last_try != "$HISTNO$BUFFER$CURSOR" ]] ; then
1472 _last_try="$HISTNO$BUFFER$CURSOR"
1473 reply=(_complete _match _ignored _prefix _files)
1475 if [[ $words[1] == (rm|mv) ]] ; then
1476 reply=(_complete _files)
1478 reply=(_oldlist _expand _force_rehash _complete _ignored _correct _approximate _files)
1483 # zstyle ':completion:*' completer _complete _correct _approximate
1484 # zstyle ':completion:*' expand prefix suffix
1486 # command for process lists, the local web server details and host completion
1487 zstyle ':completion:*:urls' local 'www' '/var/www/' 'public_html'
1490 [[ -d $ZSHDIR/cache ]] && zstyle ':completion:*' use-cache yes && \
1491 zstyle ':completion::complete:*' cache-path $ZSHDIR/cache/
1493 # host completion /* add brackets as vim can't parse zsh's complex cmdlines 8-) {{{ */
1495 [[ -r ~/.ssh/known_hosts ]] && _ssh_hosts=(${${${${(f)"$(<$HOME/.ssh/known_hosts)"}:#[\|]*}%%\ *}%%,*}) || _ssh_hosts=()
1496 [[ -r /etc/hosts ]] && : ${(A)_etc_hosts:=${(s: :)${(ps:\t:)${${(f)~~"$(</etc/hosts)"}%%\#*}##[:blank:]#[^[:blank:]]#}}} || _etc_hosts=()
1508 zstyle ':completion:*:hosts' hosts $hosts
1509 # zstyle '*' hosts $hosts
1511 # specify your logins:
1513 # {grml,grml1}@foo.invalid
1514 # grml-devel@bar.invalid
1517 # {fred,root}@foo.invalid
1520 # zstyle ':completion:*:my-accounts' users-hosts $my_accounts
1521 # zstyle ':completion:*:other-accounts' users-hosts $other_accounts
1523 # specify specific port/service settings:
1524 # telnet_users_hosts_ports=(
1527 # @mail-server:{smtp,pop3}
1529 # @proxy-server:8000
1531 # zstyle ':completion:*:*:telnet:*' users-hosts-ports $telnet_users_hosts_ports
1533 # use generic completion system for programs not yet defined; (_gnu_generic works
1534 # with commands that provide a --help option with "standard" gnu-like output.)
1535 compdef _gnu_generic tail head feh cp mv df stow uname ipacsum fetchipac
1537 # see upgrade function in this file
1538 compdef _hosts upgrade
1544 # people should use 'grml-x'!
1546 if [[ -e /etc/X11/xorg.conf ]] ; then
1547 [[ -x /usr/bin/startx ]] && /usr/bin/startx "$@" || /usr/X11R6/bin/startx "$@"
1549 echo "Please use the script \"grml-x\" for starting the X Window System
1550 because there does not exist /etc/X11/xorg.conf yet.
1551 If you want to use startx anyway please call \"/usr/bin/startx\"."
1557 if [[ -e /etc/X11/xorg.conf ]] ; then
1558 [[ -x /usr/bin/xinit ]] && /usr/bin/xinit || /usr/X11R6/bin/xinit
1560 echo "Please use the script \"grml-x\" for starting the X Window System.
1561 because there does not exist /etc/X11/xorg.conf yet.
1562 If you want to use xinit anyway please call \"/usr/bin/xinit\"."
1567 if check_com -c 915resolution ; then
1568 alias 855resolution='echo -e "Please use 915resolution as resolution modify tool for Intel graphic chipset."; return -1'
1571 #a1# Output version of running grml
1572 alias grml-version='cat /etc/grml_version'
1574 if check_com -c rebuildfstab ; then
1575 #a1# Rebuild /etc/fstab
1576 alias grml-rebuildfstab='rebuildfstab -v -r -config'
1579 if check_com -c grml-debootstrap ; then
1580 alias debian2hd='print "Installing debian to harddisk is possible via using grml-debootstrap." ; return 1'
1585 # {{{ now run the functions
1587 is4 && isgrml && grmlstuff
1592 is4 && xsource "/etc/zsh/keephack"
1595 # {{{ wonderful idea of using "e" glob qualifier by Peter Stephenson
1596 # You use it as follows:
1597 # $ NTREF=/reference/file
1599 # This lists all the files in the current directory newer than the reference file.
1600 # You can also specify the reference file inline; note quotes:
1601 # $ ls -l *(e:'nt ~/.zshenv':)
1603 if [[ -n $1 ]] ; then
1606 [[ $REPLY -nt $NTREF ]]
1610 # shell functions {{{
1612 #f1# Provide csh compatibility
1613 setenv() { typeset -x "${1}${1:+=}${(@)argv[2,$#]}" } # csh compatibility
1615 #f1# Reload an autoloadable function
1616 freload() { while (( $# )); do; unfunction $1; autoload -U $1; shift; done }
1618 #f1# Reload zsh setup
1620 if [[ "$#*" -eq 0 ]] ; then
1621 [[ -r ~/.zshrc ]] && . ~/.zshrc
1630 compdef _functions reload freload
1632 #f1# List symlinks in detail (more detailed version of 'readlink -f' and 'whence -s')
1634 [[ -z "$1" ]] && printf 'Usage: %s <file(s)>\n' "$0" && return 1
1637 while [[ -h "$file" ]] ; do
1639 file=$(readlink "$file")
1644 # fast manual access
1645 if check_com qma ; then
1646 #f1# View the zsh manual
1647 manzsh() { qma zshall "$1" }
1650 manzsh() { /usr/bin/man zshall | vim -c "se ft=man| se hlsearch" +/"$1" - ; }
1651 # manzsh() { /usr/bin/man zshall | most +/"$1" ; }
1652 # [[ -f ~/.terminfo/m/mostlike ]] && MYLESS='LESS=C TERMINFO=~/.terminfo TERM=mostlike less' || MYLESS='less'
1653 # manzsh() { man zshall | $MYLESS -p $1 ; }
1656 if check_com -c $PAGER ; then
1657 #f1# View Debian's changelog of a given package
1659 if [[ -r /usr/share/doc/${1}/changelog.Debian.gz ]] ; then
1660 $PAGER /usr/share/doc/${1}/changelog.Debian.gz
1661 elif [[ -r /usr/share/doc/${1}/changelog.gz ]] ; then
1662 $PAGER /usr/share/doc/${1}/changelog.gz
1664 if check_com -c aptitude ; then
1665 echo "No changelog for package $1 found, using aptitude to retrieve it."
1667 aptitude -t unstable changelog ${1}
1669 aptitude changelog ${1}
1672 echo "No changelog for package $1 found, sorry."
1677 _dchange() { _files -W /usr/share/doc -/ }
1678 compdef _dchange dchange
1680 #f1# View Debian's NEWS of a given package
1682 if [[ -r /usr/share/doc/${1}/NEWS.Debian.gz ]] ; then
1683 $PAGER /usr/share/doc/${1}/NEWS.Debian.gz
1685 if [[ -r /usr/share/doc/${1}/NEWS.gz ]] ; then
1686 $PAGER /usr/share/doc/${1}/NEWS.gz
1688 echo "No NEWS file for package $1 found, sorry."
1693 _dnews() { _files -W /usr/share/doc -/ }
1694 compdef _dnews dnews
1696 #f1# View upstream's changelog of a given package
1698 if [[ -r /usr/share/doc/${1}/changelog.gz ]] ; then
1699 $PAGER /usr/share/doc/${1}/changelog.gz
1701 echo "No changelog for package $1 found, sorry."
1705 _uchange() { _files -W /usr/share/doc -/ }
1706 compdef _uchange uchange
1711 ZSH_PROFILE_RC=1 $SHELL "$@"
1714 #f1# Edit an alias via zle
1716 [[ -z "$1" ]] && { echo "Usage: edalias <alias_to_edit>" ; return 1 } || vared aliases'[$1]' ;
1718 compdef _aliases edalias
1720 #f1# Edit a function via zle
1722 [[ -z "$1" ]] && { echo "Usage: edfun <function_to_edit>" ; return 1 } || zed -f "$1" ;
1724 compdef _functions edfunc
1726 # use it e.g. via 'Restart apache2'
1727 #m# f6 Start() \kbd{/etc/init.d/\em{process}}\quad\kbd{start}
1728 #m# f6 Restart() \kbd{/etc/init.d/\em{process}}\quad\kbd{restart}
1729 #m# f6 Stop() \kbd{/etc/init.d/\em{process}}\quad\kbd{stop}
1730 #m# f6 Reload() \kbd{/etc/init.d/\em{process}}\quad\kbd{reload}
1731 #m# f6 Force-Reload() \kbd{/etc/init.d/\em{process}}\quad\kbd{force-reload}
1732 if [[ -d /etc/init.d ]] ; then
1733 for i in Start Restart Stop Force-Reload Reload ; do
1734 eval "$i() { $SUDO /etc/init.d/\$1 ${i:l} \$2 ; }"
1738 #f1# Provides useful information on globbing
1745 p named pipes (FIFOs)
1746 * executable plain files (0100)
1747 % device files (character or block special)
1748 %b block special files
1749 %c character special files
1750 r owner-readable files (0400)
1751 w owner-writable files (0200)
1752 x owner-executable files (0100)
1753 A group-readable files (0040)
1754 I group-writable files (0020)
1755 E group-executable files (0010)
1756 R world-readable files (0004)
1757 W world-writable files (0002)
1758 X world-executable files (0001)
1759 s setuid files (04000)
1760 S setgid files (02000)
1761 t files with the sticky bit (01000)
1763 print *(m-1) # Files modified up to a day ago
1764 print *(a1) # Files accessed a day ago
1765 print *(@) # Just symlinks
1766 print *(Lk+50) # Files bigger than 50 kilobytes
1767 print *(Lk-50) # Files smaller than 50 kilobytes
1768 print **/*.c # All *.c files recursively starting in \$PWD
1769 print **/*.c~file.c # Same as above, but excluding 'file.c'
1770 print (foo|bar).* # Files starting with 'foo' or 'bar'
1771 print *~*.* # All Files that do not contain a dot
1772 chmod 644 *(.^x) # make all plain non-executable files publically readable
1773 print -l *(.c|.h) # Lists *.c and *.h
1774 print **/*(g:users:) # Recursively match all files that are owned by group 'users'
1775 echo /proc/*/cwd(:h:t:s/self//) # Analogous to >ps ax | awk '{print $1}'<"
1777 alias help-zshglob=H-Glob
1779 check_com -c qma && alias ?='qma zshall'
1781 # grep for running process, like: 'any vim'
1783 if [[ -z "$1" ]] ; then
1784 echo "any - grep for process(es) by keyword" >&2
1785 echo "Usage: any <keyword>" >&2 ; return 1
1788 local LENGTH=$(expr length $STRING)
1789 local FIRSCHAR=$(echo $(expr substr $STRING 1 1))
1790 local REST=$(echo $(expr substr $STRING 2 $LENGTH))
1791 ps xauwww| grep "[$FIRSCHAR]$REST"
1795 # After resuming from suspend, system is paging heavily, leading to very bad interactivity.
1796 # taken from $LINUX-KERNELSOURCE/Documentation/power/swsusp.txt
1797 [[ -r /proc/1/maps ]] && \
1799 print 'Reading /proc/[0-9]*/maps and sending output to /dev/null, this might take a while.'
1800 cat $(sed -ne 's:.* /:/:p' /proc/[0-9]*/maps | sort -u | grep -v '^/dev/') > /dev/null
1801 print 'Finished, running "swapoff -a; swapon -a" may also be useful.'
1804 # print hex value of a number
1806 [[ -n "$1" ]] && printf "%x\n" $1 || { print 'Usage: hex <number-to-convert>' ; return 1 }
1809 # calculate (or eval at all ;-)) with perl => p[erl-]eval
1810 # hint: also take a look at zcalc -> 'autoload zcalc' -> 'man zshmodules | less -p MATHFUNC'
1812 [[ -n "$1" ]] && CALC="$*" || print "Usage: calc [expression]"
1813 perl -e "print eval($CALC),\"\n\";"
1815 functions peval &>/dev/null && alias calc=peval
1817 # brltty seems to have problems with utf8 environment and/or font Uni3-Terminus16 under
1818 # certain circumstances, so work around it, no matter which environment we have
1820 if [[ -z "$DISPLAY" ]] ; then
1821 consolechars -f /usr/share/consolefonts/default8x16.psf.gz
1828 # just press 'asdf' keys to toggle between dvorak and us keyboard layout
1830 echo -n 'Switching to us keyboard layout: '
1831 [[ -z "$DISPLAY" ]] && $SUDO loadkeys us &>/dev/null || setxkbmap us &>/dev/null
1835 echo -n 'Switching to dvorak keyboard layout: '
1836 [[ -z "$DISPLAY" ]] && $SUDO loadkeys dvorak &>/dev/null || setxkbmap dvorak &>/dev/null
1839 # just press 'asdf' key to toggle from neon layout to us keyboard layout
1841 echo -n 'Switching to us keyboard layout: '
1842 setxkbmap us && echo 'Done' || echo 'Failed'
1845 # set up an ipv6 tunnel
1849 if ifconfig sit1 2>/dev/null | grep -q 'inet6 addr: 2002:.*:1::1' ; then
1850 print 'ipv6 tunnel already set up, nothing to be done.'
1851 print 'execute: "ifconfig sit1 down ; ifconfig sit0 down" to remove ipv6-tunnel.' ; return 1
1853 [[ -n "$PUBLIC_IP" ]] || \
1854 local PUBLIC_IP=$(ifconfig $(route -n | awk '/^0\.0\.0\.0/{print $8; exit}') | \
1855 awk '/inet addr:/ {print $2}' | tr -d 'addr:')
1857 [[ -n "$PUBLIC_IP" ]] || { print 'No $PUBLIC_IP set and could not determine default one.' ; return 1 }
1858 local IPV6ADDR=$(printf "2002:%02x%02x:%02x%02x:1::1" $(print ${PUBLIC_IP//./ }))
1859 print -n "Setting up ipv6 tunnel $IPV6ADDR via ${PUBLIC_IP}: "
1860 ifconfig sit0 tunnel ::192.88.99.1 up
1861 ifconfig sit1 add "$IPV6ADDR" && print done || print failed
1865 if ifconfig sit1 2>/dev/null | grep -q 'inet6 addr: 2002:.*:1::1' ; then
1866 print 'ipv6 tunnel available' ; return 0
1868 print 'ipv6 tunnel not available' ; return 1
1872 if ifconfig sit1 2>/dev/null | grep -q 'inet6 addr: 2002:.*:1::1' ; then
1873 print -n 'Stopping ipv6 tunnel (sit0 + sit1): '
1874 ifconfig sit1 down ; ifconfig sit0 down && print done || print failed
1876 print 'No ipv6 tunnel found, nothing to be done.' ; return 1
1880 print "Usage: ipv6-tunnel [start|stop|status]">&2 ; return 1
1885 # run dhclient for wireless device
1887 salias dhclient "$(wavemon -d | awk '/device/{print $2}')"
1890 # spawn a minimally set up ksh - useful if you want to umount /usr/.
1892 exec env -i ENV="/etc/minimal-shellrc" HOME="$HOME" TERM="$TERM" ksh
1895 # make a backup of a file
1897 cp -a "$1" "${1}_$(date --iso-8601=seconds)"
1900 # Switching shell safely and efficiently? http://www.zsh.org/mla/workers/2001/msg02410.html
1902 # NO_SWITCH="yes" command bash "$@"
1905 # exec $SHELL $SHELL_ARGS "$@"
1910 # log out? set timeout in seconds {{{
1912 # do not log out in some specific terminals:
1913 # if [[ "${TERM}" == ([Exa]term*|rxvt|dtterm|screen*) ]] ; then
1918 # {{{ make sure our environment is clean regarding colors
1919 for color in BLUE RED GREEN CYAN WHITE ; unset $color
1922 # source another config file if present {{{
1923 xsource "/etc/zsh/zshrc.local"
1926 # "persistent history" {{{
1927 # just write important commands you always need to ~/.important_commands
1928 if [[ -r ~/.important_commands ]] ; then
1929 fc -R ~/.important_commands
1933 ## genrefcard.pl settings {{{
1934 ### example: split functions-search 8,16,24,32
1935 #@# split functions-search 8
1938 # add variable to be able to check whether the file has been read {{{
1939 ZSHRC_GLOBAL_HAS_BEEN_READ=1
1942 ## END OF FILE #################################################################
1943 # vim:filetype=zsh foldmethod=marker autoindent expandtab shiftwidth=4