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)
251 [[ $ZSH_VERSION == <4->* ]] && return 0
256 [[ $ZSH_VERSION == 4.<1->* || $ZSH_VERSION == <5->* ]] && return 0
261 [[ $ZSH_VERSION == 4.<2->* || $ZSH_VERSION == <5->* ]] && return 0
266 [[ $ZSH_VERSION == 4.<3->* || $ZSH_VERSION == <5->* ]] && return 0
270 #f1# Checks whether or not you're running grml
272 [[ -f /etc/grml_version ]] && return 0
276 #f1# Checks whether or not you're running a grml cd
278 [[ -f /etc/grml_cd ]] && return 0
283 #f1# Checks whether or not you're running grml-small
285 [[ ${${${(f)"$(</etc/grml_version)"}%% *}##*-} == 'small' ]] && return 0 ; return 1
288 isgrmlsmall() { return 1 }
291 #f1# are we running within an utf environment?
293 case "$LANG $CHARSET $LANGUAGE" in
300 # check for user, if not running as root set $SUDO to sudo
301 (( EUID != 0 )) && SUDO='sudo' || SUDO=''
303 # change directory to home on first invocation of zsh
304 # important for rungetty -> autologin
305 # Thanks go to Bart Schaefer!
306 isgrml && checkhome() {
307 if [[ -z "$ALREADY_DID_CD_HOME" ]] ; then
308 export ALREADY_DID_CD_HOME=$HOME
314 # {{{ set some variables
315 if check_com -c vim ; then
317 export EDITOR=${EDITOR:-vim}
319 export EDITOR=${EDITOR:-vi}
323 (( ${+PAGER} )) || export PAGER="less"
326 export MAIL=${MAIL:-/var/mail/$USER}
328 # if we don't set $SHELL then aterm, rxvt,.. will use /bin/sh or /bin/bash :-/
329 export SHELL='/bin/zsh'
331 # color setup for ls:
332 check_com -c dircolors && eval $(dircolors -b)
334 # set width of man pages to 80 for more convenient reading
335 # (( ${+MANWIDTH} )) || export MANWIDTH=80
337 # Search path for the cd command
340 # completion functions go to /etc/zsh/completion.d
341 # function files may be put into /etc/zsh/functions.d, from where they
342 # will be automatically autoloaded.
343 if [[ -n "$BROKEN_COMPLETION_DIR" ]] ; then
344 print 'Warning: not setting completion directories because broken files have been found.' >&2
346 [[ -d /etc/zsh/completion.d ]] && fpath=( $fpath /etc/zsh/completion.d )
347 if [[ -d /etc/zsh/functions.d ]] ; then
348 fpath+=( /etc/zsh/functions.d )
349 for func in /etc/zsh/functions.d/[^_]*[^~] ; do
350 autoload -U ${func:t}
355 # automatically remove duplicates from these arrays
356 typeset -U path cdpath fpath manpath
360 if [[ "$TERM" != emacs ]] ; then
361 [[ -z "$terminfo[kdch1]" ]] || bindkey -M emacs "$terminfo[kdch1]" delete-char
362 [[ -z "$terminfo[khome]" ]] || bindkey -M emacs "$terminfo[khome]" beginning-of-line
363 [[ -z "$terminfo[kend]" ]] || bindkey -M emacs "$terminfo[kend]" end-of-line
364 [[ -z "$terminfo[kdch1]" ]] || bindkey -M vicmd "$terminfo[kdch1]" vi-delete-char
365 [[ -z "$terminfo[khome]" ]] || bindkey -M vicmd "$terminfo[khome]" vi-beginning-of-line
366 [[ -z "$terminfo[kend]" ]] || bindkey -M vicmd "$terminfo[kend]" vi-end-of-line
367 [[ -z "$terminfo[cuu1]" ]] || bindkey -M viins "$terminfo[cuu1]" vi-up-line-or-history
368 [[ -z "$terminfo[cuf1]" ]] || bindkey -M viins "$terminfo[cuf1]" vi-forward-char
369 [[ -z "$terminfo[kcuu1]" ]] || bindkey -M viins "$terminfo[kcuu1]" vi-up-line-or-history
370 [[ -z "$terminfo[kcud1]" ]] || bindkey -M viins "$terminfo[kcud1]" vi-down-line-or-history
371 [[ -z "$terminfo[kcuf1]" ]] || bindkey -M viins "$terminfo[kcuf1]" vi-forward-char
372 [[ -z "$terminfo[kcub1]" ]] || bindkey -M viins "$terminfo[kcub1]" vi-backward-char
374 [[ "$terminfo[kcuu1]" == $'\eO'* ]] && bindkey -M viins "${terminfo[kcuu1]/O/[}" vi-up-line-or-history
375 [[ "$terminfo[kcud1]" == $'\eO'* ]] && bindkey -M viins "${terminfo[kcud1]/O/[}" vi-down-line-or-history
376 [[ "$terminfo[kcuf1]" == $'\eO'* ]] && bindkey -M viins "${terminfo[kcuf1]/O/[}" vi-forward-char
377 [[ "$terminfo[kcub1]" == $'\eO'* ]] && bindkey -M viins "${terminfo[kcub1]/O/[}" vi-backward-char
378 [[ "$terminfo[khome]" == $'\eO'* ]] && bindkey -M viins "${terminfo[khome]/O/[}" beginning-of-line
379 [[ "$terminfo[kend]" == $'\eO'* ]] && bindkey -M viins "${terminfo[kend]/O/[}" end-of-line
380 [[ "$terminfo[khome]" == $'\eO'* ]] && bindkey -M emacs "${terminfo[khome]/O/[}" beginning-of-line
381 [[ "$terminfo[kend]" == $'\eO'* ]] && bindkey -M emacs "${terminfo[kend]/O/[}" end-of-line
384 ## keybindings (run 'bindkeys' for details, more details via man zshzle)
385 # use emacs style per default:
390 #if [[ "$TERM" == screen ]] ; then
391 bindkey '\e[1~' beginning-of-line # home
392 bindkey '\e[4~' end-of-line # end
393 bindkey '\e[A' up-line-or-search # cursor up
394 bindkey '\e[B' down-line-or-search # <ESC>-
395 bindkey '^x' history-beginning-search-backward # alternative ways of searching the shell history
396 # bindkey -s '^L' "|less\n" # ctrl-L pipes to less
397 # bindkey -s '^B' " &\n" # ctrl-B runs it in the background
398 # if terminal type is set to 'rxvt':
399 bindkey '\e[7~' beginning-of-line # home
400 bindkey '\e[8~' end-of-line # end
403 # insert unicode character
404 # usage example: 'ctrl-x i' 00A7 'ctrl-x i' will give you an §
405 # See for example http://unicode.org/charts/ for unicode characters code
406 autoload insert-unicode-char
407 zle -N insert-unicode-char
408 #k# Insert Unicode character
409 bindkey '^Xi' insert-unicode-char
411 # just type 'cd ...' to get 'cd ../..'
412 # rationalise-dot() {
413 # if [[ $LBUFFER == *.. ]] ; then
419 # zle -N rationalise-dot
420 # bindkey . rationalise-dot
422 # bindkey '\eq' push-line-or-edit
425 # a generic accept-line wrapper {{{
427 # This widget can prevent unwanted autocorrections from command-name
428 # to _command-name, rehash automatically on enter and call any number
429 # of builtin and user-defined widgets in different contexts.
431 # For a broader description, see:
432 # <http://bewatermyfriend.org/posts/2007/12-26.11-50-38-tooltime.html>
434 # The code is imported from the file 'zsh/functions/accept-line' from
435 # <http://ft.bewatermyfriend.org/comp/zsh/zsh-dotfiles.tar.bz2>, which
436 # distributed under the same terms as zsh itself.
438 # A newly added command will may not be found or will cause false
439 # correction attempts, if you got auto-correction set. By setting the
440 # following style, we force accept-line() to rehash, if it cannot
441 # find the first word on the command line in the $command[] hash.
442 zstyle ':acceptline:*' rehash true
444 function Accept-Line() {
445 setopt localoptions noksharrays
450 zstyle -a ":acceptline:${alcontext}" actions subs
452 (( ${#subs} < 1 )) && return 0
455 for sub in ${subs} ; do
456 [[ ${sub} == 'accept-line' ]] && sub='.accept-line'
459 (( aldone > 0 )) && break
463 function Accept-Line-getdefault() {
466 zstyle -s ":acceptline:${alcontext}" default_action default_action
467 case ${default_action} in
469 printf ".accept-line"
472 printf ${default_action}
477 function accept-line() {
478 setopt localoptions noksharrays
481 local buf com fname format msg default_action
485 cmdline=(${(z)BUFFER})
489 zstyle -t ":acceptline:${alcontext}" rehash \
490 && [[ -z ${commands[$com]} ]] \
493 if [[ -n ${reswords[(r)$com]} ]] \
494 || [[ -n ${aliases[$com]} ]] \
495 || [[ -n ${functions[$com]} ]] \
496 || [[ -n ${builtins[$com]} ]] \
497 || [[ -n ${commands[$com]} ]] ; then
499 # there is something sensible to execute, just do it.
503 default_action=$(Accept-Line-getdefault)
504 zstyle -T ":acceptline:${alcontext}" call_default \
505 && zle ${default_action}
509 if [[ -o correct ]] \
510 || [[ -o correctall ]] \
511 && [[ -n ${functions[$fname]} ]] ; then
513 # nothing there to execute but there is a function called
514 # _command_name; a completion widget. Makes no sense to
515 # call it on the commandline, but the correct{,all} options
516 # will ask for it nevertheless, so warn the user.
517 if [[ ${LASTWIDGET} == 'accept-line' ]] ; then
518 # Okay, we warned the user before, he called us again,
519 # so have it his way.
523 default_action=$(Accept-Line-getdefault)
524 zstyle -T ":acceptline:${alcontext}" call_default \
525 && zle ${default_action}
529 # prepare warning message for the user, configurable via zstyle.
530 zstyle -s ":acceptline:${alcontext}" compwarnfmt msg
532 if [[ -z ${msg} ]] ; then
533 msg="%c will not execute and completion %f exists."
536 zformat -f msg "${msg}" "c:${com}" "f:${fname}"
540 elif [[ -n ${buf//[$' \t\n']##/} ]] ; then
541 # If we are here, the commandline contains something that is not
542 # executable, which is neither subject to _command_name correction
543 # and is not empty. might be a variable assignment
547 default_action=$(Accept-Line-getdefault)
548 zstyle -T ":acceptline:${alcontext}" call_default \
549 && zle ${default_action}
553 # If we got this far, the commandline only contains whitespace, or is empty.
557 default_action=$(Accept-Line-getdefault)
558 zstyle -T ":acceptline:${alcontext}" call_default \
559 && zle ${default_action}
567 # power completion - abbreviation expansion {{{
568 # power completion / abbreviation expansion / buffer expansion
569 # see http://zshwiki.org/home/examples/zleiab for details
570 # less risky than the global aliases but powerful as well
571 # just type the abbreviation key and afterwards ',.' to expand it
574 setopt interactivecomments
576 # key # value (#d additional doc string)
582 'G' '|& grep --color=auto'
584 'Hl' ' --help |& less -r' #d (Display help in pager)
588 'N' '&>/dev/null' #d (No Output)
589 'R' '| tr A-z N-za-m' #d (ROT13)
595 'hide' "echo -en '\033]50;nil2\007'"
596 'tiny' 'echo -en "\033]50;-misc-fixed-medium-r-normal-*-*-80-*-*-c-*-iso8859-15\007"'
597 'small' 'echo -en "\033]50;6x10\007"'
598 'medium' 'echo -en "\033]50;-misc-fixed-medium-r-normal--13-120-75-75-c-80-iso8859-15\007"'
599 'default' 'echo -e "\033]50;-misc-fixed-medium-r-normal-*-*-140-*-*-c-*-iso8859-15\007"'
600 'large' 'echo -en "\033]50;-misc-fixed-medium-r-normal-*-*-150-*-*-c-*-iso8859-15\007"'
601 'huge' 'echo -en "\033]50;-misc-fixed-medium-r-normal-*-*-210-*-*-c-*-iso8859-15\007"'
602 'smartfont' 'echo -en "\033]50;-artwiz-smoothansi-*-*-*-*-*-*-*-*-*-*-*-*\007"'
603 'semifont' 'echo -en "\033]50;-misc-fixed-medium-r-semicondensed-*-*-120-*-*-*-*-iso8859-15\007"'
607 'co' "./configure && make && sudo make install"
608 'CH' "./configure --help"
609 'conkeror' 'firefox -chrome chrome://conkeror/content'
611 'lad' $'ls -d .*(/)\n# only show dot-directories'
612 'lsa' $'ls -a .*(.)\n# only show dot-files'
613 'lss' $'ls -l *(s,S,t)\n# only files with setgid/setuid/sticky flag'
614 'lsl' $'ls -l *(@[1,10])\n# only symlinks'
615 'lsx' $'ls -l *(*[1,10])\n# only executables'
616 'lsw' $'ls -ld *(R,W,X.^ND/)\n# world-{readable,writable,executable} files'
617 'lsbig' $'ls -flh *(.OL[1,10])\n# display the biggest files'
618 'lsd' $'ls -d *(/)\n# only show directories'
619 'lse' $'ls -d *(/^F)\n# only show empty directories'
620 'lsnew' $'ls -rl *(D.om[1,10])\n# display the newest files'
621 'lsold' $'ls -rtlh *(D.om[-11,-1])\n # display the oldest files'
622 'lssmall' $'ls -Srl *(.oL[1,10])\n# display the smallest files'
624 '600' 'chmod u+rw-x,g-rwx,o-rwx'
626 '700' 'chmod u+rwx,g-rwx,o-rwx'
627 'r--' 'chmod u+r-wx,g-rwx,o-rwx'
628 '644' $'chmod u+rw-x,g+r-wx,o+r-wx\n # 4=r,2=w,1=x'
629 '755' 'chmod u+rwx,g+r-w+x,o+r-w+x'
631 'cmplayer' 'mplayer -vo -fs -zoom fbdev'
632 'fbmplayer' 'mplayer -vo -fs -zoom fbdev'
633 'fblinks' 'links2 -driver fb'
634 'insecssh' 'ssh -o "StrictHostKeyChecking=no" -o "UserKnownHostsFile=/dev/null"'
635 'insecscp' 'scp -o "StrictHostKeyChecking=no" -o "UserKnownHostsFile=/dev/null"'
636 'fori' 'for i ({..}) { }'
639 'se' 'setopt interactivecomments'
640 'va' 'valac --vapidir=../vapi/ --pkg=gtk+-2.0 gtktest.vala'
641 'fb2' '=mplayer -vo fbdev -fs -zoom 1>/dev/null -xy 2'
642 'fb3' '=mplayer -vo fbdev -fs -zoom 1>/dev/null -xy 3'
644 'D' 'export DISPLAY=:0.0'
645 'mp' 'mplayer -vo xv -fs -zoom'
650 matched_chars='[.-|_a-zA-Z0-9]#'
651 LBUFFER=${LBUFFER%%(#m)[.-|_a-zA-Z0-9]#}
652 LBUFFER+=${abk[$MATCH]:-$MATCH}
656 bindkey ",." globalias
660 autoload -U zmv # who needs mmv or rename?
661 autoload history-search-end
663 # we don't want to quote/espace URLs on our own...
664 # if autoload -U url-quote-magic ; then
665 # zle -N self-insert url-quote-magic
666 # zstyle ':url-quote-magic:*' url-metas '*?[]^()~#{}='
668 # print 'Notice: no url-quote-magic available :('
670 alias url-quote='autoload -U url-quote-magic ; zle -N self-insert url-quote-magic'
672 #m# k ESC-h Call \kbd{run-help} for the 1st word on the command line
673 alias run-help >&/dev/null && unalias run-help
674 autoload run-help # use via 'esc-h'
677 if autoload -U compinit && compinit 2>/dev/null ; then
678 compinit 2>/dev/null || print 'Notice: no compinit available :('
680 print 'Notice: no compinit available :('
685 is4 && autoload -U zed # use ZLE editor to edit a file or function
688 for mod in complist deltochar mathfunc ; do
689 zmodload -i zsh/${mod} 2>/dev/null || print "Notice: no ${mod} available :("
692 # autoload zsh modules when they are referenced
701 while (( ${#tmpargs} > 0 )) ; do
702 zmodload -${tmpargs[1]} zsh/${tmpargs[2]} ${tmpargs[2]}
708 if is4 && autoload -U insert-files && zle -N insert-files ; then
710 bindkey "^Xf" insert-files # C-x-f
713 bindkey ' ' magic-space # also do history expansion on space
714 #k# Trigger menu-complete
715 bindkey '\ei' menu-complete # menu completion via esc-i
717 # press esc-e for editing command line in $EDITOR or $VISUAL
718 if is4 && autoload -U edit-command-line && zle -N edit-command-line ; then
719 #k# Edit the current line in \kbd{\$EDITOR}
720 bindkey '\ee' edit-command-line
723 if is4 && [[ -n ${(k)modules[zsh/complist]} ]] ; then
724 #k# menu selection: pick item but stay in the menu
725 bindkey -M menuselect '\e^M' accept-and-menu-complete
727 # use the vi navigation keys (hjkl) besides cursor keys in menu completion
728 #bindkey -M menuselect 'h' vi-backward-char # left
729 #bindkey -M menuselect 'k' vi-up-line-or-history # up
730 #bindkey -M menuselect 'l' vi-forward-char # right
731 #bindkey -M menuselect 'j' vi-down-line-or-history # bottom
733 # accept a completion and try to complete again by using menu
734 # completion; very useful with completing directories
735 # by using 'undo' one's got a simple file browser
736 bindkey -M menuselect '^o' accept-and-infer-next-history
739 # press "ctrl-e d" to insert the actual date in the form yyyy-mm-dd
740 _bkdate() { BUFFER="$BUFFER$(date '+%F')"; CURSOR=$#BUFFER; }
743 #k# Insert a timestamp on the command line (yyyy-mm-dd)
744 bindkey '^Ed' _bkdate
746 # press esc-m for inserting last typed word again (thanks to caphuso!)
747 insert-last-typed-word() { zle insert-last-word -- 0 -1 };
748 zle -N insert-last-typed-word;
750 #k# Insert last typed word
751 bindkey "\em" insert-last-typed-word
753 # set command prediction from history, see 'man 1 zshcontrib'
754 # is4 && autoload -U predict-on && \
755 # zle -N predict-on && \
756 # zle -N predict-off && \
757 # bindkey "^X^Z" predict-on && \
758 # bindkey "^Z" predict-off
760 #k# Shortcut for \kbd{fg<enter>}
761 bindkey -s '^z' "fg\n"
763 # press ctrl-q to quote line:
765 # zle beginning-of-line
767 # # RBUFFER="'$RBUFFER'"
768 # RBUFFER=${(q)RBUFFER}
771 # zle -N mquote && bindkey '^q' mquote
773 # run command line as user root via sudo:
774 sudo-command-line() {
775 [[ -z $BUFFER ]] && zle up-history
776 [[ $BUFFER != sudo\ * ]] && BUFFER="sudo $BUFFER"
778 zle -N sudo-command-line
780 #k# Put the current command line into a \kbd{sudo} call
781 bindkey "^Os" sudo-command-line
783 ### jump behind the first word on the cmdline.
784 ### useful to add options.
785 function jump_after_first_word() {
789 if (( ${#words} <= 1 )) ; then
792 CURSOR=${#${words[1]}}
795 zle -N jump_after_first_word
797 bindkey '^x1' jump_after_first_word
801 # {{{ set some important options
802 # Please update these tags, if you change the umask settings below.
804 #o# r_umaskstr rwxrwxr-x
806 #o# umaskstr rwxr-xr-x
807 (( EUID != 0 )) && umask 002 || umask 022
810 setopt append_history # append history list to the history file (important for multiple parallel zsh sessions!)
811 is4 && setopt SHARE_HISTORY # import new commands from the history file also in other zsh-session
812 setopt extended_history # save each command's beginning timestamp and the duration to the history file
813 is4 && setopt histignorealldups # If a new command line being added to the history
814 # list duplicates an older one, the older command is removed from the list
815 setopt histignorespace # remove command lines from the history list when
816 # the first character on the line is a space
817 # setopt histallowclobber # add `|' to output redirections in the history
818 # setopt NO_clobber # warning if file exists ('cat /dev/null > ~/.zshrc')
819 setopt auto_cd # if a command is issued that can't be executed as a normal command,
820 # and the command is the name of a directory, perform the cd command to that directory
821 setopt extended_glob # in order to use #, ~ and ^ for filename generation
822 # grep word *~(*.gz|*.bz|*.bz2|*.zip|*.Z) ->
823 # -> searches for word not in compressed files
824 # don't forget to quote '^', '~' and '#'!
825 setopt notify # report the status of backgrounds jobs immediately
826 setopt hash_list_all # Whenever a command completion is attempted, make sure \
827 # the entire command path is hashed first.
828 setopt completeinword # not just at the end
829 # setopt nocheckjobs # don't warn me about bg processes when exiting
830 setopt nohup # and don't kill them, either
831 # setopt printexitvalue # alert me if something failed
832 # setopt dvorak # with spelling correction, assume dvorak kb
833 setopt auto_pushd # make cd push the old directory onto the directory stack.
834 setopt nonomatch # try to avoid the 'zsh: no matches found...'
835 setopt nobeep # avoid "beep"ing
836 setopt pushd_ignore_dups # don't push the same dir twice.
838 MAILCHECK=30 # mailchecks
839 REPORTTIME=5 # report about cpu-/system-/user-time of command if running longer than 5 seconds
840 watch=(notme root) # watch for everyone but me and root
842 # define word separators (for stuff like backward-word, forward-word, backward-kill-word,..)
843 # WORDCHARS='*?_-.[]~=/&;!#$%^(){}<>' # the default
845 # WORDCHARS='*?_[]~=&;!#$%^(){}'
846 # WORDCHARS='${WORDCHARS:s@/@}'
848 # only slash should be considered as a word separator:
849 slash-backward-kill-word() {
850 local WORDCHARS="${WORDCHARS:s@/@}"
852 zle backward-kill-word
854 zle -N slash-backward-kill-word
856 #k# Kill everything in a word up to its last \kbd{/}
857 bindkey '\ev' slash-backward-kill-word
866 HISTFILE=$HOME/.zsh_history
867 isgrmlcd && HISTSIZE=500 || HISTSIZE=5000
868 isgrmlcd && SAVEHIST=1000 || SAVEHIST=10000 # useful for setopt append_history
872 # dirstack handling {{{
875 if [[ -f ~/.zdirs ]] && [[ ${#dirstack[*]} -eq 0 ]] ; then
876 dirstack=( ${(f)"$(< ~/.zdirs)"} )
877 # "cd -" won't work after login by just setting $OLDPWD, so
878 [[ -d $dirstack[0] ]] && cd $dirstack[0] && cd $OLDPWD
882 builtin print -l ${(u)dirstack} >! ~/.zdirs
887 # {{{ display battery status on right side of prompt via running 'BATTERY=1 zsh'
888 if [[ -n "$BATTERY" ]] ; then
889 if check_com -c acpi ; then
890 PERCENT="${(C)${(s| |)$(acpi 2>/dev/null)}[4]}"
891 [[ -z "$PERCENT" ]] && PERCENT='acpi not present'
893 if [[ "${PERCENT%%%}" -lt 20 ]] ; then
894 PERCENT="warning: ${PERCENT}%"
900 # display version control information on right side of prompt if $VCS is set {{{
901 # based on Mike Hommey's http://web.glandium.org/blog/?p=170
903 local vcs base_dir sub_dir ref
907 sub_dir=$(readlink -f "${PWD}")
908 sub_dir=${sub_dir#$1}
913 base_dir=$(git-rev-parse --show-cdup 2>/dev/null) || return 1
914 base_dir=$(readlink -f "$base_dir/..")
915 sub_dir=$(git-rev-parse --show-prefix)
917 ref=$(git-symbolic-ref -q HEAD || git-name-rev --name-only HEAD 2>/dev/null)
918 ref=${ref#refs/heads/}
923 [[ -d ".svn" ]] || return 1
925 while [[ -d "$base_dir/../.svn" ]]; do base_dir="$base_dir/.."; done
926 base_dir=$(readlink -f "$base_dir")
927 sub_dir=$(sub_dir "${base_dir}")
928 ref=$(svn info "$base_dir" | awk '/^URL/ { sub(".*/","",$0); r=$0 } /^Revision/ { sub("[^0-9]*","",$0); print r":"$0 }')
933 [[ -f ~/.svk/config ]] || return 1
934 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
937 base_dir=${base_dir%%
939 sub_dir=$(sub_dir "${base_dir}")
945 while [[ ! -d "$base_dir/.hg" ]]; do
946 base_dir="$base_dir/.."
947 [[ $(readlink -f "${base_dir}") = "/" ]] && return 1
949 base_dir=$(readlink -f "$base_dir")
950 sub_dir=$(sub_dir "${base_dir}")
951 ref=$(< "${base_dir}/.hg/branch")
960 # echo "${vcs:+($vcs)}${base_dir/$HOME/~}${vcs:+[$ref]${sub_dir}}"
961 echo "${vcs:+($vcs)}${base_dir}${vcs:+[$ref]${sub_dir}}"
966 if autoload promptinit && promptinit 2>/dev/null ; then
967 promptinit # people should be able to use their favourite prompt
969 print 'Notice: no promptinit available :('
973 # precmd() => a function which is executed just before each prompt
974 # use 'NOPRECMD=1' to disable the precmd + preexec commands
976 # precmd () { setopt promptsubst; [[ -o interactive ]] && jobs -l;
978 # make sure to use right prompt only when not running a command
979 is41 && setopt transient_rprompt
981 is4 && [[ -z $NOPRECMD ]] && precmd () {
982 [[ -n $NOPRECMD ]] && return 0
983 # allow manual overwriting of RPROMPT
984 if [[ -n $RPROMPT ]] ; then
985 [[ $TERM == screen* ]] && echo -n $'\ekzsh\e\\'
988 # just use DONTSETRPROMPT=1 to be able to overwrite RPROMPT
989 if [[ -z $DONTSETRPROMPT ]] ; then
990 if [[ -n $BATTERY ]] ; then
991 RPROMPT="%(?..:()% ${PERCENT}${SCREENTITLE}"
992 # RPROMPT="${PERCENT}${SCREENTITLE}"
993 elif [[ -n $VCS ]] ; then
994 RPROMPT="%(?..:()% $(__vcs_dir)${SCREENTITLE}"
996 RPROMPT="%(?..:()% ${SCREENTITLE}"
997 # RPROMPT="${SCREENTITLE}"
1000 # adjust title of xterm
1001 # see http://www.faqs.org/docs/Linux-mini/Xterm-Title.html
1004 print -Pn "\e]0;%n@%m: %~\a"
1009 # chpwd () => a function which is executed whenever the directory is changed
1011 # preexec() => a function running before every command
1012 is4 && [[ -z $NOPRECMD ]] && \
1014 [[ -n $NOPRECMD ]] && return 0
1015 # set hostname if not running on host with name 'grml'
1016 if [[ -n "$HOSTNAME" ]] && [[ "$HOSTNAME" != $(hostname) ]] ; then
1019 # get the name of the program currently running and hostname of local machine
1020 # set screen window title if running in a screen
1021 if [[ "$TERM" == screen* ]] ; then
1022 # local CMD=${1[(wr)^(*=*|sudo|ssh|-*)]} # don't use hostname
1023 local CMD="${1[(wr)^(*=*|sudo|ssh|-*)]}$NAME" # use hostname
1024 echo -ne "\ek$CMD\e\\"
1026 # set the screen title to "zsh" when sitting at the command prompt:
1027 if [[ "$TERM" == screen* ]] ; then
1028 SCREENTITLE=$'%{\ekzsh\e\\%}'
1032 # adjust title of xterm
1035 print -Pn "\e]0;%n@%m: $1\a"
1041 if autoload colors && colors 2>/dev/null ; then
1042 BLUE="%{${fg[blue]}%}"
1043 RED="%{${fg_bold[red]}%}"
1044 GREEN="%{${fg[green]}%}"
1045 CYAN="%{${fg[cyan]}%}"
1046 WHITE="%{${fg[white]}%}"
1047 NO_COLOUR="%{${reset_color}%}"
1049 BLUE=$'%{\e[1;34m%}'
1051 GREEN=$'%{\e[1;32m%}'
1052 CYAN=$'%{\e[1;36m%}'
1053 WHITE=$'%{\e[1;37m%}'
1054 NO_COLOUR=$'%{\e[0m%}'
1057 EXITCODE="%(?..%?%1v )"
1058 PS2='`%_> ' # secondary prompt, printed when the shell needs more information to complete a command.
1059 PS3='?# ' # selection prompt used within a select loop.
1060 PS4='+%N:%i:%_> ' # the execution trace prompt (setopt xtrace). default: '+%N:%i>'
1062 # set variable debian_chroot if running in a chroot with /etc/debian_chroot
1063 if [[ -z "$debian_chroot" ]] && [[ -r /etc/debian_chroot ]] ; then
1064 debian_chroot=$(cat /etc/debian_chroot)
1067 # don't use colors on dumb terminals (like emacs):
1068 if [[ "$TERM" == dumb ]] ; then
1069 PROMPT="${EXITCODE}${debian_chroot:+($debian_chroot)}%n@%m %40<...<%B%~%b%<< %# "
1071 # only if $GRMLPROMPT is set (e.g. via 'GRMLPROMPT=1 zsh') use the extended prompt
1072 # set variable identifying the chroot you work in (used in the prompt below)
1073 if [[ -n $GRMLPROMPT ]] ; then
1074 PROMPT="${RED}${EXITCODE}${CYAN}[%j running job(s)] ${GREEN}{history#%!} ${RED}%(3L.+.) ${BLUE}%* %D
1075 ${BLUE}%n${NO_COLOUR}@%m %40<...<%B%~%b%<< %# "
1077 if (( EUID != 0 )); then
1078 PROMPT="${RED}${EXITCODE}${WHITE}${debian_chroot:+($debian_chroot)}${BLUE}%n${NO_COLOUR}@%m %40<...<%B%~%b%<< %# " # primary prompt string
1080 PROMPT="${BLUE}${EXITCODE}${WHITE}${debian_chroot:+($debian_chroot)}${RED}%n${NO_COLOUR}@%m %40<...<%B%~%b%<< %# " # primary prompt string
1085 # if we are inside a grml-chroot set a specific prompt theme
1086 if [[ -n "$GRML_CHROOT" ]] ; then
1087 PROMPT="%{$fg[red]%}(CHROOT) %{$fg_bold[red]%}%n%{$fg_no_bold[white]%}@%m %40<...<%B%~%b%<< %\# "
1091 # {{{ 'hash' some often used directories
1093 hash -d deb=/var/cache/apt/archives
1094 hash -d doc=/usr/share/doc
1095 hash -d linux=/lib/modules/$(command uname -r)/build/
1096 hash -d log=/var/log
1097 hash -d slog=/var/log/syslog
1098 hash -d src=/usr/src
1099 hash -d templ=/usr/share/doc/grml-templates
1100 hash -d tt=/usr/share/doc/texttools-doc
1101 hash -d www=/var/www
1106 if [[ $UID -eq 0 ]] ; then
1107 [[ -r /etc/grml/screenrc ]] && alias screen='/usr/bin/screen -c /etc/grml/screenrc'
1108 elif [[ -r $HOME/.screenrc ]] ; then
1109 alias screen="/usr/bin/screen -c $HOME/.screenrc"
1111 [[ -r /etc/grml/screenrc_grml ]] && alias screen='/usr/bin/screen -c /etc/grml/screenrc_grml'
1114 # do we have GNU ls with color-support?
1115 if ls --help 2>/dev/null | grep -- --color= >/dev/null && [[ "$TERM" != dumb ]] ; then
1116 #a1# execute \kbd{@a@}:\quad ls with colors
1117 alias ls='ls -b -CF --color=auto'
1118 #a1# execute \kbd{@a@}:\quad list all files, with colors
1119 alias la='ls -la --color=auto'
1120 #a1# long colored list, without dotfiles (@a@)
1121 alias ll='ls -l --color=auto'
1122 #a1# long colored list, human readable sizes (@a@)
1123 alias lh='ls -hAl --color=auto'
1124 #a1# List files, append qualifier to filenames \\&\quad(\kbd{/} for directories, \kbd{@} for symlinks ...)
1125 alias l='ls -lF --color=auto'
1127 alias ls='ls -b -CF'
1134 alias mdstat='cat /proc/mdstat'
1135 alias ...='cd ../../'
1137 # generate alias named "$KERNELVERSION-reboot" so you can use boot with kexec:
1138 if [[ -x /sbin/kexec ]] && [[ -r /proc/cmdline ]] ; then
1139 alias "$(uname -r)-reboot"="kexec -l --initrd=/boot/initrd.img-"$(uname -r)" --command-line=\"$(cat /proc/cmdline)\" /boot/vmlinuz-"$(uname -r)""
1142 alias cp='nocorrect cp' # no spelling correction on cp
1143 alias mkdir='nocorrect mkdir' # no spelling correction on mkdir
1144 alias mv='nocorrect mv' # no spelling correction on mv
1145 alias rm='nocorrect rm' # no spelling correction on rm
1147 #a1# Execute \kbd{rmdir}
1149 #a1# Execute \kbd{rmdir}
1152 # see http://www.cl.cam.ac.uk/~mgk25/unicode.html#term for details
1153 alias term2iso="echo 'Setting terminal to iso mode' ; print -n '\e%@'"
1154 alias term2utf="echo 'Setting terminal to utf-8 mode'; print -n '\e%G'"
1156 # make sure it is not assigned yet
1157 [[ $(whence -w utf2iso &>/dev/null) == 'utf2iso: alias' ]] && unalias utf2iso
1161 for ENV in $(env | command grep -i '.utf') ; do
1162 eval export "$(echo $ENV | sed 's/UTF-8/iso885915/ ; s/utf8/iso885915/')"
1167 # make sure it is not assigned yet
1168 [[ $(whence -w iso2utf &>/dev/null) == 'iso2utf: alias' ]] && unalias iso2utf
1170 if ! isutfenv ; then
1171 for ENV in $(env | command grep -i '\.iso') ; do
1172 eval export "$(echo $ENV | sed 's/iso.*/UTF-8/ ; s/ISO.*/UTF-8/')"
1177 # set up software synthesizer via speakup
1179 aumix -w 90 -v 90 -p 90 -m 90
1180 if ! [[ -r /dev/softsynth ]] ; then
1181 flite -o play -t "Sorry, software synthesizer not available. Did you boot with swspeak bootoption?"
1184 setopt singlelinezle
1187 nice -n -20 speechd-up
1189 flite -o play -t "Finished setting up software synthesizer"
1193 # I like clean prompt, so provide simple way to get that
1194 check_com 0 || alias 0='return 0'
1196 # for really lazy people like mika:
1197 check_com S &>/dev/null || alias S='screen'
1198 check_com s &>/dev/null || alias s='ssh'
1200 # get top 10 shell commands:
1201 alias top10='print -l ? ${(o)history%% *} | uniq -c | sort -nr | head -n 10'
1203 # truecrypt; use e.g. via 'truec /dev/ice /mnt/ice' or 'truec -i'
1204 if check_com -c truecrypt ; then
1206 alias truec='truecrypt --mount-options "rw,sync,dirsync,users,uid=1000,gid=users,umask=077,utf8" '
1208 alias truec='truecrypt --mount-options "rw,sync,dirsync,users,uid=1000,gid=users,umask=077" '
1212 #f1# Hints for the use of zsh on grml
1214 print "$bg[white]$fg[black]
1215 zsh-help - hints for use of zsh on grml
1216 =======================================$reset_color"
1219 Main configuration of zsh happens in /etc/zsh/zshrc (global)
1220 and /etc/skel/.zshrc which is copied to $HOME/.zshrc once.
1221 The files are part of the package grml-etc-core, if you want to
1222 use them on a non-grml-system just get the tar.gz from
1223 http://deb.grml.org/ or get the files from the mercurial
1226 http://hg.grml.org/grml-etc-core/raw-file/tip/etc/skel/.zshrc
1227 http://hg.grml.org/grml-etc-core/raw-file/tip/etc/zsh/zshrc
1229 If you want to stay in sync with zsh configuration of grml
1230 run '\''ln -sf /etc/skel/.zshrc $HOME/.zshrc'\'' and configure
1231 your own stuff in $HOME/.zshrc.local. System wide configuration
1232 without touching configuration files of grml can take place
1233 in /etc/zsh/zshrc.local.
1235 If you want to use the configuration of user grml also when
1236 running as user root just run '\''zshskel'\'' which will source
1237 the file /etc/skel/.zshrc.
1239 For information regarding zsh start at http://grml.org/zsh/
1241 Take a look at grml'\''s zsh refcard:
1242 % xpdf =(zcat /usr/share/doc/grml-docs/zsh/grml-zsh-refcard.pdf.gz)
1244 Check out the main zsh refcard:
1245 % '$BROWSER' http://www.bash2zsh.com/zsh_refcard/refcard.pdf
1247 And of course visit the zsh-lovers:
1250 You can adjust some options through environment variables when
1251 invoking zsh without having to edit configuration files.
1252 Basically meant for bash users who are not used to the power of
1255 "NOCOR=1 zsh" => deactivate automatic correction
1256 "NOMENU=1 zsh" => do not use menu completion (note: use strg-d for completion instead!)
1257 "NOPRECMD=1 zsh" => disable the precmd + preexec commands (set GNU screen title)
1258 "BATTERY=1 zsh" => activate battery status (via acpi) on right side of prompt'
1261 $bg[white]$fg[black]
1262 Please report wishes + bugs to the grml-team: http://grml.org/bugs/
1263 Enjoy your grml system with the zsh!$reset_color"
1267 if [[ -r /etc/debian_version ]] ; then
1268 #a3# Execute \kbd{apt-cache search}
1269 alias acs='apt-cache search'
1270 #a3# Execute \kbd{apt-cache show}
1271 alias acsh='apt-cache show'
1272 #a3# Execute \kbd{apt-cache policy}
1273 alias acp='apt-cache policy'
1274 #a3# Execute \kbd{apt-get dist-upgrade}
1275 salias adg="apt-get dist-upgrade"
1276 #a3# Execute \kbd{apt-get install}
1277 salias agi="apt-get install"
1278 #a3# Execute \kbd{aptitude install}
1279 salias ati="aptitude install"
1280 #a3# Execute \kbd{apt-get upgrade}
1281 salias ag="apt-get upgrade"
1282 #a3# Execute \kbd{apt-get update}
1283 salias au="apt-get update"
1284 #a3# Execute \kbd{aptitude update ; aptitude safe-upgrade}
1285 salias -a up="aptitude update ; aptitude safe-upgrade"
1286 #a3# Execute \kbd{dpkg-buildpackage}
1287 alias dbp='dpkg-buildpackage'
1288 #a3# Execute \kbd{grep-excuses}
1289 alias ge='grep-excuses'
1292 #f3# Execute \kbd{apt-get update \&\& }\\&\quad \kbd{apt-get dist-upgrade}
1294 if [[ -z "$1" ]] ; then
1295 $SUDO apt-get update
1296 $SUDO apt-get -u upgrade
1298 ssh $1 $SUDO apt-get update
1299 # ask before the upgrade
1301 ssh $1 $SUDO apt-get --no-act upgrade
1302 echo -n 'Process the upgrade?'
1304 if [[ $dummy == "y" ]] ; then
1305 ssh $1 $SUDO apt-get -u upgrade --yes
1310 isgrmlcd && alias su="sudo -s" # get a root shell
1311 #a1# Take a look at the syslog: \kbd{\$PAGER /var/log/syslog}
1312 alias llog="$PAGER /var/log/syslog" # take a look at the syslog
1313 #a1# Take a look at the syslog: \kbd{tail -f /var/log/syslog}
1314 alias tlog="tail -f /var/log/syslog" # follow the syslog
1315 #a1# (Re)-source \kbd{/etc/skel/.zshrc}
1316 alias zshskel="source /etc/skel/.zshrc" # source skeleton zshrc
1319 # sort installed Debian-packages by size
1320 if check_com -c grep-status ; then
1321 #a3# List installed Debian-packages sorted by size
1322 alias debs-by-size='grep-status -FStatus -sInstalled-Size,Package -n "install ok installed" | paste -sd " \n" | sort -rn'
1325 # if cdrecord is a symlink (to wodim) or isn't present at all warn:
1326 if [[ -L /usr/bin/cdrecord ]] || ! check_com -c cdrecord ; then
1327 if check_com -c wodim ; then
1328 alias cdrecord="echo 'cdrecord is not provided under its original name by Debian anymore.
1329 See #377109 in the BTS of Debian for more details.
1331 Please use the wodim binary instead' ; return 1"
1335 # get_tw_cli has been renamed into get_3ware
1336 if check_com -c get_3ware ; then
1338 echo 'Warning: get_tw_cli has been renamed into get_3ware. Invoking get_3ware for you.'>&2
1343 # I hate lacking backward compatibility, so provide an alternative therefore
1344 if ! check_com -c apache2-ssl-certificate ; then
1346 apache2-ssl-certificate() {
1348 print 'Debian does not ship apache2-ssl-certificate anymore (see #398520). :('
1349 print 'You might want to take a look at Debian the package ssl-cert as well.'
1350 print 'To generate a certificate for use with apache2 follow the instructions:'
1354 export RANDFILE=/dev/random
1355 mkdir /etc/apache2/ssl/
1356 openssl req $@ -new -x509 -days 365 -nodes -out /etc/apache2/ssl/apache.pem -keyout /etc/apache2/ssl/apache.pem
1357 chmod 600 /etc/apache2/ssl/apache.pem
1359 Run "grml-tips ssl-certificate" if you need further instructions.
1365 # {{{ Use hard limits, except for a smaller stack and no core dumps
1367 is4 && limit stack 8192
1368 isgrmlcd && limit core 0 # important for a live-cd-system
1372 # {{{ completion system
1374 # called later (via is4 && grmlcomp)
1375 # notice: use 'zstyle' for getting current settings
1376 # press ^Xh (control-x h) for getting tags in context; ^X? (control-x ?) to run complete_debug with trace output
1378 # TODO: This could use some additional information
1380 # allow one error for every three characters typed in approximate completer
1381 zstyle ':completion:*:approximate:' max-errors 'reply=( $((($#PREFIX+$#SUFFIX)/3 )) numeric )'
1383 # don't complete backup files as executables
1384 zstyle ':completion:*:complete:-command-::commands' ignored-patterns '(aptitude-*|*\~)'
1386 # start menu completion only if it could find no unambiguous initial string
1387 zstyle ':completion:*:correct:*' insert-unambiguous true
1388 zstyle ':completion:*:corrections' format $'%{\e[0;31m%}%d (errors: %e)%{\e[0m%}'
1389 zstyle ':completion:*:correct:*' original true
1391 # activate color-completion
1392 zstyle ':completion:*:default' list-colors ${(s.:.)LS_COLORS}
1394 # format on completion
1395 zstyle ':completion:*:descriptions' format $'%{\e[0;31m%}completing %B%d%b%{\e[0m%}'
1397 # complete 'cd -<tab>' with menu
1398 zstyle ':completion:*:*:cd:*:directory-stack' menu yes select
1400 # insert all expansions for expand completer
1401 zstyle ':completion:*:expand:*' tag-order all-expansions
1402 zstyle ':completion:*:history-words' list false
1405 zstyle ':completion:*:history-words' menu yes
1407 # ignore duplicate entries
1408 zstyle ':completion:*:history-words' remove-all-dups yes
1409 zstyle ':completion:*:history-words' stop yes
1411 # match uppercase from lowercase
1412 zstyle ':completion:*' matcher-list 'm:{a-z}={A-Z}'
1414 # separate matches into groups
1415 zstyle ':completion:*:matches' group 'yes'
1416 zstyle ':completion:*' group-name ''
1418 if [[ -z "$NOMENU" ]] ; then
1419 # if there are more than 5 options allow selecting from a menu
1420 zstyle ':completion:*' menu select=5
1422 # don't use any menus at all
1426 zstyle ':completion:*:messages' format '%d'
1427 zstyle ':completion:*:options' auto-description '%d'
1429 # describe options in full
1430 zstyle ':completion:*:options' description 'yes'
1432 # on processes completion complete all user processes
1433 zstyle ':completion:*:processes' command 'ps -au$USER'
1435 # offer indexes before parameters in subscripts
1436 zstyle ':completion:*:*:-subscript-:*' tag-order indexes parameters
1438 # provide verbose completion information
1439 zstyle ':completion:*' verbose true
1441 # recent (as of Dec 2007) zsh versions are able to provide descriptions
1442 # for commands (read: 1st word in the line) that it will list for the user
1443 # to choose from. The following disables that, because it's not exactly fast.
1444 zstyle ':completion:*:-command-:*:' verbose false
1446 # set format for warnings
1447 zstyle ':completion:*:warnings' format $'%{\e[0;31m%}No matches for:%{\e[0m%} %d'
1449 # define files to ignore for zcompile
1450 zstyle ':completion:*:*:zcompile:*' ignored-patterns '(*~|*.zwc)'
1451 zstyle ':completion:correct:' prompt 'correct to: %e'
1453 # Ignore completion functions for commands you don't have:
1454 zstyle ':completion::(^approximate*):*:functions' ignored-patterns '_*'
1456 # complete manual by their section
1457 zstyle ':completion:*:manuals' separate-sections true
1458 zstyle ':completion:*:manuals.*' insert-sections true
1459 zstyle ':completion:*:man:*' menu yes select
1461 # run rehash on completion so new installed program are found automatically:
1463 (( CURRENT == 1 )) && rehash
1468 # some people don't like the automatic correction - so run 'NOCOR=1 zsh' to deactivate it
1469 if [[ -n "$NOCOR" ]] ; then
1470 zstyle ':completion:*' completer _oldlist _expand _force_rehash _complete _files _ignored
1473 # try to be smart about when to use what completer...
1475 zstyle -e ':completion:*' completer '
1476 if [[ $_last_try != "$HISTNO$BUFFER$CURSOR" ]] ; then
1477 _last_try="$HISTNO$BUFFER$CURSOR"
1478 reply=(_complete _match _ignored _prefix _files)
1480 if [[ $words[1] == (rm|mv) ]] ; then
1481 reply=(_complete _files)
1483 reply=(_oldlist _expand _force_rehash _complete _ignored _correct _approximate _files)
1488 # zstyle ':completion:*' completer _complete _correct _approximate
1489 # zstyle ':completion:*' expand prefix suffix
1491 # command for process lists, the local web server details and host completion
1492 zstyle ':completion:*:urls' local 'www' '/var/www/' 'public_html'
1495 [[ -d $ZSHDIR/cache ]] && zstyle ':completion:*' use-cache yes && \
1496 zstyle ':completion::complete:*' cache-path $ZSHDIR/cache/
1498 # host completion /* add brackets as vim can't parse zsh's complex cmdlines 8-) {{{ */
1500 [[ -r ~/.ssh/known_hosts ]] && _ssh_hosts=(${${${${(f)"$(<$HOME/.ssh/known_hosts)"}:#[\|]*}%%\ *}%%,*}) || _ssh_hosts=()
1501 [[ -r /etc/hosts ]] && : ${(A)_etc_hosts:=${(s: :)${(ps:\t:)${${(f)~~"$(</etc/hosts)"}%%\#*}##[:blank:]#[^[:blank:]]#}}} || _etc_hosts=()
1513 zstyle ':completion:*:hosts' hosts $hosts
1514 # zstyle '*' hosts $hosts
1516 # specify your logins:
1518 # {grml,grml1}@foo.invalid
1519 # grml-devel@bar.invalid
1522 # {fred,root}@foo.invalid
1525 # zstyle ':completion:*:my-accounts' users-hosts $my_accounts
1526 # zstyle ':completion:*:other-accounts' users-hosts $other_accounts
1528 # specify specific port/service settings:
1529 # telnet_users_hosts_ports=(
1532 # @mail-server:{smtp,pop3}
1534 # @proxy-server:8000
1536 # zstyle ':completion:*:*:telnet:*' users-hosts-ports $telnet_users_hosts_ports
1538 # use generic completion system for programs not yet defined; (_gnu_generic works
1539 # with commands that provide a --help option with "standard" gnu-like output.)
1540 compdef _gnu_generic tail head feh cp mv df stow uname ipacsum fetchipac
1542 # see upgrade function in this file
1543 compdef _hosts upgrade
1549 # people should use 'grml-x'!
1551 if [[ -e /etc/X11/xorg.conf ]] ; then
1552 [[ -x /usr/bin/startx ]] && /usr/bin/startx "$@" || /usr/X11R6/bin/startx "$@"
1554 echo "Please use the script \"grml-x\" for starting the X Window System
1555 because there does not exist /etc/X11/xorg.conf yet.
1556 If you want to use startx anyway please call \"/usr/bin/startx\"."
1562 if [[ -e /etc/X11/xorg.conf ]] ; then
1563 [[ -x /usr/bin/xinit ]] && /usr/bin/xinit || /usr/X11R6/bin/xinit
1565 echo "Please use the script \"grml-x\" for starting the X Window System.
1566 because there does not exist /etc/X11/xorg.conf yet.
1567 If you want to use xinit anyway please call \"/usr/bin/xinit\"."
1572 if check_com -c 915resolution ; then
1573 alias 855resolution='echo -e "Please use 915resolution as resolution modify tool for Intel graphic chipset."; return -1'
1576 #a1# Output version of running grml
1577 alias grml-version='cat /etc/grml_version'
1579 if check_com -c rebuildfstab ; then
1580 #a1# Rebuild /etc/fstab
1581 alias grml-rebuildfstab='rebuildfstab -v -r -config'
1584 if check_com -c grml-debootstrap ; then
1585 alias debian2hd='print "Installing debian to harddisk is possible via using grml-debootstrap." ; return 1'
1590 # {{{ now run the functions
1592 is4 && isgrml && grmlstuff
1597 is4 && xsource "/etc/zsh/keephack"
1600 # {{{ wonderful idea of using "e" glob qualifier by Peter Stephenson
1601 # You use it as follows:
1602 # $ NTREF=/reference/file
1604 # This lists all the files in the current directory newer than the reference file.
1605 # You can also specify the reference file inline; note quotes:
1606 # $ ls -l *(e:'nt ~/.zshenv':)
1608 if [[ -n $1 ]] ; then
1611 [[ $REPLY -nt $NTREF ]]
1615 # shell functions {{{
1617 #f1# Provide csh compatibility
1618 setenv() { typeset -x "${1}${1:+=}${(@)argv[2,$#]}" } # csh compatibility
1620 #f1# Reload an autoloadable function
1621 freload() { while (( $# )); do; unfunction $1; autoload -U $1; shift; done }
1623 #f1# Reload zsh setup
1625 if [[ "$#*" -eq 0 ]] ; then
1626 [[ -r ~/.zshrc ]] && . ~/.zshrc
1635 compdef _functions reload freload
1637 #f1# List symlinks in detail (more detailed version of 'readlink -f' and 'whence -s')
1639 [[ -z "$1" ]] && printf 'Usage: %s <file(s)>\n' "$0" && return 1
1642 while [[ -h "$file" ]] ; do
1644 file=$(readlink "$file")
1649 # fast manual access
1650 if check_com qma ; then
1651 #f1# View the zsh manual
1652 manzsh() { qma zshall "$1" }
1655 manzsh() { /usr/bin/man zshall | vim -c "se ft=man| se hlsearch" +/"$1" - ; }
1656 # manzsh() { /usr/bin/man zshall | most +/"$1" ; }
1657 # [[ -f ~/.terminfo/m/mostlike ]] && MYLESS='LESS=C TERMINFO=~/.terminfo TERM=mostlike less' || MYLESS='less'
1658 # manzsh() { man zshall | $MYLESS -p $1 ; }
1661 if check_com -c $PAGER ; then
1662 #f1# View Debian's changelog of a given package
1664 if [[ -r /usr/share/doc/${1}/changelog.Debian.gz ]] ; then
1665 $PAGER /usr/share/doc/${1}/changelog.Debian.gz
1666 elif [[ -r /usr/share/doc/${1}/changelog.gz ]] ; then
1667 $PAGER /usr/share/doc/${1}/changelog.gz
1669 if check_com -c aptitude ; then
1670 echo "No changelog for package $1 found, using aptitude to retrieve it."
1672 aptitude -t unstable changelog ${1}
1674 aptitude changelog ${1}
1677 echo "No changelog for package $1 found, sorry."
1682 _dchange() { _files -W /usr/share/doc -/ }
1683 compdef _dchange dchange
1685 #f1# View Debian's NEWS of a given package
1687 if [[ -r /usr/share/doc/${1}/NEWS.Debian.gz ]] ; then
1688 $PAGER /usr/share/doc/${1}/NEWS.Debian.gz
1690 if [[ -r /usr/share/doc/${1}/NEWS.gz ]] ; then
1691 $PAGER /usr/share/doc/${1}/NEWS.gz
1693 echo "No NEWS file for package $1 found, sorry."
1698 _dnews() { _files -W /usr/share/doc -/ }
1699 compdef _dnews dnews
1701 #f1# View upstream's changelog of a given package
1703 if [[ -r /usr/share/doc/${1}/changelog.gz ]] ; then
1704 $PAGER /usr/share/doc/${1}/changelog.gz
1706 echo "No changelog for package $1 found, sorry."
1710 _uchange() { _files -W /usr/share/doc -/ }
1711 compdef _uchange uchange
1716 ZSH_PROFILE_RC=1 $SHELL "$@"
1719 #f1# Edit an alias via zle
1721 [[ -z "$1" ]] && { echo "Usage: edalias <alias_to_edit>" ; return 1 } || vared aliases'[$1]' ;
1723 compdef _aliases edalias
1725 #f1# Edit a function via zle
1727 [[ -z "$1" ]] && { echo "Usage: edfun <function_to_edit>" ; return 1 } || zed -f "$1" ;
1729 compdef _functions edfunc
1731 # use it e.g. via 'Restart apache2'
1732 #m# f6 Start() \kbd{/etc/init.d/\em{process}}\quad\kbd{start}
1733 #m# f6 Restart() \kbd{/etc/init.d/\em{process}}\quad\kbd{restart}
1734 #m# f6 Stop() \kbd{/etc/init.d/\em{process}}\quad\kbd{stop}
1735 #m# f6 Reload() \kbd{/etc/init.d/\em{process}}\quad\kbd{reload}
1736 #m# f6 Force-Reload() \kbd{/etc/init.d/\em{process}}\quad\kbd{force-reload}
1737 if [[ -d /etc/init.d ]] ; then
1738 for i in Start Restart Stop Force-Reload Reload ; do
1739 eval "$i() { $SUDO /etc/init.d/\$1 ${i:l} \$2 ; }"
1743 #f1# Provides useful information on globbing
1750 p named pipes (FIFOs)
1751 * executable plain files (0100)
1752 % device files (character or block special)
1753 %b block special files
1754 %c character special files
1755 r owner-readable files (0400)
1756 w owner-writable files (0200)
1757 x owner-executable files (0100)
1758 A group-readable files (0040)
1759 I group-writable files (0020)
1760 E group-executable files (0010)
1761 R world-readable files (0004)
1762 W world-writable files (0002)
1763 X world-executable files (0001)
1764 s setuid files (04000)
1765 S setgid files (02000)
1766 t files with the sticky bit (01000)
1768 print *(m-1) # Files modified up to a day ago
1769 print *(a1) # Files accessed a day ago
1770 print *(@) # Just symlinks
1771 print *(Lk+50) # Files bigger than 50 kilobytes
1772 print *(Lk-50) # Files smaller than 50 kilobytes
1773 print **/*.c # All *.c files recursively starting in \$PWD
1774 print **/*.c~file.c # Same as above, but excluding 'file.c'
1775 print (foo|bar).* # Files starting with 'foo' or 'bar'
1776 print *~*.* # All Files that do not contain a dot
1777 chmod 644 *(.^x) # make all plain non-executable files publically readable
1778 print -l *(.c|.h) # Lists *.c and *.h
1779 print **/*(g:users:) # Recursively match all files that are owned by group 'users'
1780 echo /proc/*/cwd(:h:t:s/self//) # Analogous to >ps ax | awk '{print $1}'<"
1782 alias help-zshglob=H-Glob
1784 check_com -c qma && alias ?='qma zshall'
1786 # grep for running process, like: 'any vim'
1788 if [[ -z "$1" ]] ; then
1789 echo "any - grep for process(es) by keyword" >&2
1790 echo "Usage: any <keyword>" >&2 ; return 1
1793 local LENGTH=$(expr length $STRING)
1794 local FIRSCHAR=$(echo $(expr substr $STRING 1 1))
1795 local REST=$(echo $(expr substr $STRING 2 $LENGTH))
1796 ps xauwww| grep "[$FIRSCHAR]$REST"
1800 # After resuming from suspend, system is paging heavily, leading to very bad interactivity.
1801 # taken from $LINUX-KERNELSOURCE/Documentation/power/swsusp.txt
1802 [[ -r /proc/1/maps ]] && \
1804 print 'Reading /proc/[0-9]*/maps and sending output to /dev/null, this might take a while.'
1805 cat $(sed -ne 's:.* /:/:p' /proc/[0-9]*/maps | sort -u | grep -v '^/dev/') > /dev/null
1806 print 'Finished, running "swapoff -a; swapon -a" may also be useful.'
1809 # print hex value of a number
1811 [[ -n "$1" ]] && printf "%x\n" $1 || { print 'Usage: hex <number-to-convert>' ; return 1 }
1814 # calculate (or eval at all ;-)) with perl => p[erl-]eval
1815 # hint: also take a look at zcalc -> 'autoload zcalc' -> 'man zshmodules | less -p MATHFUNC'
1817 [[ -n "$1" ]] && CALC="$*" || print "Usage: calc [expression]"
1818 perl -e "print eval($CALC),\"\n\";"
1820 functions peval &>/dev/null && alias calc=peval
1822 # brltty seems to have problems with utf8 environment and/or font Uni3-Terminus16 under
1823 # certain circumstances, so work around it, no matter which environment we have
1825 if [[ -z "$DISPLAY" ]] ; then
1826 consolechars -f /usr/share/consolefonts/default8x16.psf.gz
1833 # just press 'asdf' keys to toggle between dvorak and us keyboard layout
1835 echo -n 'Switching to us keyboard layout: '
1836 [[ -z "$DISPLAY" ]] && $SUDO loadkeys us &>/dev/null || setxkbmap us &>/dev/null
1840 echo -n 'Switching to dvorak keyboard layout: '
1841 [[ -z "$DISPLAY" ]] && $SUDO loadkeys dvorak &>/dev/null || setxkbmap dvorak &>/dev/null
1844 # just press 'asdf' key to toggle from neon layout to us keyboard layout
1846 echo -n 'Switching to us keyboard layout: '
1847 setxkbmap us && echo 'Done' || echo 'Failed'
1850 # set up an ipv6 tunnel
1854 if ifconfig sit1 2>/dev/null | grep -q 'inet6 addr: 2002:.*:1::1' ; then
1855 print 'ipv6 tunnel already set up, nothing to be done.'
1856 print 'execute: "ifconfig sit1 down ; ifconfig sit0 down" to remove ipv6-tunnel.' ; return 1
1858 [[ -n "$PUBLIC_IP" ]] || \
1859 local PUBLIC_IP=$(ifconfig $(route -n | awk '/^0\.0\.0\.0/{print $8; exit}') | \
1860 awk '/inet addr:/ {print $2}' | tr -d 'addr:')
1862 [[ -n "$PUBLIC_IP" ]] || { print 'No $PUBLIC_IP set and could not determine default one.' ; return 1 }
1863 local IPV6ADDR=$(printf "2002:%02x%02x:%02x%02x:1::1" $(print ${PUBLIC_IP//./ }))
1864 print -n "Setting up ipv6 tunnel $IPV6ADDR via ${PUBLIC_IP}: "
1865 ifconfig sit0 tunnel ::192.88.99.1 up
1866 ifconfig sit1 add "$IPV6ADDR" && print done || print failed
1870 if ifconfig sit1 2>/dev/null | grep -q 'inet6 addr: 2002:.*:1::1' ; then
1871 print 'ipv6 tunnel available' ; return 0
1873 print 'ipv6 tunnel not available' ; return 1
1877 if ifconfig sit1 2>/dev/null | grep -q 'inet6 addr: 2002:.*:1::1' ; then
1878 print -n 'Stopping ipv6 tunnel (sit0 + sit1): '
1879 ifconfig sit1 down ; ifconfig sit0 down && print done || print failed
1881 print 'No ipv6 tunnel found, nothing to be done.' ; return 1
1885 print "Usage: ipv6-tunnel [start|stop|status]">&2 ; return 1
1890 # run dhclient for wireless device
1892 salias dhclient "$(wavemon -d | awk '/device/{print $2}')"
1895 # spawn a minimally set up ksh - useful if you want to umount /usr/.
1897 exec env -i ENV="/etc/minimal-shellrc" HOME="$HOME" TERM="$TERM" ksh
1900 # make a backup of a file
1902 cp -a "$1" "${1}_$(date --iso-8601=seconds)"
1905 # Switching shell safely and efficiently? http://www.zsh.org/mla/workers/2001/msg02410.html
1907 # NO_SWITCH="yes" command bash "$@"
1910 # exec $SHELL $SHELL_ARGS "$@"
1915 # log out? set timeout in seconds {{{
1917 # do not log out in some specific terminals:
1918 # if [[ "${TERM}" == ([Exa]term*|rxvt|dtterm|screen*) ]] ; then
1923 # {{{ make sure our environment is clean regarding colors
1924 for color in BLUE RED GREEN CYAN WHITE ; unset $color
1927 # source another config file if present {{{
1928 xsource "/etc/zsh/zshrc.local"
1931 # "persistent history" {{{
1932 # just write important commands you always need to ~/.important_commands
1933 if [[ -r ~/.important_commands ]] ; then
1934 fc -R ~/.important_commands
1938 ## genrefcard.pl settings {{{
1939 ### example: split functions-search 8,16,24,32
1940 #@# split functions-search 8
1943 # add variable to be able to check whether the file has been read {{{
1944 ZSHRC_GLOBAL_HAS_BEEN_READ=1
1947 ## END OF FILE #################################################################
1948 # vim:filetype=zsh foldmethod=marker autoindent expandtab shiftwidth=4