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
311 if check_com -c vim ; then
312 export EDITOR=${EDITOR:-vim}
314 export EDITOR=${EDITOR:-vi}
318 export MAIL=${MAIL:-/var/mail/$USER}
320 # if we don't set $SHELL then aterm, rxvt,.. will use /bin/sh or /bin/bash :-/
321 export SHELL='/bin/zsh'
323 # color setup for ls:
324 check_com -c dircolors && eval $(dircolors -b)
326 # set width of man pages to 80 for more convenient reading
327 # (( ${+MANWIDTH} )) || export MANWIDTH=80
329 # Search path for the cd command
332 # completion functions go to /etc/zsh/completion.d
333 # function files may be put into /etc/zsh/functions.d, from where they
334 # will be automatically autoloaded.
335 if [[ -n "$BROKEN_COMPLETION_DIR" ]] ; then
336 print 'Warning: not setting completion directories because broken files have been found.' >&2
338 [[ -d /etc/zsh/completion.d ]] && fpath+=( /etc/zsh/completion.d )
339 if [[ -d /etc/zsh/functions.d ]] ; then
340 fpath+=( /etc/zsh/functions.d )
341 for func in /etc/zsh/functions.d/[^_]*[^~] ; do
342 autoload -U ${func:t}
347 # automatically remove duplicates from these arrays
348 typeset -U path cdpath fpath manpath
352 if [[ "$TERM" != emacs ]] ; then
353 [[ -z "$terminfo[kdch1]" ]] || bindkey -M emacs "$terminfo[kdch1]" delete-char
354 [[ -z "$terminfo[khome]" ]] || bindkey -M emacs "$terminfo[khome]" beginning-of-line
355 [[ -z "$terminfo[kend]" ]] || bindkey -M emacs "$terminfo[kend]" end-of-line
356 [[ -z "$terminfo[kdch1]" ]] || bindkey -M vicmd "$terminfo[kdch1]" vi-delete-char
357 [[ -z "$terminfo[khome]" ]] || bindkey -M vicmd "$terminfo[khome]" vi-beginning-of-line
358 [[ -z "$terminfo[kend]" ]] || bindkey -M vicmd "$terminfo[kend]" vi-end-of-line
359 [[ -z "$terminfo[cuu1]" ]] || bindkey -M viins "$terminfo[cuu1]" vi-up-line-or-history
360 [[ -z "$terminfo[cuf1]" ]] || bindkey -M viins "$terminfo[cuf1]" vi-forward-char
361 [[ -z "$terminfo[kcuu1]" ]] || bindkey -M viins "$terminfo[kcuu1]" vi-up-line-or-history
362 [[ -z "$terminfo[kcud1]" ]] || bindkey -M viins "$terminfo[kcud1]" vi-down-line-or-history
363 [[ -z "$terminfo[kcuf1]" ]] || bindkey -M viins "$terminfo[kcuf1]" vi-forward-char
364 [[ -z "$terminfo[kcub1]" ]] || bindkey -M viins "$terminfo[kcub1]" vi-backward-char
366 [[ "$terminfo[kcuu1]" == $'\eO'* ]] && bindkey -M viins "${terminfo[kcuu1]/O/[}" vi-up-line-or-history
367 [[ "$terminfo[kcud1]" == $'\eO'* ]] && bindkey -M viins "${terminfo[kcud1]/O/[}" vi-down-line-or-history
368 [[ "$terminfo[kcuf1]" == $'\eO'* ]] && bindkey -M viins "${terminfo[kcuf1]/O/[}" vi-forward-char
369 [[ "$terminfo[kcub1]" == $'\eO'* ]] && bindkey -M viins "${terminfo[kcub1]/O/[}" vi-backward-char
370 [[ "$terminfo[khome]" == $'\eO'* ]] && bindkey -M viins "${terminfo[khome]/O/[}" beginning-of-line
371 [[ "$terminfo[kend]" == $'\eO'* ]] && bindkey -M viins "${terminfo[kend]/O/[}" end-of-line
372 [[ "$terminfo[khome]" == $'\eO'* ]] && bindkey -M emacs "${terminfo[khome]/O/[}" beginning-of-line
373 [[ "$terminfo[kend]" == $'\eO'* ]] && bindkey -M emacs "${terminfo[kend]/O/[}" end-of-line
376 ## keybindings (run 'bindkeys' for details, more details via man zshzle)
377 # use emacs style per default:
382 #if [[ "$TERM" == screen ]] ; then
383 bindkey '\e[1~' beginning-of-line # home
384 bindkey '\e[4~' end-of-line # end
385 bindkey '\e[A' up-line-or-search # cursor up
386 bindkey '\e[B' down-line-or-search # <ESC>-
387 bindkey '^x' history-beginning-search-backward # alternative ways of searching the shell history
388 # bindkey -s '^L' "|less\n" # ctrl-L pipes to less
389 # bindkey -s '^B' " &\n" # ctrl-B runs it in the background
390 # if terminal type is set to 'rxvt':
391 bindkey '\e[7~' beginning-of-line # home
392 bindkey '\e[8~' end-of-line # end
395 # insert unicode character
396 # usage example: 'ctrl-x i' 00A7 'ctrl-x i' will give you an §
397 # See for example http://unicode.org/charts/ for unicode characters code
398 autoload insert-unicode-char
399 zle -N insert-unicode-char
400 #k# Insert Unicode character
401 bindkey '^Xi' insert-unicode-char
403 # just type 'cd ...' to get 'cd ../..'
404 # rationalise-dot() {
405 # if [[ $LBUFFER == *.. ]] ; then
411 # zle -N rationalise-dot
412 # bindkey . rationalise-dot
414 # bindkey '\eq' push-line-or-edit
417 # a generic accept-line wrapper {{{
419 # This widget can prevent unwanted autocorrections from command-name
420 # to _command-name, rehash automatically on enter and call any number
421 # of builtin and user-defined widgets in different contexts.
423 # For a broader description, see:
424 # <http://bewatermyfriend.org/posts/2007/12-26.11-50-38-tooltime.html>
426 # A newly added command will may not be found or will cause false
427 # correction attempts, if you got auto-correction set. By setting the
428 # following style, we force accept-line() to rehash, if it cannot
429 # find the first word on the command line in the $command[] hash.
430 zstyle ':acceptline:*' rehash true
432 function Accept-Line() {
433 setopt localoptions noksharrays
438 zstyle -a ":acceptline:${alcontext}" actions subs
440 (( ${#subs} < 1 )) && return 0
443 for sub in ${subs} ; do
444 [[ ${sub} == 'accept-line' ]] && sub='.accept-line'
447 (( aldone > 0 )) && break
451 function Accept-Line-getdefault() {
454 zstyle -s ":acceptline:${alcontext}" default_action default_action
455 case ${default_action} in
457 printf ".accept-line"
460 printf ${default_action}
465 function accept-line() {
466 setopt localoptions noksharrays
469 local buf com fname format msg default_action
473 cmdline=(${(z)BUFFER})
477 zstyle -t ":acceptline:${alcontext}" rehash \
478 && [[ -z ${commands[$com]} ]] \
481 if [[ -n ${reswords[(r)$com]} ]] \
482 || [[ -n ${aliases[$com]} ]] \
483 || [[ -n ${functions[$com]} ]] \
484 || [[ -n ${builtins[$com]} ]] \
485 || [[ -n ${commands[$com]} ]] ; then
487 # there is something sensible to execute, just do it.
491 default_action=$(Accept-Line-getdefault)
492 zstyle -T ":acceptline:${alcontext}" call_default \
493 && zle ${default_action}
497 if [[ -o correct ]] \
498 || [[ -o correctall ]] \
499 && [[ -n ${functions[$fname]} ]] ; then
501 # nothing there to execute but there is a function called
502 # _command_name; a completion widget. Makes no sense to
503 # call it on the commandline, but the correct{,all} options
504 # will ask for it nevertheless, so warn the user.
505 if [[ ${LASTWIDGET} == 'accept-line' ]] ; then
506 # Okay, we warned the user before, he called us again,
507 # so have it his way.
511 default_action=$(Accept-Line-getdefault)
512 zstyle -T ":acceptline:${alcontext}" call_default \
513 && zle ${default_action}
517 # prepare warning message for the user, configurable via zstyle.
518 zstyle -s ":acceptline:${alcontext}" compwarnfmt msg
520 if [[ -z ${msg} ]] ; then
521 msg="%c will not execute and completion %f exists."
524 zformat -f msg "${msg}" "c:${com}" "f:${fname}"
528 elif [[ -n ${buf//[$' \t\n']##/} ]] ; then
529 # If we are here, the commandline contains something that is not
530 # executable, which is neither subject to _command_name correction
531 # and is not empty. might be a variable assignment
535 default_action=$(Accept-Line-getdefault)
536 zstyle -T ":acceptline:${alcontext}" call_default \
537 && zle ${default_action}
541 # If we got this far, the commandline only contains whitespace, or is empty.
545 default_action=$(Accept-Line-getdefault)
546 zstyle -T ":acceptline:${alcontext}" call_default \
547 && zle ${default_action}
555 # power completion - abbreviation expansion {{{
556 # power completion / abbreviation expansion / buffer expansion
557 # see http://zshwiki.org/home/examples/zleiab for details
558 # less risky than the global aliases but powerful as well
559 # just type the abbreviation key and afterwards ',.' to expand it
562 setopt interactivecomments
564 # key # value (#d additional doc string)
570 'G' '|& grep --color=auto'
572 'Hl' ' --help |& less -r' #d (Display help in pager)
576 'N' '&>/dev/null' #d (No Output)
577 'R' '| tr A-z N-za-m' #d (ROT13)
583 'hide' "echo -en '\033]50;nil2\007'"
584 'tiny' 'echo -en "\033]50;-misc-fixed-medium-r-normal-*-*-80-*-*-c-*-iso8859-15\007"'
585 'small' 'echo -en "\033]50;6x10\007"'
586 'medium' 'echo -en "\033]50;-misc-fixed-medium-r-normal--13-120-75-75-c-80-iso8859-15\007"'
587 'default' 'echo -e "\033]50;-misc-fixed-medium-r-normal-*-*-140-*-*-c-*-iso8859-15\007"'
588 'large' 'echo -en "\033]50;-misc-fixed-medium-r-normal-*-*-150-*-*-c-*-iso8859-15\007"'
589 'huge' 'echo -en "\033]50;-misc-fixed-medium-r-normal-*-*-210-*-*-c-*-iso8859-15\007"'
590 'smartfont' 'echo -en "\033]50;-artwiz-smoothansi-*-*-*-*-*-*-*-*-*-*-*-*\007"'
591 'semifont' 'echo -en "\033]50;-misc-fixed-medium-r-semicondensed-*-*-120-*-*-*-*-iso8859-15\007"'
595 'co' "./configure && make && sudo make install"
596 'CH' "./configure --help"
597 'conkeror' 'firefox -chrome chrome://conkeror/content'
599 'lad' $'ls -d .*(/)\n# only show dot-directories'
600 'lsa' $'ls -a .*(.)\n# only show dot-files'
601 'lss' $'ls -l *(s,S,t)\n# only files with setgid/setuid/sticky flag'
602 'lsl' $'ls -l *(@[1,10])\n# only symlinks'
603 'lsx' $'ls -l *(*[1,10])\n# only executables'
604 'lsw' $'ls -ld *(R,W,X.^ND/)\n# world-{readable,writable,executable} files'
605 'lsbig' $'ls -flh *(.OL[1,10])\n# display the biggest files'
606 'lsd' $'ls -d *(/)\n# only show directories'
607 'lse' $'ls -d *(/^F)\n# only show empty directories'
608 'lsnew' $'ls -rl *(D.om[1,10])\n# display the newest files'
609 'lsold' $'ls -rtlh *(D.om[-11,-1])\n # display the oldest files'
610 'lssmall' $'ls -Srl *(.oL[1,10])\n# display the smallest files'
612 '600' 'chmod u+rw-x,g-rwx,o-rwx'
614 '700' 'chmod u+rwx,g-rwx,o-rwx'
615 'r--' 'chmod u+r-wx,g-rwx,o-rwx'
616 '644' $'chmod u+rw-x,g+r-wx,o+r-wx\n # 4=r,2=w,1=x'
617 '755' 'chmod u+rwx,g+r-w+x,o+r-w+x'
619 'cmplayer' 'mplayer -vo -fs -zoom fbdev'
620 'fbmplayer' 'mplayer -vo -fs -zoom fbdev'
621 'fblinks' 'links2 -driver fb'
622 'insecssh' 'ssh -o "StrictHostKeyChecking=no" -o "UserKnownHostsFile=/dev/null"'
623 'insecscp' 'scp -o "StrictHostKeyChecking=no" -o "UserKnownHostsFile=/dev/null"'
624 'fori' 'for i ({..}) { }'
627 'se' 'setopt interactivecomments'
628 'va' 'valac --vapidir=../vapi/ --pkg=gtk+-2.0 gtktest.vala'
629 'fb2' '=mplayer -vo fbdev -fs -zoom 1>/dev/null -xy 2'
630 'fb3' '=mplayer -vo fbdev -fs -zoom 1>/dev/null -xy 3'
632 'D' 'export DISPLAY=:0.0'
633 'mp' 'mplayer -vo xv -fs -zoom'
638 matched_chars='[.-|_a-zA-Z0-9]#'
639 LBUFFER=${LBUFFER%%(#m)[.-|_a-zA-Z0-9]#}
640 LBUFFER+=${abk[$MATCH]:-$MATCH}
644 bindkey ",." globalias
648 autoload -U zmv # who needs mmv or rename?
649 autoload history-search-end
651 # we don't want to quote/espace URLs on our own...
652 # if autoload -U url-quote-magic ; then
653 # zle -N self-insert url-quote-magic
654 # zstyle ':url-quote-magic:*' url-metas '*?[]^()~#{}='
656 # print 'Notice: no url-quote-magic available :('
658 alias url-quote='autoload -U url-quote-magic ; zle -N self-insert url-quote-magic'
660 #m# k ESC-h Call \kbd{run-help} for the 1st word on the command line
661 alias run-help >&/dev/null && unalias run-help
662 autoload run-help # use via 'esc-h'
665 if autoload -U compinit && compinit 2>/dev/null ; then
666 compinit 2>/dev/null || print 'Notice: no compinit available :('
668 print 'Notice: no compinit available :('
673 is4 && autoload -U zed # use ZLE editor to edit a file or function
676 for mod in complist deltochar mathfunc ; do
677 zmodload -i zsh/${mod} 2>/dev/null || print "Notice: no ${mod} available :("
680 # autoload zsh modules when they are referenced
689 while (( ${#tmpargs} > 0 )) ; do
690 zmodload -${tmpargs[1]} zsh/${tmpargs[2]} ${tmpargs[2]}
696 if is4 && autoload -U insert-files && zle -N insert-files ; then
698 bindkey "^Xf" insert-files # C-x-f
701 bindkey ' ' magic-space # also do history expansion on space
702 #k# Trigger menu-complete
703 bindkey '\ei' menu-complete # menu completion via esc-i
705 # press esc-e for editing command line in $EDITOR or $VISUAL
706 if is4 && autoload -U edit-command-line && zle -N edit-command-line ; then
707 #k# Edit the current line in \kbd{\$EDITOR}
708 bindkey '\ee' edit-command-line
711 if is4 && [[ -n ${(k)modules[zsh/complist]} ]] ; then
712 #k# menu selection: pick item but stay in the menu
713 bindkey -M menuselect '\e^M' accept-and-menu-complete
715 # use the vi navigation keys (hjkl) besides cursor keys in menu completion
716 #bindkey -M menuselect 'h' vi-backward-char # left
717 #bindkey -M menuselect 'k' vi-up-line-or-history # up
718 #bindkey -M menuselect 'l' vi-forward-char # right
719 #bindkey -M menuselect 'j' vi-down-line-or-history # bottom
721 # accept a completion and try to complete again by using menu
722 # completion; very useful with completing directories
723 # by using 'undo' one's got a simple file browser
724 bindkey -M menuselect '^o' accept-and-infer-next-history
727 # press "ctrl-e d" to insert the actual date in the form yyyy-mm-dd
728 _bkdate() { BUFFER="$BUFFER$(date '+%F')"; CURSOR=$#BUFFER; }
731 #k# Insert a timestamp on the command line (yyyy-mm-dd)
732 bindkey '^Ed' _bkdate
734 # press esc-m for inserting last typed word again (thanks to caphuso!)
735 insert-last-typed-word() { zle insert-last-word -- 0 -1 };
736 zle -N insert-last-typed-word;
738 #k# Insert last typed word
739 bindkey "\em" insert-last-typed-word
741 # set command prediction from history, see 'man 1 zshcontrib'
742 # is4 && autoload -U predict-on && \
743 # zle -N predict-on && \
744 # zle -N predict-off && \
745 # bindkey "^X^Z" predict-on && \
746 # bindkey "^Z" predict-off
748 #k# Shortcut for \kbd{fg<enter>}
749 bindkey -s '^z' "fg\n"
751 # press ctrl-q to quote line:
753 # zle beginning-of-line
755 # # RBUFFER="'$RBUFFER'"
756 # RBUFFER=${(q)RBUFFER}
759 # zle -N mquote && bindkey '^q' mquote
761 # run command line as user root via sudo:
762 sudo-command-line() {
763 [[ -z $BUFFER ]] && zle up-history
764 [[ $BUFFER != sudo\ * ]] && BUFFER="sudo $BUFFER"
766 zle -N sudo-command-line
768 #k# Put the current command line into a \kbd{sudo} call
769 bindkey "^Os" sudo-command-line
771 ### jump behind the first word on the cmdline.
772 ### useful to add options.
773 function jump_after_first_word() {
777 if (( ${#words} <= 1 )) ; then
780 CURSOR=${#${words[1]}}
783 zle -N jump_after_first_word
785 bindkey '^x1' jump_after_first_word
789 # {{{ set some important options
790 # Please update these tags, if you change the umask settings below.
792 #o# r_umaskstr rwxrwxr-x
794 #o# umaskstr rwxr-xr-x
795 (( EUID != 0 )) && umask 002 || umask 022
798 setopt append_history # append history list to the history file (important for multiple parallel zsh sessions!)
799 is4 && setopt SHARE_HISTORY # import new commands from the history file also in other zsh-session
800 setopt extended_history # save each command's beginning timestamp and the duration to the history file
801 is4 && setopt histignorealldups # If a new command line being added to the history
802 # list duplicates an older one, the older command is removed from the list
803 setopt histignorespace # remove command lines from the history list when
804 # the first character on the line is a space
805 # setopt histallowclobber # add `|' to output redirections in the history
806 # setopt NO_clobber # warning if file exists ('cat /dev/null > ~/.zshrc')
807 setopt auto_cd # if a command is issued that can't be executed as a normal command,
808 # and the command is the name of a directory, perform the cd command to that directory
809 setopt extended_glob # in order to use #, ~ and ^ for filename generation
810 # grep word *~(*.gz|*.bz|*.bz2|*.zip|*.Z) ->
811 # -> searches for word not in compressed files
812 # don't forget to quote '^', '~' and '#'!
813 setopt notify # report the status of backgrounds jobs immediately
814 setopt hash_list_all # Whenever a command completion is attempted, make sure \
815 # the entire command path is hashed first.
816 setopt completeinword # not just at the end
817 # setopt nocheckjobs # don't warn me about bg processes when exiting
818 setopt nohup # and don't kill them, either
819 # setopt printexitvalue # alert me if something failed
820 # setopt dvorak # with spelling correction, assume dvorak kb
821 setopt auto_pushd # make cd push the old directory onto the directory stack.
822 setopt nonomatch # try to avoid the 'zsh: no matches found...'
823 setopt nobeep # avoid "beep"ing
824 setopt pushd_ignore_dups # don't push the same dir twice.
826 MAILCHECK=30 # mailchecks
827 REPORTTIME=5 # report about cpu-/system-/user-time of command if running longer than 5 seconds
828 watch=(notme root) # watch for everyone but me and root
830 # define word separators (for stuff like backward-word, forward-word, backward-kill-word,..)
831 # WORDCHARS='*?_-.[]~=/&;!#$%^(){}<>' # the default
833 # WORDCHARS='*?_[]~=&;!#$%^(){}'
834 # WORDCHARS='${WORDCHARS:s@/@}'
836 # only slash should be considered as a word separator:
837 slash-backward-kill-word() {
838 local WORDCHARS="${WORDCHARS:s@/@}"
840 zle backward-kill-word
842 zle -N slash-backward-kill-word
844 #k# Kill everything in a word up to its last \kbd{/}
845 bindkey '\ev' slash-backward-kill-word
854 HISTFILE=$HOME/.zsh_history
855 isgrmlcd && HISTSIZE=500 || HISTSIZE=5000
856 isgrmlcd && SAVEHIST=1000 || SAVEHIST=10000 # useful for setopt append_history
860 # dirstack handling {{{
863 if [[ -f ~/.zdirs ]] && [[ ${#dirstack[*]} -eq 0 ]] ; then
864 dirstack=( ${(f)"$(< ~/.zdirs)"} )
865 # "cd -" won't work after login by just setting $OLDPWD, so
866 [[ -d $dirstack[0] ]] && cd $dirstack[0] && cd $OLDPWD
870 builtin dirs -pl >! ~/.zdirs
875 # {{{ display battery status on right side of prompt via running 'BATTERY=1 zsh'
876 if [[ -n "$BATTERY" ]] ; then
877 if check_com -c acpi ; then
878 PERCENT="${(C)${(s| |)$(acpi 2>/dev/null)}[4]}"
879 [[ -z "$PERCENT" ]] && PERCENT='acpi not present'
881 if [[ "${PERCENT%%%}" -lt 20 ]] ; then
882 PERCENT="warning: ${PERCENT}%"
888 # display version control information on right side of prompt if $VCS is set {{{
889 # based on Mike Hommey's http://web.glandium.org/blog/?p=170
891 local vcs base_dir sub_dir ref
895 sub_dir=$(readlink -f "${PWD}")
896 sub_dir=${sub_dir#$1}
901 base_dir=$(git-rev-parse --show-cdup 2>/dev/null) || return 1
902 base_dir=$(readlink -f "$base_dir/..")
903 sub_dir=$(git-rev-parse --show-prefix)
905 ref=$(git-symbolic-ref -q HEAD || git-name-rev --name-only HEAD 2>/dev/null)
906 ref=${ref#refs/heads/}
911 [[ -d ".svn" ]] || return 1
913 while [[ -d "$base_dir/../.svn" ]]; do base_dir="$base_dir/.."; done
914 base_dir=$(readlink -f "$base_dir")
915 sub_dir=$(sub_dir "${base_dir}")
916 ref=$(svn info "$base_dir" | awk '/^URL/ { sub(".*/","",$0); r=$0 } /^Revision/ { sub("[^0-9]*","",$0); print r":"$0 }')
921 [[ -f ~/.svk/config ]] || return 1
922 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
925 base_dir=${base_dir%%
927 sub_dir=$(sub_dir "${base_dir}")
933 while [[ ! -d "$base_dir/.hg" ]]; do
934 base_dir="$base_dir/.."
935 [[ $(readlink -f "${base_dir}") = "/" ]] && return 1
937 base_dir=$(readlink -f "$base_dir")
938 sub_dir=$(sub_dir "${base_dir}")
939 ref=$(< "${base_dir}/.hg/branch")
948 # echo "${vcs:+($vcs)}${base_dir/$HOME/~}${vcs:+[$ref]${sub_dir}}"
949 echo "${vcs:+($vcs)}${base_dir}${vcs:+[$ref]${sub_dir}}"
954 if autoload promptinit && promptinit 2>/dev/null ; then
955 promptinit # people should be able to use their favourite prompt
957 print 'Notice: no promptinit available :('
961 # precmd() => a function which is executed just before each prompt
962 # use 'NOPRECMD=1' to disable the precmd + preexec commands
964 # precmd () { setopt promptsubst; [[ -o interactive ]] && jobs -l;
966 # make sure to use right prompt only when not running a command
967 is41 && setopt transient_rprompt
969 is4 && [[ -z $NOPRECMD ]] && precmd () {
970 [[ -n $NOPRECMD ]] && return 0
971 # allow manual overwriting of RPROMPT
972 if [[ -n $RPROMPT ]] ; then
973 [[ $TERM == screen* ]] && echo -n $'\ekzsh\e\\'
976 # just use DONTSETRPROMPT=1 to be able to overwrite RPROMPT
977 if [[ -z $DONTSETRPROMPT ]] ; then
978 if [[ -n $BATTERY ]] ; then
979 RPROMPT="%(?..:()% ${PERCENT}${SCREENTITLE}"
980 # RPROMPT="${PERCENT}${SCREENTITLE}"
981 elif [[ -n $VCS ]] ; then
982 RPROMPT="%(?..:()% $(__vcs_dir)${SCREENTITLE}"
984 RPROMPT="%(?..:()% ${SCREENTITLE}"
985 # RPROMPT="${SCREENTITLE}"
988 # adjust title of xterm
989 # see http://www.faqs.org/docs/Linux-mini/Xterm-Title.html
992 print -Pn "\e]0;%n@%m: %~\a"
997 # chpwd () => a function which is executed whenever the directory is changed
999 # preexec() => a function running before every command
1000 is4 && [[ -z $NOPRECMD ]] && \
1002 [[ -n $NOPRECMD ]] && return 0
1003 # set hostname if not running on host with name 'grml'
1004 if [[ "$HOSTNAME" != $(hostname) ]] ; then
1007 # get the name of the program currently running and hostname of local machine
1008 # set screen window title if running in a screen
1009 if [[ "$TERM" == screen* ]] ; then
1010 # local CMD=${1[(wr)^(*=*|sudo|ssh|-*)]} # don't use hostname
1011 local CMD="${1[(wr)^(*=*|sudo|ssh|-*)]}$NAME" # use hostname
1012 echo -ne "\ek$CMD\e\\"
1014 # set the screen title to "zsh" when sitting at the command prompt:
1015 if [[ "$TERM" == screen* ]] ; then
1016 SCREENTITLE=$'%{\ekzsh\e\\%}'
1020 # adjust title of xterm
1023 print -Pn "\e]0;%n@%m: $1\a"
1029 if autoload colors && colors 2>/dev/null ; then
1030 BLUE="%{${fg[blue]}%}"
1031 RED="%{${fg_bold[red]}%}"
1032 GREEN="%{${fg[green]}%}"
1033 CYAN="%{${fg[cyan]}%}"
1034 WHITE="%{${fg[white]}%}"
1035 NO_COLOUR="%{${reset_color}%}"
1037 BLUE=$'%{\e[1;34m%}'
1039 GREEN=$'%{\e[1;32m%}'
1040 CYAN=$'%{\e[1;36m%}'
1041 WHITE=$'%{\e[1;37m%}'
1042 NO_COLOUR=$'%{\e[0m%}'
1045 EXITCODE="%(?..%?%1v )"
1046 PS2='`%_> ' # secondary prompt, printed when the shell needs more information to complete a command.
1047 PS3='?# ' # selection prompt used within a select loop.
1048 PS4='+%N:%i:%_> ' # the execution trace prompt (setopt xtrace). default: '+%N:%i>'
1050 # set variable debian_chroot if running in a chroot with /etc/debian_chroot
1051 if [[ -z "$debian_chroot" ]] && [[ -r /etc/debian_chroot ]] ; then
1052 debian_chroot=$(cat /etc/debian_chroot)
1055 # don't use colors on dumb terminals (like emacs):
1056 if [[ "$TERM" == dumb ]] ; then
1057 PROMPT="${EXITCODE}${debian_chroot:+($debian_chroot)}%n@%m %40<...<%B%~%b%<< %# "
1059 # only if $GRMLPROMPT is set (e.g. via 'GRMLPROMPT=1 zsh') use the extended prompt
1060 # set variable identifying the chroot you work in (used in the prompt below)
1061 if [[ -n $GRMLPROMPT ]] ; then
1062 PROMPT="${RED}${EXITCODE}${CYAN}[%j running job(s)] ${GREEN}{history#%!} ${RED}%(3L.+.) ${BLUE}%* %D
1063 ${BLUE}%n${NO_COLOUR}@%m %40<...<%B%~%b%<< %# "
1065 if (( EUID != 0 )); then
1066 PROMPT="${RED}${EXITCODE}${WHITE}${debian_chroot:+($debian_chroot)}${BLUE}%n${NO_COLOUR}@%m %40<...<%B%~%b%<< %# " # primary prompt string
1068 PROMPT="${BLUE}${EXITCODE}${WHITE}${debian_chroot:+($debian_chroot)}${RED}%n${NO_COLOUR}@%m %40<...<%B%~%b%<< %# " # primary prompt string
1073 # if we are inside a grml-chroot set a specific prompt theme
1074 if [[ -n "$GRML_CHROOT" ]] ; then
1075 PROMPT="%{$fg[red]%}(CHROOT) %{$fg_bold[red]%}%n%{$fg_no_bold[white]%}@%m %40<...<%B%~%b%<< %\# "
1079 # {{{ 'hash' some often used directories
1081 hash -d deb=/var/cache/apt/archives
1082 hash -d doc=/usr/share/doc
1083 hash -d linux=/lib/modules/$(command uname -r)/build/
1084 hash -d log=/var/log
1085 hash -d slog=/var/log/syslog
1086 hash -d src=/usr/src
1087 hash -d templ=/usr/share/doc/grml-templates
1088 hash -d tt=/usr/share/doc/texttools-doc
1089 hash -d www=/var/www
1094 if [[ $UID -eq 0 ]] ; then
1095 [[ -r /etc/grml/screenrc ]] && alias screen='/usr/bin/screen -c /etc/grml/screenrc'
1096 elif [[ -r $HOME/.screenrc ]] ; then
1097 alias screen="/usr/bin/screen -c $HOME/.screenrc"
1099 [[ -r /etc/grml/screenrc_grml ]] && alias screen='/usr/bin/screen -c /etc/grml/screenrc_grml'
1102 # do we have GNU ls with color-support?
1103 if ls --help 2>/dev/null | grep -- --color= >/dev/null && [[ "$TERM" != dumb ]] ; then
1104 #a1# execute \kbd{@a@}:\quad ls with colors
1105 alias ls='ls -b -CF --color=auto'
1106 #a1# execute \kbd{@a@}:\quad list all files, with colors
1107 alias la='ls -la --color=auto'
1108 #a1# long colored list, without dotfiles (@a@)
1109 alias ll='ls -l --color=auto'
1110 #a1# long colored list, human readable sizes (@a@)
1111 alias lh='ls -hAl --color=auto'
1112 #a1# List files, append qualifier to filenames \\&\quad(\kbd{/} for directories, \kbd{@} for symlinks ...)
1113 alias l='ls -lF --color=auto'
1115 alias ls='ls -b -CF'
1122 alias mdstat='cat /proc/mdstat'
1123 alias ...='cd ../../'
1125 # generate alias named "$KERNELVERSION-reboot" so you can use boot with kexec:
1126 if [[ -x /sbin/kexec ]] && [[ -r /proc/cmdline ]] ; then
1127 alias "$(uname -r)-reboot"="kexec -l --initrd=/boot/initrd.img-"$(uname -r)" --command-line=\"$(cat /proc/cmdline)\" /boot/vmlinuz-"$(uname -r)""
1130 alias cp='nocorrect cp' # no spelling correction on cp
1131 alias mkdir='nocorrect mkdir' # no spelling correction on mkdir
1132 alias mv='nocorrect mv' # no spelling correction on mv
1133 alias rm='nocorrect rm' # no spelling correction on rm
1135 #a1# Execute \kbd{rmdir}
1137 #a1# Execute \kbd{rmdir}
1140 # see http://www.cl.cam.ac.uk/~mgk25/unicode.html#term for details
1141 alias term2iso="echo 'Setting terminal to iso mode' ; print -n '\e%@'"
1142 alias term2utf="echo 'Setting terminal to utf-8 mode'; print -n '\e%G'"
1144 # make sure it is not assigned yet
1145 [[ $(whence -w utf2iso &>/dev/null) == 'utf2iso: alias' ]] && unalias utf2iso
1149 for ENV in $(env | command grep -i '.utf') ; do
1150 eval export "$(echo $ENV | sed 's/UTF-8/iso885915/ ; s/utf8/iso885915/')"
1155 # make sure it is not assigned yet
1156 [[ $(whence -w iso2utf &>/dev/null) == 'iso2utf: alias' ]] && unalias iso2utf
1158 if ! isutfenv ; then
1159 for ENV in $(env | command grep -i '\.iso') ; do
1160 eval export "$(echo $ENV | sed 's/iso.*/UTF-8/ ; s/ISO.*/UTF-8/')"
1165 # set up software synthesizer via speakup
1167 aumix -w 90 -v 90 -p 90 -m 90
1168 if ! [[ -r /dev/softsynth ]] ; then
1169 flite -o play -t "Sorry, software synthesizer not available. Did you boot with swspeak bootoption?"
1172 setopt singlelinezle
1175 nice -n -20 speechd-up
1177 flite -o play -t "Finished setting up software synthesizer"
1181 # I like clean prompt, so provide simple way to get that
1182 check_com 0 || alias 0='return 0'
1184 # for really lazy people like mika:
1185 check_com S &>/dev/null || alias S='screen'
1186 check_com s &>/dev/null || alias s='ssh'
1188 # get top 10 shell commands:
1189 alias top10='print -l ? ${(o)history%% *} | uniq -c | sort -nr | head -n 10'
1191 # truecrypt; use e.g. via 'truec /dev/ice /mnt/ice' or 'truec -i'
1192 if check_com -c truecrypt ; then
1194 alias truec='truecrypt --mount-options "rw,sync,dirsync,users,uid=1000,gid=users,umask=077,utf8" '
1196 alias truec='truecrypt --mount-options "rw,sync,dirsync,users,uid=1000,gid=users,umask=077" '
1200 #f1# Hints for the use of zsh on grml
1202 print "$bg[white]$fg[black]
1203 zsh-help - hints for use of zsh on grml
1204 =======================================$reset_color"
1207 Main configuration of zsh happens in /etc/zsh/zshrc (global)
1208 and /etc/skel/.zshrc which is copied to $HOME/.zshrc once.
1209 The files are part of the package grml-etc-core, if you want to
1210 use them on a non-grml-system just get the tar.gz from
1211 http://deb.grml.org/ or get the files from the mercurial
1214 http://hg.grml.org/grml-etc-core/raw-file/tip/etc/skel/.zshrc
1215 http://hg.grml.org/grml-etc-core/raw-file/tip/etc/zsh/zshrc
1217 If you want to stay in sync with zsh configuration of grml
1218 run '\''ln -sf /etc/skel/.zshrc $HOME/.zshrc'\'' and configure
1219 your own stuff in $HOME/.zshrc.local. System wide configuration
1220 without touching configuration files of grml can take place
1221 in /etc/zsh/zshrc.local.
1223 If you want to use the configuration of user grml also when
1224 running as user root just run '\''zshskel'\'' which will source
1225 the file /etc/skel/.zshrc.
1227 For information regarding zsh start at http://grml.org/zsh/
1229 Take a look at grml'\''s zsh refcard:
1230 % xpdf =(zcat /usr/share/doc/grml-docs/zsh/grml-zsh-refcard.pdf.gz)
1232 Check out the main zsh refcard:
1233 % '$BROWSER' http://www.bash2zsh.com/zsh_refcard/refcard.pdf
1235 And of course visit the zsh-lovers:
1238 You can adjust some options through environment variables when
1239 invoking zsh without having to edit configuration files.
1240 Basically meant for bash users who are not used to the power of
1243 "NOCOR=1 zsh" => deactivate automatic correction
1244 "NOMENU=1 zsh" => do not use menu completion (note: use strg-d for completion instead!)
1245 "NOPRECMD=1 zsh" => disable the precmd + preexec commands (set GNU screen title)
1246 "BATTERY=1 zsh" => activate battery status (via acpi) on right side of prompt'
1249 $bg[white]$fg[black]
1250 Please report wishes + bugs to the grml-team: http://grml.org/bugs/
1251 Enjoy your grml system with the zsh!$reset_color"
1255 if [[ -r /etc/debian_version ]] ; then
1256 #a3# Execute \kbd{apt-cache search}
1257 alias acs='apt-cache search'
1258 #a3# Execute \kbd{apt-cache show}
1259 alias acsh='apt-cache show'
1260 #a3# Execute \kbd{apt-cache policy}
1261 alias acp='apt-cache policy'
1262 #a3# Execute \kbd{apt-get dist-upgrade}
1263 salias adg="apt-get dist-upgrade"
1264 #a3# Execute \kbd{apt-get install}
1265 salias agi="apt-get install"
1266 #a3# Execute \kbd{aptitude install}
1267 salias ati="aptitude install"
1268 #a3# Execute \kbd{apt-get upgrade}
1269 salias ag="apt-get upgrade"
1270 #a3# Execute \kbd{apt-get update}
1271 salias au="apt-get update"
1272 #a3# Execute \kbd{aptitude update ; aptitude safe-upgrade}
1273 salias -a up="aptitude update ; aptitude safe-upgrade"
1274 #a3# Execute \kbd{dpkg-buildpackage}
1275 alias dbp='dpkg-buildpackage'
1276 #a3# Execute \kbd{grep-excuses}
1277 alias ge='grep-excuses'
1280 #f3# Execute \kbd{apt-get update \&\& }\\&\quad \kbd{apt-get dist-upgrade}
1282 if [[ -z "$1" ]] ; then
1283 $SUDO apt-get update
1284 $SUDO apt-get -u upgrade
1286 ssh $1 $SUDO apt-get update
1287 # ask before the upgrade
1289 ssh $1 $SUDO apt-get --no-act upgrade
1290 echo -n 'Process the upgrade?'
1292 if [[ $dummy == "y" ]] ; then
1293 ssh $1 $SUDO apt-get -u upgrade --yes
1298 isgrmlcd && alias su="sudo -s" # get a root shell
1299 #a1# Take a look at the syslog: \kbd{\$PAGER /var/log/syslog}
1300 alias llog="$PAGER /var/log/syslog" # take a look at the syslog
1301 #a1# Take a look at the syslog: \kbd{tail -f /var/log/syslog}
1302 alias tlog="tail -f /var/log/syslog" # follow the syslog
1303 #a1# (Re)-source \kbd{/etc/skel/.zshrc}
1304 alias zshskel="source /etc/skel/.zshrc" # source skeleton zshrc
1307 # sort installed Debian-packages by size
1308 if check_com -c grep-status ; then
1309 #a3# List installed Debian-packages sorted by size
1310 alias debs-by-size='grep-status -FStatus -sInstalled-Size,Package -n "install ok installed" | paste -sd " \n" | sort -rn'
1313 # if cdrecord is a symlink (to wodim) or isn't present at all warn:
1314 if [[ -L /usr/bin/cdrecord ]] || ! check_com -c cdrecord ; then
1315 if check_com -c wodim ; then
1316 alias cdrecord="echo 'cdrecord is not provided under its original name by Debian anymore.
1317 See #377109 in the BTS of Debian for more details.
1319 Please use the wodim binary instead' ; return 1"
1323 # get_tw_cli has been renamed into get_3ware
1324 if check_com -c get_3ware ; then
1326 echo 'Warning: get_tw_cli has been renamed into get_3ware. Invoking get_3ware for you.'>&2
1331 # I hate lacking backward compatibility, so provide an alternative therefore
1332 if ! check_com -c apache2-ssl-certificate ; then
1334 apache2-ssl-certificate() {
1336 print 'Debian does not ship apache2-ssl-certificate anymore (see #398520). :('
1337 print 'You might want to take a look at Debian the package ssl-cert as well.'
1338 print 'To generate a certificate for use with apache2 follow the instructions:'
1342 export RANDFILE=/dev/random
1343 mkdir /etc/apache2/ssl/
1344 openssl req $@ -new -x509 -days 365 -nodes -out /etc/apache2/ssl/apache.pem -keyout /etc/apache2/ssl/apache.pem
1345 chmod 600 /etc/apache2/ssl/apache.pem
1347 Run "grml-tips ssl-certificate" if you need further instructions.
1353 # {{{ Use hard limits, except for a smaller stack and no core dumps
1356 isgrmlcd && limit core 0 # important for a live-cd-system
1360 # {{{ completion system
1362 # called later (via is4 && grmlcomp)
1363 # notice: use 'zstyle' for getting current settings
1364 # press ^Xh (control-x h) for getting tags in context; ^X? (control-x ?) to run complete_debug with trace output
1366 # TODO: This could use some additional information
1368 # allow one error for every three characters typed in approximate completer
1369 zstyle ':completion:*:approximate:' max-errors 'reply=( $((($#PREFIX+$#SUFFIX)/3 )) numeric )'
1371 # don't complete backup files as executables
1372 zstyle ':completion:*:complete:-command-::commands' ignored-patterns '(aptitude-*|*\~)'
1374 # start menu completion only if it could find no unambiguous initial string
1375 zstyle ':completion:*:correct:*' insert-unambiguous true
1376 zstyle ':completion:*:corrections' format $'%{\e[0;31m%}%d (errors: %e)%{\e[0m%}'
1377 zstyle ':completion:*:correct:*' original true
1379 # activate color-completion
1380 zstyle ':completion:*:default' list-colors ${(s.:.)LS_COLORS}
1382 # format on completion
1383 zstyle ':completion:*:descriptions' format $'%{\e[0;31m%}completing %B%d%b%{\e[0m%}'
1385 # complete 'cd -<tab>' with menu
1386 zstyle ':completion:*:*:cd:*:directory-stack' menu yes select
1388 # insert all expansions for expand completer
1389 zstyle ':completion:*:expand:*' tag-order all-expansions
1390 zstyle ':completion:*:history-words' list false
1393 zstyle ':completion:*:history-words' menu yes
1395 # ignore duplicate entries
1396 zstyle ':completion:*:history-words' remove-all-dups yes
1397 zstyle ':completion:*:history-words' stop yes
1399 # match uppercase from lowercase
1400 zstyle ':completion:*' matcher-list 'm:{a-z}={A-Z}'
1402 # separate matches into groups
1403 zstyle ':completion:*:matches' group 'yes'
1404 zstyle ':completion:*' group-name ''
1406 if [[ -z "$NOMENU" ]] ; then
1407 # if there are more than 5 options allow selecting from a menu
1408 zstyle ':completion:*' menu select=5
1410 # don't use any menus at all
1414 zstyle ':completion:*:messages' format '%d'
1415 zstyle ':completion:*:options' auto-description '%d'
1417 # describe options in full
1418 zstyle ':completion:*:options' description 'yes'
1420 # on processes completion complete all user processes
1421 zstyle ':completion:*:processes' command 'ps -au$USER'
1423 # offer indexes before parameters in subscripts
1424 zstyle ':completion:*:*:-subscript-:*' tag-order indexes parameters
1426 # provide verbose completion information
1427 zstyle ':completion:*' verbose true
1429 # recent (as of Dec 2007) zsh versions are able to provide descriptions
1430 # for commands (read: 1st word in the line) that it will list for the user
1431 # to choose from. The following disables that, because it's not exactly fast.
1432 zstyle ':completion:*:-command-:*:' verbose false
1434 # set format for warnings
1435 zstyle ':completion:*:warnings' format $'%{\e[0;31m%}No matches for:%{\e[0m%} %d'
1437 # define files to ignore for zcompile
1438 zstyle ':completion:*:*:zcompile:*' ignored-patterns '(*~|*.zwc)'
1439 zstyle ':completion:correct:' prompt 'correct to: %e'
1441 # Ignore completion functions for commands you don't have:
1442 zstyle ':completion::(^approximate*):*:functions' ignored-patterns '_*'
1444 # complete manual by their section
1445 zstyle ':completion:*:manuals' separate-sections true
1446 zstyle ':completion:*:manuals.*' insert-sections true
1447 zstyle ':completion:*:man:*' menu yes select
1449 # run rehash on completion so new installed program are found automatically:
1451 (( CURRENT == 1 )) && rehash
1456 # some people don't like the automatic correction - so run 'NOCOR=1 zsh' to deactivate it
1457 if [[ -n "$NOCOR" ]] ; then
1458 zstyle ':completion:*' completer _oldlist _expand _force_rehash _complete _files _ignored
1461 # try to be smart about when to use what completer...
1463 zstyle -e ':completion:*' completer '
1464 if [[ $_last_try != "$HISTNO$BUFFER$CURSOR" ]] ; then
1465 _last_try="$HISTNO$BUFFER$CURSOR"
1466 reply=(_complete _match _ignored _prefix _files)
1468 if [[ $words[1] == (rm|mv) ]] ; then
1469 reply=(_complete _files)
1471 reply=(_oldlist _expand _force_rehash _complete _ignored _correct _approximate _files)
1476 # zstyle ':completion:*' completer _complete _correct _approximate
1477 # zstyle ':completion:*' expand prefix suffix
1479 # command for process lists, the local web server details and host completion
1480 zstyle ':completion:*:urls' local 'www' '/var/www/' 'public_html'
1483 [[ -d $ZSHDIR/cache ]] && zstyle ':completion:*' use-cache yes && \
1484 zstyle ':completion::complete:*' cache-path $ZSHDIR/cache/
1486 # host completion /* add brackets as vim can't parse zsh's complex cmdlines 8-) {{{ */
1488 [[ -r ~/.ssh/known_hosts ]] && _ssh_hosts=(${${${${(f)"$(<$HOME/.ssh/known_hosts)"}:#[\|]*}%%\ *}%%,*}) || _ssh_hosts=()
1489 [[ -r /etc/hosts ]] && : ${(A)_etc_hosts:=${(s: :)${(ps:\t:)${${(f)~~"$(</etc/hosts)"}%%\#*}##[:blank:]#[^[:blank:]]#}}} || _etc_hosts=()
1501 zstyle ':completion:*:hosts' hosts $hosts
1502 # zstyle '*' hosts $hosts
1504 # specify your logins:
1506 # {grml,grml1}@foo.invalid
1507 # grml-devel@bar.invalid
1510 # {fred,root}@foo.invalid
1513 # zstyle ':completion:*:my-accounts' users-hosts $my_accounts
1514 # zstyle ':completion:*:other-accounts' users-hosts $other_accounts
1516 # specify specific port/service settings:
1517 # telnet_users_hosts_ports=(
1520 # @mail-server:{smtp,pop3}
1522 # @proxy-server:8000
1524 # zstyle ':completion:*:*:telnet:*' users-hosts-ports $telnet_users_hosts_ports
1526 # use generic completion system for programs not yet defined; (_gnu_generic works
1527 # with commands that provide a --help option with "standard" gnu-like output.)
1528 compdef _gnu_generic tail head feh cp mv df stow uname ipacsum fetchipac
1530 # see upgrade function in this file
1531 compdef _hosts upgrade
1537 # people should use 'grml-x'!
1539 if [[ -e /etc/X11/xorg.conf ]] ; then
1540 [[ -x /usr/bin/startx ]] && /usr/bin/startx "$@" || /usr/X11R6/bin/startx "$@"
1542 echo "Please use the script \"grml-x\" for starting the X Window System
1543 because there does not exist /etc/X11/xorg.conf yet.
1544 If you want to use startx anyway please call \"/usr/bin/startx\"."
1550 if [[ -e /etc/X11/xorg.conf ]] ; then
1551 [[ -x /usr/bin/xinit ]] && /usr/bin/xinit || /usr/X11R6/bin/xinit
1553 echo "Please use the script \"grml-x\" for starting the X Window System.
1554 because there does not exist /etc/X11/xorg.conf yet.
1555 If you want to use xinit anyway please call \"/usr/bin/xinit\"."
1560 if check_com -c 915resolution ; then
1561 alias 855resolution='echo -e "Please use 915resolution as resolution modify tool for Intel graphic chipset."; return -1'
1564 #a1# Output version of running grml
1565 alias grml-version='cat /etc/grml_version'
1567 if check_com -c rebuildfstab ; then
1568 #a1# Rebuild /etc/fstab
1569 alias grml-rebuildfstab='rebuildfstab -v -r -config'
1572 if check_com -c grml-debootstrap ; then
1573 alias debian2hd='print "Installing debian to harddisk is possible via using grml-debootstrap." ; return 1'
1578 # {{{ now run the functions
1580 is4 && isgrml && grmlstuff
1585 is4 && xsource "/etc/zsh/keephack"
1588 # {{{ wonderful idea of using "e" glob qualifier by Peter Stephenson
1589 # You use it as follows:
1590 # $ NTREF=/reference/file
1592 # This lists all the files in the current directory newer than the reference file.
1593 # You can also specify the reference file inline; note quotes:
1594 # $ ls -l *(e:'nt ~/.zshenv':)
1596 if [[ -n $1 ]] ; then
1599 [[ $REPLY -nt $NTREF ]]
1603 # shell functions {{{
1605 #f1# Provide csh compatibility
1606 setenv() { typeset -x "${1}${1:+=}${(@)argv[2,$#]}" } # csh compatibility
1608 #f1# Reload an autoloadable function
1609 freload() { while (( $# )); do; unfunction $1; autoload -U $1; shift; done }
1611 #f1# Reload zsh setup
1613 if [[ "$#*" -eq 0 ]] ; then
1614 [[ -r ~/.zshrc ]] && . ~/.zshrc
1623 compdef _functions reload freload
1625 #f1# List symlinks in detail (more detailed version of 'readlink -f' and 'whence -s')
1627 [[ -z "$1" ]] && printf 'Usage: %s <file(s)>\n' "$0" && return 1
1630 while [[ -h "$file" ]] ; do
1632 file=$(readlink "$file")
1637 # fast manual access
1638 if check_com qma ; then
1639 #f1# View the zsh manual
1640 manzsh() { qma zshall "$1" }
1643 manzsh() { /usr/bin/man zshall | vim -c "se ft=man| se hlsearch" +/"$1" - ; }
1644 # manzsh() { /usr/bin/man zshall | most +/"$1" ; }
1645 # [[ -f ~/.terminfo/m/mostlike ]] && MYLESS='LESS=C TERMINFO=~/.terminfo TERM=mostlike less' || MYLESS='less'
1646 # manzsh() { man zshall | $MYLESS -p $1 ; }
1649 if check_com -c most ; then
1650 #f1# View Debian's changelog of a given package
1652 if [[ -r /usr/share/doc/${1}/changelog.Debian.gz ]] ; then
1653 most /usr/share/doc/${1}/changelog.Debian.gz
1654 elif [[ -r /usr/share/doc/${1}/changelog.gz ]] ; then
1655 most /usr/share/doc/${1}/changelog.gz
1657 if check_com -c aptitude ; then
1658 echo "No changelog for package $1 found, using aptitude to retrieve it."
1660 aptitude -t unstable changelog ${1}
1662 aptitude changelog ${1}
1665 echo "No changelog for package $1 found, sorry."
1670 _dchange() { _files -W /usr/share/doc -/ }
1671 compdef _dchange dchange
1673 #f1# View Debian's NEWS of a given package
1675 if [[ -r /usr/share/doc/${1}/NEWS.Debian.gz ]] ; then
1676 most /usr/share/doc/${1}/NEWS.Debian.gz
1678 if [[ -r /usr/share/doc/${1}/NEWS.gz ]] ; then
1679 most /usr/share/doc/${1}/NEWS.gz
1681 echo "No NEWS file for package $1 found, sorry."
1686 _dnews() { _files -W /usr/share/doc -/ }
1687 compdef _dnews dnews
1689 #f1# View upstream's changelog of a given package
1691 if [[ -r /usr/share/doc/${1}/changelog.gz ]] ; then
1692 most /usr/share/doc/${1}/changelog.gz
1694 echo "No changelog for package $1 found, sorry."
1698 _uchange() { _files -W /usr/share/doc -/ }
1699 compdef _uchange uchange
1704 ZSH_PROFILE_RC=1 $SHELL "$@"
1707 #f1# Edit an alias via zle
1709 [[ -z "$1" ]] && { echo "Usage: edalias <alias_to_edit>" ; return 1 } || vared aliases'[$1]' ;
1711 compdef _aliases edalias
1713 #f1# Edit a function via zle
1715 [[ -z "$1" ]] && { echo "Usage: edfun <function_to_edit>" ; return 1 } || zed -f "$1" ;
1717 compdef _functions edfunc
1719 # use it e.g. via 'Restart apache2'
1720 #m# f6 Start() \kbd{/etc/init.d/\em{process}}\quad\kbd{start}
1721 #m# f6 Restart() \kbd{/etc/init.d/\em{process}}\quad\kbd{restart}
1722 #m# f6 Stop() \kbd{/etc/init.d/\em{process}}\quad\kbd{stop}
1723 #m# f6 Reload() \kbd{/etc/init.d/\em{process}}\quad\kbd{reload}
1724 #m# f6 Force-Reload() \kbd{/etc/init.d/\em{process}}\quad\kbd{force-reload}
1725 if [[ -d /etc/init.d ]] ; then
1726 for i in Start Restart Stop Force-Reload Reload ; do
1727 eval "$i() { $SUDO /etc/init.d/\$1 ${i:l} \$2 ; }"
1731 #f1# Provides useful information on globbing
1738 p named pipes (FIFOs)
1739 * executable plain files (0100)
1740 % device files (character or block special)
1741 %b block special files
1742 %c character special files
1743 r owner-readable files (0400)
1744 w owner-writable files (0200)
1745 x owner-executable files (0100)
1746 A group-readable files (0040)
1747 I group-writable files (0020)
1748 E group-executable files (0010)
1749 R world-readable files (0004)
1750 W world-writable files (0002)
1751 X world-executable files (0001)
1752 s setuid files (04000)
1753 S setgid files (02000)
1754 t files with the sticky bit (01000)
1756 print *(m-1) # Files modified up to a day ago
1757 print *(a1) # Files accessed a day ago
1758 print *(@) # Just symlinks
1759 print *(Lk+50) # Files bigger than 50 kilobytes
1760 print *(Lk-50) # Files smaller than 50 kilobytes
1761 print **/*.c # All *.c files recursively starting in \$PWD
1762 print **/*.c~file.c # Same as above, but excluding 'file.c'
1763 print (foo|bar).* # Files starting with 'foo' or 'bar'
1764 print *~*.* # All Files that do not contain a dot
1765 chmod 644 *(.^x) # make all plain non-executable files publically readable
1766 print -l *(.c|.h) # Lists *.c and *.h
1767 print **/*(g:users:) # Recursively match all files that are owned by group 'users'
1768 echo /proc/*/cwd(:h:t:s/self//) # Analogous to >ps ax | awk '{print $1}'<"
1770 alias help-zshglob=H-Glob
1772 check_com -c qma && alias ?='qma zshall'
1774 # grep for running process, like: 'any vim'
1776 if [[ -z "$1" ]] ; then
1777 echo "any - grep for process(es) by keyword" >&2
1778 echo "Usage: any <keyword>" >&2 ; return 1
1781 local LENGTH=$(expr length $STRING)
1782 local FIRSCHAR=$(echo $(expr substr $STRING 1 1))
1783 local REST=$(echo $(expr substr $STRING 2 $LENGTH))
1784 ps xauwww| grep "[$FIRSCHAR]$REST"
1788 # After resuming from suspend, system is paging heavily, leading to very bad interactivity.
1789 # taken from $LINUX-KERNELSOURCE/Documentation/power/swsusp.txt
1790 [[ -r /proc/1/maps ]] && \
1792 print 'Reading /proc/[0-9]*/maps and sending output to /dev/null, this might take a while.'
1793 cat $(sed -ne 's:.* /:/:p' /proc/[0-9]*/maps | sort -u | grep -v '^/dev/') > /dev/null
1794 print 'Finished, running "swapoff -a; swapon -a" may also be useful.'
1797 # print hex value of a number
1799 [[ -n "$1" ]] && printf "%x\n" $1 || { print 'Usage: hex <number-to-convert>' ; return 1 }
1802 # calculate (or eval at all ;-)) with perl => p[erl-]eval
1803 # hint: also take a look at zcalc -> 'autoload zcalc' -> 'man zshmodules | less -p MATHFUNC'
1805 [[ -n "$1" ]] && CALC="$*" || print "Usage: calc [expression]"
1806 perl -e "print eval($CALC),\"\n\";"
1808 functions peval &>/dev/null && alias calc=peval
1810 # brltty seems to have problems with utf8 environment and/or font Uni3-Terminus16 under
1811 # certain circumstances, so work around it, no matter which environment we have
1813 if [[ -z "$DISPLAY" ]] ; then
1814 consolechars -f /usr/share/consolefonts/default8x16.psf.gz
1821 # just press 'asdf' keys to toggle between dvorak and us keyboard layout
1823 echo -n 'Switching to us keyboard layout: '
1824 [[ -z "$DISPLAY" ]] && $SUDO loadkeys us &>/dev/null || setxkbmap us &>/dev/null
1828 echo -n 'Switching to dvorak keyboard layout: '
1829 [[ -z "$DISPLAY" ]] && $SUDO loadkeys dvorak &>/dev/null || setxkbmap dvorak &>/dev/null
1832 # just press 'asdf' key to toggle from neon layout to us keyboard layout
1834 echo -n 'Switching to us keyboard layout: '
1835 setxkbmap us && echo 'Done' || echo 'Failed'
1838 # set up an ipv6 tunnel
1842 if ifconfig sit1 2>/dev/null | grep -q 'inet6 addr: 2002:.*:1::1' ; then
1843 print 'ipv6 tunnel already set up, nothing to be done.'
1844 print 'execute: "ifconfig sit1 down ; ifconfig sit0 down" to remove ipv6-tunnel.' ; return 1
1846 [[ -n "$PUBLIC_IP" ]] || \
1847 local PUBLIC_IP=$(ifconfig $(route -n | awk '/^0\.0\.0\.0/{print $8; exit}') | \
1848 awk '/inet addr:/ {print $2}' | tr -d 'addr:')
1850 [[ -n "$PUBLIC_IP" ]] || { print 'No $PUBLIC_IP set and could not determine default one.' ; return 1 }
1851 local IPV6ADDR=$(printf "2002:%02x%02x:%02x%02x:1::1" $(print ${PUBLIC_IP//./ }))
1852 print -n "Setting up ipv6 tunnel $IPV6ADDR via ${PUBLIC_IP}: "
1853 ifconfig sit0 tunnel ::192.88.99.1 up
1854 ifconfig sit1 add "$IPV6ADDR" && print done || print failed
1858 if ifconfig sit1 2>/dev/null | grep -q 'inet6 addr: 2002:.*:1::1' ; then
1859 print 'ipv6 tunnel available' ; return 0
1861 print 'ipv6 tunnel not available' ; return 1
1865 if ifconfig sit1 2>/dev/null | grep -q 'inet6 addr: 2002:.*:1::1' ; then
1866 print -n 'Stopping ipv6 tunnel (sit0 + sit1): '
1867 ifconfig sit1 down ; ifconfig sit0 down && print done || print failed
1869 print 'No ipv6 tunnel found, nothing to be done.' ; return 1
1873 print "Usage: ipv6-tunnel [start|stop|status]">&2 ; return 1
1878 # run dhclient for wireless device
1880 salias dhclient "$(wavemon -d | awk '/device/{print $2}')"
1883 # spawn a minimally set up ksh - useful if you want to umount /usr/.
1885 exec env -i ENV="/etc/minimal-shellrc" HOME="$HOME" TERM="$TERM" ksh
1888 # make a backup of a file
1890 cp -a "$1" "${1}_$(date --iso-8601=seconds)"
1893 # Switching shell safely and efficiently? http://www.zsh.org/mla/workers/2001/msg02410.html
1895 # NO_SWITCH="yes" command bash "$@"
1898 # exec $SHELL $SHELL_ARGS "$@"
1903 # log out? set timeout in seconds {{{
1905 # do not log out in some specific terminals:
1906 # if [[ "${TERM}" == ([Exa]term*|rxvt|dtterm|screen*) ]] ; then
1911 # {{{ make sure our environment is clean regarding colors
1912 for color in BLUE RED GREEN CYAN WHITE ; unset $color
1915 # source another config file if present {{{
1916 xsource "/etc/zsh/zshrc.local"
1919 # "persistent history" {{{
1920 # just write important commands you always need to ~/.important_commands
1921 if [[ -r ~/.important_commands ]] ; then
1922 fc -R ~/.important_commands
1926 ## genrefcard.pl settings {{{
1927 ### example: split functions-search 8,16,24,32
1928 #@# split functions-search 8
1931 # add variable to be able to check whether the file has been read {{{
1932 ZSHRC_GLOBAL_HAS_BEEN_READ=1
1935 ## END OF FILE #################################################################
1936 # vim:filetype=zsh foldmethod=marker autoindent expandtab shiftwidth=4