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: Wed Aug 06 23:50:53 CEST 2008 [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 # {{{ check for version/system
96 # check for versions (compatibility reasons)
98 [[ $ZSH_VERSION == <4->* ]] && return 0
103 [[ $ZSH_VERSION == 4.<1->* || $ZSH_VERSION == <5->* ]] && return 0
108 [[ $ZSH_VERSION == 4.<2->* || $ZSH_VERSION == <5->* ]] && return 0
113 [[ $ZSH_VERSION == 4.<3->* || $ZSH_VERSION == <5->* ]] && return 0
117 #f1# Checks whether or not you're running grml
119 [[ -f /etc/grml_version ]] && return 0
123 #f1# Checks whether or not you're running a grml cd
125 [[ -f /etc/grml_cd ]] && return 0
130 #f1# Checks whether or not you're running grml-small
132 [[ ${${${(f)"$(</etc/grml_version)"}%% *}##*-} == 'small' ]] && return 0 ; return 1
135 isgrmlsmall() { return 1 }
138 #f1# are we running within an utf environment?
140 case "$LANG $CHARSET $LANGUAGE" in
147 # check for user, if not running as root set $SUDO to sudo
148 (( EUID != 0 )) && SUDO='sudo' || SUDO=''
150 # change directory to home on first invocation of zsh
151 # important for rungetty -> autologin
152 # Thanks go to Bart Schaefer!
153 isgrml && checkhome() {
154 if [[ -z "$ALREADY_DID_CD_HOME" ]] ; then
155 export ALREADY_DID_CD_HOME=$HOME
160 # check for zsh v3.1.7+
162 if ! [[ ${ZSH_VERSION} == 3.1.<7->* \
163 || ${ZSH_VERSION} == 3.<2->.<->* \
164 || ${ZSH_VERSION} == <4->.<->* ]] ; then
167 printf '-!- In this configuration we try to make use of features, that only\n'
168 printf '-!- require version 3.1.7 of the shell; That way this setup can be\n'
169 printf '-!- used with a wide range of zsh versions, while using fairly\n'
170 printf '-!- advanced features in all supported versions.\n'
172 printf '-!- However, you are running zsh version %s.\n' "$ZSH_VERSION"
174 printf '-!- While this *may* work, it might as well fail.\n'
175 printf '-!- Please consider updating to at least version 3.1.7 of zsh.\n'
177 printf '-!- DO NOT EXPECT THIS TO WORK FLAWLESSLY!\n'
178 printf '-!- If it does today, you'\''ve been lucky.\n'
180 printf '-!- Ye been warned!\n'
183 function zstyle() { : }
188 # utility functions {{{
189 # this function checks if a command exists and returns either true
190 # or false. This avoids using 'which' and 'whence', which will
191 # avoid problems with aliases for which on certain weird systems. :-)
195 if [[ ${1} == '-c' ]] ; then
202 if (( ${#argv} != 1 )) ; then
203 printf 'usage: check_com [-c] <command>\n' >&2
207 if (( comonly > 0 )) ; then
208 [[ -n ${commands[$1]} ]] && return 0
212 if [[ -n ${commands[$1]} ]] \
213 || [[ -n ${functions[$1]} ]] \
214 || [[ -n ${aliases[$1]} ]] \
215 || [[ -n ${reswords[(r)$1]} ]] ; then
223 # creates an alias and precedes the command with
224 # sudo if $EUID is not zero.
226 local only=0 ; local multi=0
227 while [[ ${1} == -* ]] ; do
231 (--) shift ; break ;;
233 printf 'usage: salias [-h|-o|-a] <alias-expression>\n'
234 printf ' -h shows this help text.\n'
235 printf ' -a replace '\'' ; '\'' sequences with '\'' ; sudo '\''.\n'
236 printf ' be careful using this option.\n'
237 printf ' -o only sets an alias if a preceding sudo would be needed.\n'
240 (*) printf "unkown option: '%s'\n" "${1}" ; return 1 ;;
245 if (( ${#argv} > 1 )) ; then
246 printf 'Too many arguments %s\n' "${#argv}"
250 key="${1%%\=*}" ; val="${1#*\=}"
251 if (( EUID == 0 )) && (( only == 0 )); then
252 alias -- "${key}=${val}"
253 elif (( EUID > 0 )) ; then
254 (( multi > 0 )) && val="${val// ; / ; sudo }"
255 alias -- "${key}=sudo ${val}"
261 # a "print -l ${(u)foo}"-workaround for pre-4.2.0 shells
263 # Where foo is the *name* of the parameter you want printed.
264 # Note that foo is no typo; $foo would be wrong here!
271 if [[ -z ${parameter} ]] ; then
272 printf 'usage: uprint <parameter>\n'
276 for w in ${(P)parameter} ; do
277 [[ -z ${(M)u:#${w}} ]] && u=( ${u} ${w} )
280 builtin print -l ${u}
284 # Check if we can read given files and source those we can.
286 if (( ${#argv} < 1 )) ; then
287 printf 'usage: xsource FILE(s)...\n' >&2
291 while (( ${#argv} > 0 )) ; do
292 [[ -r ${1} ]] && source ${1}
298 # Check if we can read a given file and 'cat(1)' it.
300 if (( ${#argv} != 1 )) ; then
301 printf 'usage: xcat FILE\n' >&2
305 [[ -r ${1} ]] && cat ${1}
309 # Remove these functions again, they are of use only in these
310 # setup files. This should be called at the end of .zshrc.
313 funcs=(salias xcat xsource xunfunction zrcautoload)
315 for func in $funcs ; do
316 [[ -n ${functions[$func]} ]] \
322 # autoload wrapper - use this one instead of autoload directly
323 function zrcautoload() {
324 setopt local_options extended_glob
330 for fdir in ${fpath} ; do
331 [[ -e ${fdir}/${ffile} ]] && (( ffound = 1 ))
334 (( ffound == 0 )) && return 1
335 if [[ $ZSH_VERSION == 3.1.<6-> || $ZSH_VERSION == <4->* ]] ; then
336 autoload -U ${ffile} || return 1
338 autoload ${ffile} || return 1
345 # Load is-at-least() for more precise version checks {{{
347 # Note that this test will *always* fail, if the is-at-least
348 # function could not be marked for autoloading.
349 zrcautoload is-at-least || is-at-least() { return 1 }
354 if [[ -z "$LANG" ]] ; then
355 xsource "/etc/default/locale"
358 export LANG=${LANG:-en_US.iso885915}
359 for var in LC_ALL LC_MESSAGES ; do
360 [[ -n ${(P)var} ]] && export $var
363 xsource "/etc/sysconfig/keyboard"
365 TZ=$(xcat /etc/timezone)
368 # check for potentially old files in 'completion.d' {{{
370 xof=(/etc/zsh/completion.d/*~/etc/zsh/completion.d/_*(N))
371 if (( ${#xof} > 0 )) ; then
372 printf '\n -!- INFORMATION\n\n'
373 printf ' -!- %s file(s) not starting with an underscore (_) found in\n' ${#xof}
374 printf ' -!- /etc/zsh/completion.d/.\n\n'
375 printf ' -!- While this has been the case in old versions of grml-etc-core,\n'
376 printf ' -!- recent versions of the grml-zsh-setup have all these files rewritten\n'
377 printf ' -!- and renamed. Furthermore, the grml-zsh-setup will *only* add files\n'
378 printf ' -!- named _* to that directory.\n\n'
379 printf ' -!- If you added functions to completion.d yourself, please consider\n'
380 printf ' -!- moving them to /etc/zsh/functions.d/. Files in that directory, not\n'
381 printf ' -!- starting with an underscore are marked for automatic loading\n'
382 printf ' -!- by default (so that is quite convenient).\n\n'
383 printf ' -!- If there are files *not* starting with an underscore from an older\n'
384 printf ' -!- grml-etc-core in completion.d, you may safely remove them.\n\n'
385 printf ' -!- Delete the files for example via running:\n\n'
386 printf " rm ${xof}\n\n"
387 printf ' -!- Note, that this message will *not* go away, unless you yourself\n'
388 printf ' -!- resolve the situation manually.\n\n'
389 BROKEN_COMPLETION_DIR=1
394 # {{{ set some variables
395 if check_com -c vim ; then
397 export EDITOR=${EDITOR:-vim}
399 export EDITOR=${EDITOR:-vi}
403 export PAGER=${PAGER:-less}
406 export MAIL=${MAIL:-/var/mail/$USER}
408 # if we don't set $SHELL then aterm, rxvt,.. will use /bin/sh or /bin/bash :-/
409 export SHELL='/bin/zsh'
411 # color setup for ls:
412 check_com -c dircolors && eval $(dircolors -b)
414 # set width of man pages to 80 for more convenient reading
415 # export MANWIDTH=${MANWIDTH:-80}
417 # Search path for the cd command
420 # completion functions go to /etc/zsh/completion.d
421 # function files may be put into /etc/zsh/functions.d, from where they
422 # will be automatically autoloaded.
423 if [[ -n "$BROKEN_COMPLETION_DIR" ]] ; then
424 print 'Warning: not setting completion directories because broken files have been found.' >&2
426 [[ -d /etc/zsh/completion.d ]] && fpath=( $fpath /etc/zsh/completion.d )
427 if [[ -d /etc/zsh/functions.d ]] ; then
428 fpath+=( /etc/zsh/functions.d )
429 for func in /etc/zsh/functions.d/[^_]*[^~] ; do
430 zrcautoload -U ${func:t}
435 # automatically remove duplicates from these arrays
436 typeset -U path cdpath fpath manpath
440 if [[ "$TERM" != emacs ]] ; then
441 [[ -z "$terminfo[kdch1]" ]] || bindkey -M emacs "$terminfo[kdch1]" delete-char
442 [[ -z "$terminfo[khome]" ]] || bindkey -M emacs "$terminfo[khome]" beginning-of-line
443 [[ -z "$terminfo[kend]" ]] || bindkey -M emacs "$terminfo[kend]" end-of-line
444 [[ -z "$terminfo[kdch1]" ]] || bindkey -M vicmd "$terminfo[kdch1]" vi-delete-char
445 [[ -z "$terminfo[khome]" ]] || bindkey -M vicmd "$terminfo[khome]" vi-beginning-of-line
446 [[ -z "$terminfo[kend]" ]] || bindkey -M vicmd "$terminfo[kend]" vi-end-of-line
447 [[ -z "$terminfo[cuu1]" ]] || bindkey -M viins "$terminfo[cuu1]" vi-up-line-or-history
448 [[ -z "$terminfo[cuf1]" ]] || bindkey -M viins "$terminfo[cuf1]" vi-forward-char
449 [[ -z "$terminfo[kcuu1]" ]] || bindkey -M viins "$terminfo[kcuu1]" vi-up-line-or-history
450 [[ -z "$terminfo[kcud1]" ]] || bindkey -M viins "$terminfo[kcud1]" vi-down-line-or-history
451 [[ -z "$terminfo[kcuf1]" ]] || bindkey -M viins "$terminfo[kcuf1]" vi-forward-char
452 [[ -z "$terminfo[kcub1]" ]] || bindkey -M viins "$terminfo[kcub1]" vi-backward-char
454 [[ "$terminfo[kcuu1]" == $'\eO'* ]] && bindkey -M viins "${terminfo[kcuu1]/O/[}" vi-up-line-or-history
455 [[ "$terminfo[kcud1]" == $'\eO'* ]] && bindkey -M viins "${terminfo[kcud1]/O/[}" vi-down-line-or-history
456 [[ "$terminfo[kcuf1]" == $'\eO'* ]] && bindkey -M viins "${terminfo[kcuf1]/O/[}" vi-forward-char
457 [[ "$terminfo[kcub1]" == $'\eO'* ]] && bindkey -M viins "${terminfo[kcub1]/O/[}" vi-backward-char
458 [[ "$terminfo[khome]" == $'\eO'* ]] && bindkey -M viins "${terminfo[khome]/O/[}" beginning-of-line
459 [[ "$terminfo[kend]" == $'\eO'* ]] && bindkey -M viins "${terminfo[kend]/O/[}" end-of-line
460 [[ "$terminfo[khome]" == $'\eO'* ]] && bindkey -M emacs "${terminfo[khome]/O/[}" beginning-of-line
461 [[ "$terminfo[kend]" == $'\eO'* ]] && bindkey -M emacs "${terminfo[kend]/O/[}" end-of-line
464 ## keybindings (run 'bindkeys' for details, more details via man zshzle)
465 # use emacs style per default:
470 #if [[ "$TERM" == screen ]] ; then
471 bindkey '\e[1~' beginning-of-line # home
472 bindkey '\e[4~' end-of-line # end
473 bindkey '\e[A' up-line-or-search # cursor up
474 bindkey '\e[B' down-line-or-search # <ESC>-
476 bindkey '^xp' history-beginning-search-backward
477 bindkey '^xP' history-beginning-search-forward
478 # bindkey -s '^L' "|less\n" # ctrl-L pipes to less
479 # bindkey -s '^B' " &\n" # ctrl-B runs it in the background
480 # if terminal type is set to 'rxvt':
481 bindkey '\e[7~' beginning-of-line # home
482 bindkey '\e[8~' end-of-line # end
485 # insert unicode character
486 # usage example: 'ctrl-x i' 00A7 'ctrl-x i' will give you an §
487 # See for example http://unicode.org/charts/ for unicode characters code
488 zrcautoload insert-unicode-char
489 zle -N insert-unicode-char
490 #k# Insert Unicode character
491 bindkey '^Xi' insert-unicode-char
493 # just type 'cd ...' to get 'cd ../..'
494 # rationalise-dot() {
495 # if [[ $LBUFFER == *.. ]] ; then
501 # zle -N rationalise-dot
502 # bindkey . rationalise-dot
504 # bindkey '\eq' push-line-or-edit
506 ## toggle the ,. abbreviation feature on/off
507 # NOABBREVIATION: default abbreviation-state
508 # 0 - enabled (default)
510 NOABBREVIATION=${NOABBREVIATION:-0}
512 grml_toggle_abbrev() {
513 if (( ${NOABBREVIATION} > 0 )) ; then
520 zle -N grml_toggle_abbrev
521 bindkey '^xA' grml_toggle_abbrev
525 # a generic accept-line wrapper {{{
527 # This widget can prevent unwanted autocorrections from command-name
528 # to _command-name, rehash automatically on enter and call any number
529 # of builtin and user-defined widgets in different contexts.
531 # For a broader description, see:
532 # <http://bewatermyfriend.org/posts/2007/12-26.11-50-38-tooltime.html>
534 # The code is imported from the file 'zsh/functions/accept-line' from
535 # <http://ft.bewatermyfriend.org/comp/zsh/zsh-dotfiles.tar.bz2>, which
536 # distributed under the same terms as zsh itself.
538 # A newly added command will may not be found or will cause false
539 # correction attempts, if you got auto-correction set. By setting the
540 # following style, we force accept-line() to rehash, if it cannot
541 # find the first word on the command line in the $command[] hash.
542 zstyle ':acceptline:*' rehash true
544 function Accept-Line() {
545 setopt localoptions noksharrays
550 zstyle -a ":acceptline:${alcontext}" actions subs
552 (( ${#subs} < 1 )) && return 0
555 for sub in ${subs} ; do
556 [[ ${sub} == 'accept-line' ]] && sub='.accept-line'
559 (( aldone > 0 )) && break
563 function Accept-Line-getdefault() {
566 zstyle -s ":acceptline:${alcontext}" default_action default_action
567 case ${default_action} in
569 printf ".accept-line"
572 printf ${default_action}
577 function accept-line() {
578 setopt localoptions noksharrays
581 local buf com fname format msg default_action
585 cmdline=(${(z)BUFFER})
589 zstyle -t ":acceptline:${alcontext}" rehash \
590 && [[ -z ${commands[$com]} ]] \
593 if [[ -n ${reswords[(r)$com]} ]] \
594 || [[ -n ${aliases[$com]} ]] \
595 || [[ -n ${functions[$com]} ]] \
596 || [[ -n ${builtins[$com]} ]] \
597 || [[ -n ${commands[$com]} ]] ; then
599 # there is something sensible to execute, just do it.
603 default_action=$(Accept-Line-getdefault)
604 zstyle -T ":acceptline:${alcontext}" call_default \
605 && zle ${default_action}
609 if [[ -o correct ]] \
610 || [[ -o correctall ]] \
611 && [[ -n ${functions[$fname]} ]] ; then
613 # nothing there to execute but there is a function called
614 # _command_name; a completion widget. Makes no sense to
615 # call it on the commandline, but the correct{,all} options
616 # will ask for it nevertheless, so warn the user.
617 if [[ ${LASTWIDGET} == 'accept-line' ]] ; then
618 # Okay, we warned the user before, he called us again,
619 # so have it his way.
623 default_action=$(Accept-Line-getdefault)
624 zstyle -T ":acceptline:${alcontext}" call_default \
625 && zle ${default_action}
629 # prepare warning message for the user, configurable via zstyle.
630 zstyle -s ":acceptline:${alcontext}" compwarnfmt msg
632 if [[ -z ${msg} ]] ; then
633 msg="%c will not execute and completion %f exists."
636 zformat -f msg "${msg}" "c:${com}" "f:${fname}"
640 elif [[ -n ${buf//[$' \t\n']##/} ]] ; then
641 # If we are here, the commandline contains something that is not
642 # executable, which is neither subject to _command_name correction
643 # and is not empty. might be a variable assignment
647 default_action=$(Accept-Line-getdefault)
648 zstyle -T ":acceptline:${alcontext}" call_default \
649 && zle ${default_action}
653 # If we got this far, the commandline only contains whitespace, or is empty.
657 default_action=$(Accept-Line-getdefault)
658 zstyle -T ":acceptline:${alcontext}" call_default \
659 && zle ${default_action}
667 # power completion - abbreviation expansion {{{
668 # power completion / abbreviation expansion / buffer expansion
669 # see http://zshwiki.org/home/examples/zleiab for details
670 # less risky than the global aliases but powerful as well
671 # just type the abbreviation key and afterwards ',.' to expand it
674 setopt interactivecomments
676 # key # value (#d additional doc string)
682 'G' '|& grep --color=auto'
684 'Hl' ' --help |& less -r' #d (Display help in pager)
688 'N' '&>/dev/null' #d (No Output)
689 'R' '| tr A-z N-za-m' #d (ROT13)
695 'hide' "echo -en '\033]50;nil2\007'"
696 'tiny' 'echo -en "\033]50;-misc-fixed-medium-r-normal-*-*-80-*-*-c-*-iso8859-15\007"'
697 'small' 'echo -en "\033]50;6x10\007"'
698 'medium' 'echo -en "\033]50;-misc-fixed-medium-r-normal--13-120-75-75-c-80-iso8859-15\007"'
699 'default' 'echo -e "\033]50;-misc-fixed-medium-r-normal-*-*-140-*-*-c-*-iso8859-15\007"'
700 'large' 'echo -en "\033]50;-misc-fixed-medium-r-normal-*-*-150-*-*-c-*-iso8859-15\007"'
701 'huge' 'echo -en "\033]50;-misc-fixed-medium-r-normal-*-*-210-*-*-c-*-iso8859-15\007"'
702 'smartfont' 'echo -en "\033]50;-artwiz-smoothansi-*-*-*-*-*-*-*-*-*-*-*-*\007"'
703 'semifont' 'echo -en "\033]50;-misc-fixed-medium-r-semicondensed-*-*-120-*-*-*-*-iso8859-15\007"'
707 'co' "./configure && make && sudo make install"
708 'CH' "./configure --help"
709 'conkeror' 'firefox -chrome chrome://conkeror/content'
711 'lad' $'ls -d .*(/)\n# only show dot-directories'
712 'lsa' $'ls -a .*(.)\n# only show dot-files'
713 'lss' $'ls -l *(s,S,t)\n# only files with setgid/setuid/sticky flag'
714 'lsl' $'ls -l *(@[1,10])\n# only symlinks'
715 'lsx' $'ls -l *(*[1,10])\n# only executables'
716 'lsw' $'ls -ld *(R,W,X.^ND/)\n# world-{readable,writable,executable} files'
717 'lsbig' $'ls -flh *(.OL[1,10])\n# display the biggest files'
718 'lsd' $'ls -d *(/)\n# only show directories'
719 'lse' $'ls -d *(/^F)\n# only show empty directories'
720 'lsnew' $'ls -rl *(D.om[1,10])\n# display the newest files'
721 'lsold' $'ls -rtlh *(D.om[-11,-1])\n # display the oldest files'
722 'lssmall' $'ls -Srl *(.oL[1,10])\n# display the smallest files'
724 '600' 'chmod u+rw-x,g-rwx,o-rwx'
726 '700' 'chmod u+rwx,g-rwx,o-rwx'
727 'r--' 'chmod u+r-wx,g-rwx,o-rwx'
728 '644' $'chmod u+rw-x,g+r-wx,o+r-wx\n # 4=r,2=w,1=x'
729 '755' 'chmod u+rwx,g+r-w+x,o+r-w+x'
731 'cmplayer' 'mplayer -vo -fs -zoom fbdev'
732 'fbmplayer' 'mplayer -vo -fs -zoom fbdev'
733 'fblinks' 'links2 -driver fb'
734 'insecssh' 'ssh -o "StrictHostKeyChecking=no" -o "UserKnownHostsFile=/dev/null"'
735 'insecscp' 'scp -o "StrictHostKeyChecking=no" -o "UserKnownHostsFile=/dev/null"'
736 'fori' 'for i ({..}) { }'
739 'se' 'setopt interactivecomments'
740 'va' 'valac --vapidir=../vapi/ --pkg=gtk+-2.0 gtktest.vala'
741 'fb2' '=mplayer -vo fbdev -fs -zoom 1>/dev/null -xy 2'
742 'fb3' '=mplayer -vo fbdev -fs -zoom 1>/dev/null -xy 3'
744 'D' 'export DISPLAY=:0.0'
745 'mp' 'mplayer -vo xv -fs -zoom'
751 if (( NOABBREVIATION > 0 )) ; then
752 LBUFFER="${LBUFFER},."
756 matched_chars='[.-|_a-zA-Z0-9]#'
757 LBUFFER=${LBUFFER%%(#m)[.-|_a-zA-Z0-9]#}
758 LBUFFER+=${abk[$MATCH]:-$MATCH}
762 bindkey ",." globalias
766 zrcautoload zmv # who needs mmv or rename?
767 zrcautoload history-search-end
769 # we don't want to quote/espace URLs on our own...
770 # if autoload -U url-quote-magic ; then
771 # zle -N self-insert url-quote-magic
772 # zstyle ':url-quote-magic:*' url-metas '*?[]^()~#{}='
774 # print 'Notice: no url-quote-magic available :('
776 alias url-quote='autoload -U url-quote-magic ; zle -N self-insert url-quote-magic'
778 #m# k ESC-h Call \kbd{run-help} for the 1st word on the command line
779 alias run-help >&/dev/null && unalias run-help
780 zrcautoload run-help # use via 'esc-h'
783 if zrcautoload compinit && compinit 2>/dev/null ; then
784 compinit 2>/dev/null || print 'Notice: no compinit available :('
786 print 'Notice: no compinit available :('
791 is4 && zrcautoload zed # use ZLE editor to edit a file or function
794 for mod in complist deltochar mathfunc ; do
795 zmodload -i zsh/${mod} 2>/dev/null || print "Notice: no ${mod} available :("
798 # autoload zsh modules when they are referenced
807 while (( ${#tmpargs} > 0 )) ; do
808 zmodload -${tmpargs[1]} zsh/${tmpargs[2]} ${tmpargs[2]}
814 if is4 && zrcautoload insert-files && zle -N insert-files ; then
816 bindkey "^Xf" insert-files # C-x-f
819 bindkey ' ' magic-space # also do history expansion on space
820 #k# Trigger menu-complete
821 bindkey '\ei' menu-complete # menu completion via esc-i
823 # press esc-e for editing command line in $EDITOR or $VISUAL
824 if is4 && zrcautoload edit-command-line && zle -N edit-command-line ; then
825 #k# Edit the current line in \kbd{\$EDITOR}
826 bindkey '\ee' edit-command-line
829 if is4 && [[ -n ${(k)modules[zsh/complist]} ]] ; then
830 #k# menu selection: pick item but stay in the menu
831 bindkey -M menuselect '\e^M' accept-and-menu-complete
833 # use the vi navigation keys (hjkl) besides cursor keys in menu completion
834 #bindkey -M menuselect 'h' vi-backward-char # left
835 #bindkey -M menuselect 'k' vi-up-line-or-history # up
836 #bindkey -M menuselect 'l' vi-forward-char # right
837 #bindkey -M menuselect 'j' vi-down-line-or-history # bottom
839 # accept a completion and try to complete again by using menu
840 # completion; very useful with completing directories
841 # by using 'undo' one's got a simple file browser
842 bindkey -M menuselect '^o' accept-and-infer-next-history
845 # press "ctrl-e d" to insert the actual date in the form yyyy-mm-dd
846 _bkdate() { BUFFER="$BUFFER$(date '+%F')"; CURSOR=$#BUFFER; }
849 #k# Insert a timestamp on the command line (yyyy-mm-dd)
850 bindkey '^Ed' _bkdate
852 # press esc-m for inserting last typed word again (thanks to caphuso!)
853 insert-last-typed-word() { zle insert-last-word -- 0 -1 };
854 zle -N insert-last-typed-word;
856 #k# Insert last typed word
857 bindkey "\em" insert-last-typed-word
859 # set command prediction from history, see 'man 1 zshcontrib'
860 # is4 && zrcautoload predict-on && \
861 # zle -N predict-on && \
862 # zle -N predict-off && \
863 # bindkey "^X^Z" predict-on && \
864 # bindkey "^Z" predict-off
866 #k# Shortcut for \kbd{fg<enter>}
867 bindkey -s '^z' "fg\n"
869 # press ctrl-q to quote line:
871 # zle beginning-of-line
873 # # RBUFFER="'$RBUFFER'"
874 # RBUFFER=${(q)RBUFFER}
877 # zle -N mquote && bindkey '^q' mquote
879 # run command line as user root via sudo:
880 sudo-command-line() {
881 [[ -z $BUFFER ]] && zle up-history
882 [[ $BUFFER != sudo\ * ]] && BUFFER="sudo $BUFFER"
884 zle -N sudo-command-line
886 #k# Put the current command line into a \kbd{sudo} call
887 bindkey "^Os" sudo-command-line
889 ### jump behind the first word on the cmdline.
890 ### useful to add options.
891 function jump_after_first_word() {
895 if (( ${#words} <= 1 )) ; then
898 CURSOR=${#${words[1]}}
901 zle -N jump_after_first_word
903 bindkey '^x1' jump_after_first_word
907 # {{{ set some important options
908 # Please update these tags, if you change the umask settings below.
910 #o# r_umaskstr rwxrwxr-x
912 #o# umaskstr rwxr-xr-x
913 (( EUID != 0 )) && umask 002 || umask 022
916 setopt append_history # append history list to the history file (important for multiple parallel zsh sessions!)
917 is4 && setopt SHARE_HISTORY # import new commands from the history file also in other zsh-session
918 setopt extended_history # save each command's beginning timestamp and the duration to the history file
919 is4 && setopt histignorealldups # If a new command line being added to the history
920 # list duplicates an older one, the older command is removed from the list
921 setopt histignorespace # remove command lines from the history list when
922 # the first character on the line is a space
923 # setopt histallowclobber # add `|' to output redirections in the history
924 # setopt NO_clobber # warning if file exists ('cat /dev/null > ~/.zshrc')
925 setopt auto_cd # if a command is issued that can't be executed as a normal command,
926 # and the command is the name of a directory, perform the cd command to that directory
927 setopt extended_glob # in order to use #, ~ and ^ for filename generation
928 # grep word *~(*.gz|*.bz|*.bz2|*.zip|*.Z) ->
929 # -> searches for word not in compressed files
930 # don't forget to quote '^', '~' and '#'!
931 setopt longlistjobs # display PID when suspending processes as well
932 setopt notify # report the status of backgrounds jobs immediately
933 setopt hash_list_all # Whenever a command completion is attempted, make sure \
934 # the entire command path is hashed first.
935 setopt completeinword # not just at the end
936 # setopt nocheckjobs # don't warn me about bg processes when exiting
937 setopt nohup # and don't kill them, either
938 # setopt printexitvalue # alert me if something failed
939 # setopt dvorak # with spelling correction, assume dvorak kb
940 setopt auto_pushd # make cd push the old directory onto the directory stack.
941 setopt nonomatch # try to avoid the 'zsh: no matches found...'
942 setopt nobeep # avoid "beep"ing
943 setopt pushd_ignore_dups # don't push the same dir twice.
945 MAILCHECK=30 # mailchecks
946 REPORTTIME=5 # report about cpu-/system-/user-time of command if running longer than 5 seconds
947 watch=(notme root) # watch for everyone but me and root
949 # define word separators (for stuff like backward-word, forward-word, backward-kill-word,..)
950 # WORDCHARS='*?_-.[]~=/&;!#$%^(){}<>' # the default
952 # WORDCHARS='*?_[]~=&;!#$%^(){}'
953 # WORDCHARS='${WORDCHARS:s@/@}'
955 # only slash should be considered as a word separator:
956 slash-backward-kill-word() {
957 local WORDCHARS="${WORDCHARS:s@/@}"
959 zle backward-kill-word
961 zle -N slash-backward-kill-word
963 #k# Kill everything in a word up to its last \kbd{/}
964 bindkey '\ev' slash-backward-kill-word
973 HISTFILE=$HOME/.zsh_history
974 isgrmlcd && HISTSIZE=500 || HISTSIZE=5000
975 isgrmlcd && SAVEHIST=1000 || SAVEHIST=10000 # useful for setopt append_history
979 # dirstack handling {{{
981 DIRSTACKSIZE=${DIRSTACKSIZE:-20}
982 DIRSTACKFILE=${DIRSTACKFILE:-${HOME}/.zdirs}
984 if [[ -f ${DIRSTACKFILE} ]] && [[ ${#dirstack[*]} -eq 0 ]] ; then
985 dirstack=( ${(f)"$(< $DIRSTACKFILE)"} )
986 # "cd -" won't work after login by just setting $OLDPWD, so
987 [[ -d $dirstack[0] ]] && cd $dirstack[0] && cd $OLDPWD
992 builtin print -l ${(u)dirstack} >! ${DIRSTACKFILE}
994 uprint dirstack >! ${DIRSTACKFILE}
1000 # {{{ display battery status on right side of prompt via running 'BATTERY=1 zsh'
1001 if [[ -n "$BATTERY" ]] ; then
1002 if check_com -c acpi ; then
1003 PERCENT="${(C)${(s| |)$(acpi 2>/dev/null)}[4]}"
1004 [[ -z "$PERCENT" ]] && PERCENT='acpi not present'
1006 if [[ "${PERCENT%%%}" -lt 20 ]] ; then
1007 PERCENT="warning: ${PERCENT}%"
1013 # set colors for use in prompts {{{
1014 if zrcautoload colors && colors 2>/dev/null ; then
1015 BLUE="%{${fg[blue]}%}"
1016 RED="%{${fg_bold[red]}%}"
1017 GREEN="%{${fg[green]}%}"
1018 CYAN="%{${fg[cyan]}%}"
1019 MAGENTA="%{${fg[magenta]}%}"
1020 YELLOW="%{${fg[yellow]}%}"
1021 WHITE="%{${fg[white]}%}"
1022 NO_COLOUR="%{${reset_color}%}"
1024 BLUE=$'%{\e[1;34m%}'
1026 GREEN=$'%{\e[1;32m%}'
1027 CYAN=$'%{\e[1;36m%}'
1028 WHITE=$'%{\e[1;37m%}'
1029 MAGENTA=$'%{\e[1;35m%}'
1030 YELLOW=$'%{\e[1;33m%}'
1031 NO_COLOUR=$'%{\e[0m%}'
1036 # gather version control information for inclusion in a prompt {{{
1038 # vcs_info() documentation: {{{
1040 # The vcs_info() feature can be configured via zstyle:
1041 # First, the context in which we are working:
1042 # :vcs_info:<vcs-string>
1043 # ...where <vcs-string> is one of:
1044 # - git, git-svn, hg, darcs, bzr, mtn, svn or svk
1046 # You can of course use ':vcs_info:*' to match all VCSs at once.
1048 # There is one special context named 'init', that is in effect as long
1049 # as there was no decision what vcs backend to use.
1051 # There are currently two styles, that are looked up:
1052 # promptformat - Used in most circumstances.
1053 # promptactionformat - Used if a there is a special action going on;
1054 # (like an interactive rebase or a merge conflict)
1055 # enable - check in the 'init' context. If set to false,
1056 # vcs_info() will do nothing.
1057 # disable - provide a list of systems, you don't want
1058 # the prompt to check for repositories (checked
1059 # in the 'init' context, too).
1061 # The default values for these in all contexts are:
1062 # promptformat " (%s)-[%b|%a]-"
1063 # promptactionformat " (%s)-[%b]-"
1066 # In these formats, the following replacements are done:
1067 # %s - The vcs in use (git, hg, svn etc.)
1068 # %b - Information about the current branch.
1069 # %a - An identifier, that describes the action.
1070 # Only makes sense in promptactionformat.
1071 # %R - base directory of the repository.
1072 # %r - repository name
1073 # If %R is '/foo/bar/repoXY', %r is 'repoXY'.
1075 # Not all vcs backends may support all replacements
1078 # Don't use vcs_info at all (even though it's in your prompt):
1079 # % zstyle ':vcs_info:*' enable false
1081 # Don't provide prompt info for bzr and svk:
1082 # % zstyle ':vcs_info:*' disable bzr svk
1084 # Provide a prompt specifically for git:
1085 # % zstyle ':vcs_info:git' promptformat ' GIT, BABY! [%b]'
1086 # % zstyle ':vcs_info:git' promptactionformat ' GIT ACTION! [%b|%a]'
1088 # If you want colors, make sure you enclose the color codes in %{...%}, because
1089 # the string provided by vcs_info() is used for prompts.
1091 # Example: PROMPT='%(?..[%?]-)%3~%$(vcs_info)#'
1093 # This *requires* 'setopt prompt_subst'.
1095 VCS_INFO_adjust () { #{{{
1096 [[ -n ${vcs_comm[overwrite_name]} ]] && vcs=${vcs_comm[overwrite_name]}
1100 VCS_INFO_format () { # {{{
1103 if [[ -n ${1} ]] ; then
1104 zstyle -s ":vcs_info:${vcs}" promptactionformat msg
1105 [[ -z ${msg} ]] && msg=' (%s)-[%b|%a]-'
1107 zstyle -s ":vcs_info:${vcs}" promptformat msg
1108 [[ -z ${msg} ]] && msg=' (%s)-[%b]-'
1113 VCS_INFO_realpath () { #{{{
1114 # replacing 'readlink -f', which is really not portable.
1116 # If there *is* a chpwd() function unfunction it here.
1117 # The *real* zsh does not loose its chpwd(), because we run
1118 # in a different context (process substitution in $PROMPT).
1119 (( ${+functions[chpwd]} )) && unfunction chpwd
1121 cd $1 2>/dev/null && pwd
1124 VCS_INFO_git_getaction () { #{{{
1125 local gitaction='' gitdir=${1}
1128 for tmp in "${gitdir}/rebase-apply" \
1129 "${gitdir}/rebase" \
1130 "${gitdir}/../.dotest" ; do
1131 if [[ -d ${tmp} ]] ; then
1132 if [[ -f "${tmp}/rebasing" ]] ; then
1134 elif [[ -f "${tmp}/applying" ]] ; then
1137 gitaction="am/rebase"
1139 printf '%s' ${gitaction}
1144 for tmp in "${gitdir}/rebase-merge/interactive" \
1145 "${gitdir}/.dotest-merge/interactive" ; do
1146 if [[ -f "${tmp}" ]] ; then
1147 printf '%s' "rebase-i"
1152 for tmp in "${gitdir}/rebase-merge" \
1153 "${gitdir}/.dotest-merge" ; do
1154 if [[ -d "${tmp}" ]] ; then
1155 printf '%s' "rebase-m"
1160 if [[ -f "${gitdir}/MERGE_HEAD" ]] ; then
1163 if [[ -f "${gitdir}/BISECT_LOG" ]] ; then
1164 printf '%s' "bisect"
1171 VCS_INFO_git_getbranch () { #{{{
1172 local gitbranch gitdir=${1}
1173 local gitsymref='git symbolic-ref HEAD'
1175 if [[ -d "${gitdir}/rebase-apply" ]] \
1176 || [[ -d "${gitdir}/rebase" ]] \
1177 || [[ -d "${gitdir}/../.dotest" ]] \
1178 || [[ -f "${gitdir}/MERGE_HEAD" ]] ; then
1179 gitbranch="$(${(z)gitsymref} 2> /dev/null)"
1180 [[ -z ${gitbranch} ]] && gitbranch="$(< ${gitdir}/rebase-apply/head-name)"
1182 elif [[ -f "${gitdir}/rebase-merge/interactive" ]] \
1183 || [[ -d "${gitdir}/rebase-merge" ]] ; then
1184 gitbranch="$(< ${gitdir}/rebase-merge/head-name)"
1186 elif [[ -f "${gitdir}/.dotest-merge/interactive" ]] \
1187 || [[ -d "${gitdir}/.dotest-merge" ]] ; then
1188 gitbranch="$(< ${gitdir}/.dotest-merge/head-name)"
1191 gitbranch="$(${(z)gitsymref} 2> /dev/null)"
1193 if [[ $? -ne 0 ]] ; then
1194 gitbranch="$(git describe --exact-match HEAD 2>/dev/null)"
1196 if [[ $? -ne 0 ]] ; then
1197 gitbranch="${${"$(< $gitdir/HEAD)"}[1,7]}..."
1202 printf '%s' "${gitbranch##refs/heads/}"
1205 VCS_INFO_git_get_data () { # {{{
1206 setopt localoptions extendedglob
1207 local gitdir gitbase gitbranch gitaction msg
1209 gitdir=${vcs_comm[gitdir]}
1210 gitbranch="$(VCS_INFO_git_getbranch ${gitdir})"
1212 if [[ -z ${gitdir} ]] || [[ -z ${gitbranch} ]] ; then
1217 gitaction="$(VCS_INFO_git_getaction ${gitdir})"
1218 msg=$(VCS_INFO_format ${gitaction})
1220 gitbase=${PWD%/${$(git rev-parse --show-prefix)%/##}}
1222 zformat -f msg "${msg}" "a:${gitaction}" "b:${gitbranch}" "s:${vcs}" "r:${gitbase:t}" "R:${gitbase}"
1226 VCS_INFO_darcs_get_data () { # {{{
1229 darcsbase=${vcs_comm[basedir]}
1230 msg=$(VCS_INFO_format)
1231 zformat -f msg "${msg}" "a:" "b:${darcsbase:t}" "s:${vcs}" "r:${darcsbase:t}" "R:${darcsbase}"
1235 VCS_INFO_hg_get_data () { # {{{
1236 local msg hgbranch hgbase
1238 hgbase=${vcs_comm[basedir]}
1239 hgbranch=$(< ${hgbase}/.hg/branch)
1240 msg=$(VCS_INFO_format)
1241 zformat -f msg "${msg}" "a:" "b:${hgbranch}" "s:${vcs}" "r:${hgbase:t}" "R:${hgbase}"
1245 VCS_INFO_mtn_get_data () { # {{{
1246 local msg mtnbranch mtnbase
1248 mtnbase=${vcs_comm[basedir]}
1249 mtnbranch=$(mtn status | awk '/Current branch:/{ sub("Current branch: ", ""); print }')
1250 msg=$(VCS_INFO_format)
1251 zformat -f msg "${msg}" "a:" "b:${mtnbranch}" "s:${vcs}" "r:${mtnbase:t}" "R:${mtnbase}"
1255 VCS_INFO_svk_get_data () { # {{{
1256 local msg svkbranch svkbase
1258 svkbase=${vcs_comm[basedir]}
1259 svkbranch=${svkbase##*
1264 msg=$(VCS_INFO_format)
1265 zformat -f msg "${msg}" "a:" "b:${svkbranch}" "s:${vcs}" "r:${svkbase:t}" "R:${svkbase}"
1269 VCS_INFO_svn_get_data () { # {{{
1270 local msg svnbranch svnbase
1273 while [[ -d "${svnbase}/../.svn" ]]; do
1274 svnbase="${svnbase}/.."
1276 svnbase=$(VCS_INFO_realpath ${svnbase})
1277 svnbranch=$(svn info "$base_dir" | awk '/^URL/ { sub(".*/","",$0); r=$0 } /^Revision/ { sub("[^0-9]*","",$0); print r":"$0 }')
1279 msg=$(VCS_INFO_format)
1280 zformat -f msg "${msg}" "a:" "b:${svnbranch}" "s:${vcs}" "r:${svnbase:t}" "R:${svnbase}"
1284 VCS_INFO_bzr_get_data () { # {{{
1285 local msg bzrbranch bzrbase bzrrevno i j
1287 bzrbase=$(bzr info 2>/dev/null | sed -rne 's, *branch root: ,,p')
1288 bzrbase=$(VCS_INFO_realpath ${bzrbase})
1290 bzr version-info 2> /dev/null | while read i j; do
1299 msg=$(VCS_INFO_format)
1300 zformat -f msg "${msg}" "a:" "b:${bzrbranch}:${bzrrevno}" "s:${vcs}" "r:${bzrbase:t}" "R:${bzrbase}"
1304 # VCS_INFO_*_detect () {{{
1306 VCS_INFO_detect_by_dir() {
1308 local basedir="." realbasedir
1310 realbasedir=$(VCS_INFO_realpath ${basedir})
1311 while [[ ${realbasedir} != '/' ]]; do
1312 if [[ -n ${vcs_comm[detect_need_file]} ]] ; then
1313 [[ -d ${basedir}/${dirname} ]] && \
1314 [[ -f ${basedir}/${dirname}/${vcs_comm[detect_need_file]} ]] && \
1317 [[ -d ${basedir}/${dirname} ]] && break
1320 basedir=${basedir}/..
1321 realbasedir=$(VCS_INFO_realpath ${basedir})
1324 [[ ${realbasedir} == "/" ]] && return 1
1325 vcs_comm[basedir]=${realbasedir}
1329 VCS_INFO_bzr_detect() {
1330 check_com -c bzr || return 1
1331 vcs_comm[detect_need_file]=branch/format
1332 VCS_INFO_detect_by_dir '.bzr'
1336 VCS_INFO_darcs_detect() {
1337 check_com -c darcs || return 1
1338 vcs_comm[detect_need_file]=format
1339 VCS_INFO_detect_by_dir '_darcs'
1343 VCS_INFO_git_detect() {
1344 if check_com -c git && git rev-parse --is-inside-work-tree &> /dev/null ; then
1345 vcs_comm[gitdir]="$(git rev-parse --git-dir 2> /dev/null)" || return 1
1346 [[ -d ${vcs_comm[gitdir]}/svn ]] && vcs_comm[overwrite_name]='git-svn'
1352 VCS_INFO_hg_detect() {
1353 check_com -c hg || return 1
1354 vcs_comm[detect_need_file]=branch
1355 VCS_INFO_detect_by_dir '.hg'
1359 VCS_INFO_mtn_detect() {
1360 check_com -c mtn || return 1
1361 vcs_comm[detect_need_file]=revision
1362 VCS_INFO_detect_by_dir '_MTN'
1366 VCS_INFO_svk_detect() {
1369 check_com -c svk || return 1
1370 [[ -f ~/.svk/config ]] || return 1
1372 basedir=$(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
1374 vcs_comm[basedir]=${basedir}
1378 VCS_INFO_svn_detect() {
1379 check_com -c svn || return 1
1380 [[ -d ".svn" ]] && return 0
1388 local -a VCSs disabled
1393 zstyle -T ":vcs_info:${vcs}" "enable" || return 0
1394 zstyle -a ":vcs_info:${vcs}" "disable" disabled
1396 VCSs=(git hg bzr darcs mtn svn svk)
1399 for vcs in ${VCSs} ; do
1400 [[ -n ${(M)disabled:#${vcs}} ]] && continue
1402 VCS_INFO_${vcs}_detect && (( found = 1 )) && break
1405 (( found == 0 )) && return 0
1407 string=$(VCS_INFO_${vcs}_get_data) || return 1
1408 printf '%s' ${string}
1413 # change vcs_info formats for the grml prompt
1414 if [[ "$TERM" == dumb ]] ; then
1415 zstyle ':vcs_info:*' promptactionformat "(%s%)-[%b|%a] "
1416 zstyle ':vcs_info:*' promptformat "(%s%)-[%b] "
1418 # these are the same, just with a lot of colours:
1419 zstyle ':vcs_info:*' promptactionformat "${MAGENTA}(${NO_COLOUR}%s${MAGENTA})${YELLOW}-${MAGENTA}[${GREEN}%b${YELLOW}|${RED}%a${MAGENTA}]${NO_COLOUR} "
1420 zstyle ':vcs_info:*' promptformat "${MAGENTA}(${NO_COLOUR}%s${MAGENTA})${YELLOW}-${MAGENTA}[${GREEN}%b${MAGENTA}]${NO_COLOUR}%} "
1426 if zrcautoload promptinit && promptinit 2>/dev/null ; then
1427 promptinit # people should be able to use their favourite prompt
1429 print 'Notice: no promptinit available :('
1434 # precmd() => a function which is executed just before each prompt
1435 # use 'NOPRECMD=1' to disable the precmd + preexec commands
1437 # precmd () { setopt promptsubst; [[ -o interactive ]] && jobs -l;
1439 # make sure to use right prompt only when not running a command
1440 is41 && setopt transient_rprompt
1442 is4 && [[ -z $NOPRECMD ]] && precmd () {
1443 [[ -n $NOPRECMD ]] && return 0
1444 # allow manual overwriting of RPROMPT
1445 if [[ -n $RPROMPT ]] ; then
1446 [[ $TERM == screen* ]] && echo -n $'\ekzsh\e\\'
1449 # just use DONTSETRPROMPT=1 to be able to overwrite RPROMPT
1450 if [[ -z $DONTSETRPROMPT ]] ; then
1451 if [[ -n $BATTERY ]] ; then
1452 RPROMPT="%(?..:()% ${PERCENT}${SCREENTITLE}"
1453 # RPROMPT="${PERCENT}${SCREENTITLE}"
1455 RPROMPT="%(?..:()% ${SCREENTITLE}"
1456 # RPROMPT="${SCREENTITLE}"
1459 # adjust title of xterm
1460 # see http://www.faqs.org/docs/Linux-mini/Xterm-Title.html
1463 print -Pn "\e]0;%n@%m: %~\a"
1468 # chpwd () => a function which is executed whenever the directory is changed
1470 # preexec() => a function running before every command
1471 is4 && [[ -z $NOPRECMD ]] && \
1473 [[ -n $NOPRECMD ]] && return 0
1474 # set hostname if not running on host with name 'grml'
1475 if [[ -n "$HOSTNAME" ]] && [[ "$HOSTNAME" != $(hostname) ]] ; then
1478 # get the name of the program currently running and hostname of local machine
1479 # set screen window title if running in a screen
1480 if [[ "$TERM" == screen* ]] ; then
1481 # local CMD=${1[(wr)^(*=*|sudo|ssh|-*)]} # don't use hostname
1482 local CMD="${1[(wr)^(*=*|sudo|ssh|-*)]}$NAME" # use hostname
1483 echo -ne "\ek$CMD\e\\"
1485 # set the screen title to "zsh" when sitting at the command prompt:
1486 if [[ "$TERM" == screen* ]] ; then
1487 SCREENTITLE=$'%{\ekzsh\e\\%}'
1491 # adjust title of xterm
1494 print -Pn "\e]0;%n@%m: $1\a"
1499 EXITCODE="%(?..%?%1v )"
1500 PS2='`%_> ' # secondary prompt, printed when the shell needs more information to complete a command.
1501 PS3='?# ' # selection prompt used within a select loop.
1502 PS4='+%N:%i:%_> ' # the execution trace prompt (setopt xtrace). default: '+%N:%i>'
1504 # set variable debian_chroot if running in a chroot with /etc/debian_chroot
1505 if [[ -z "$debian_chroot" ]] && [[ -r /etc/debian_chroot ]] ; then
1506 debian_chroot=$(cat /etc/debian_chroot)
1509 # don't use colors on dumb terminals (like emacs):
1510 if [[ "$TERM" == dumb ]] ; then
1511 PROMPT="${EXITCODE}${debian_chroot:+($debian_chroot)}%n@%m %40<...<%B%~%b%<< "'$(vcs_info)'"%# "
1513 # only if $GRMLPROMPT is set (e.g. via 'GRMLPROMPT=1 zsh') use the extended prompt
1514 # set variable identifying the chroot you work in (used in the prompt below)
1515 if [[ -n $GRMLPROMPT ]] ; then
1516 PROMPT="${RED}${EXITCODE}${CYAN}[%j running job(s)] ${GREEN}{history#%!} ${RED}%(3L.+.) ${BLUE}%* %D
1517 ${BLUE}%n${NO_COLOUR}@%m %40<...<%B%~%b%<< %# "
1519 # This assembles the primary prompt string
1520 if (( EUID != 0 )); then
1521 PROMPT="${RED}${EXITCODE}${WHITE}${debian_chroot:+($debian_chroot)}${BLUE}%n${NO_COLOUR}@%m %40<...<%B%~%b%<< "'$(vcs_info)'"%# "
1523 PROMPT="${BLUE}${EXITCODE}${WHITE}${debian_chroot:+($debian_chroot)}${RED}%n${NO_COLOUR}@%m %40<...<%B%~%b%<< "'$(vcs_info)'"%# "
1528 # if we are inside a grml-chroot set a specific prompt theme
1529 if [[ -n "$GRML_CHROOT" ]] ; then
1530 PROMPT="%{$fg[red]%}(CHROOT) %{$fg_bold[red]%}%n%{$fg_no_bold[white]%}@%m %40<...<%B%~%b%<< %\# "
1534 # {{{ 'hash' some often used directories
1536 hash -d deb=/var/cache/apt/archives
1537 hash -d doc=/usr/share/doc
1538 hash -d linux=/lib/modules/$(command uname -r)/build/
1539 hash -d log=/var/log
1540 hash -d slog=/var/log/syslog
1541 hash -d src=/usr/src
1542 hash -d templ=/usr/share/doc/grml-templates
1543 hash -d tt=/usr/share/doc/texttools-doc
1544 hash -d www=/var/www
1549 if [[ $UID -eq 0 ]] ; then
1550 [[ -r /etc/grml/screenrc ]] && alias screen='/usr/bin/screen -c /etc/grml/screenrc'
1551 elif [[ -r $HOME/.screenrc ]] ; then
1552 alias screen="/usr/bin/screen -c $HOME/.screenrc"
1554 [[ -r /etc/grml/screenrc_grml ]] && alias screen='/usr/bin/screen -c /etc/grml/screenrc_grml'
1557 # do we have GNU ls with color-support?
1558 if ls --help 2>/dev/null | grep -- --color= >/dev/null && [[ "$TERM" != dumb ]] ; then
1559 #a1# execute \kbd{@a@}:\quad ls with colors
1560 alias ls='ls -b -CF --color=auto'
1561 #a1# execute \kbd{@a@}:\quad list all files, with colors
1562 alias la='ls -la --color=auto'
1563 #a1# long colored list, without dotfiles (@a@)
1564 alias ll='ls -l --color=auto'
1565 #a1# long colored list, human readable sizes (@a@)
1566 alias lh='ls -hAl --color=auto'
1567 #a1# List files, append qualifier to filenames \\&\quad(\kbd{/} for directories, \kbd{@} for symlinks ...)
1568 alias l='ls -lF --color=auto'
1570 alias ls='ls -b -CF'
1577 alias mdstat='cat /proc/mdstat'
1578 alias ...='cd ../../'
1580 # generate alias named "$KERNELVERSION-reboot" so you can use boot with kexec:
1581 if [[ -x /sbin/kexec ]] && [[ -r /proc/cmdline ]] ; then
1582 alias "$(uname -r)-reboot"="kexec -l --initrd=/boot/initrd.img-"$(uname -r)" --command-line=\"$(cat /proc/cmdline)\" /boot/vmlinuz-"$(uname -r)""
1585 alias cp='nocorrect cp' # no spelling correction on cp
1586 alias mkdir='nocorrect mkdir' # no spelling correction on mkdir
1587 alias mv='nocorrect mv' # no spelling correction on mv
1588 alias rm='nocorrect rm' # no spelling correction on rm
1590 #a1# Execute \kbd{rmdir}
1592 #a1# Execute \kbd{rmdir}
1595 # see http://www.cl.cam.ac.uk/~mgk25/unicode.html#term for details
1596 alias term2iso="echo 'Setting terminal to iso mode' ; print -n '\e%@'"
1597 alias term2utf="echo 'Setting terminal to utf-8 mode'; print -n '\e%G'"
1599 # make sure it is not assigned yet
1600 [[ $(whence -w utf2iso &>/dev/null) == 'utf2iso: alias' ]] && unalias utf2iso
1604 for ENV in $(env | command grep -i '.utf') ; do
1605 eval export "$(echo $ENV | sed 's/UTF-8/iso885915/ ; s/utf8/iso885915/')"
1610 # make sure it is not assigned yet
1611 [[ $(whence -w iso2utf &>/dev/null) == 'iso2utf: alias' ]] && unalias iso2utf
1613 if ! isutfenv ; then
1614 for ENV in $(env | command grep -i '\.iso') ; do
1615 eval export "$(echo $ENV | sed 's/iso.*/UTF-8/ ; s/ISO.*/UTF-8/')"
1620 # set up software synthesizer via speakup
1622 aumix -w 90 -v 90 -p 90 -m 90
1623 if ! [[ -r /dev/softsynth ]] ; then
1624 flite -o play -t "Sorry, software synthesizer not available. Did you boot with swspeak bootoption?"
1627 setopt singlelinezle
1630 nice -n -20 speechd-up
1632 flite -o play -t "Finished setting up software synthesizer"
1636 # I like clean prompt, so provide simple way to get that
1637 check_com 0 || alias 0='return 0'
1639 # for really lazy people like mika:
1640 check_com S &>/dev/null || alias S='screen'
1641 check_com s &>/dev/null || alias s='ssh'
1643 # get top 10 shell commands:
1644 alias top10='print -l ? ${(o)history%% *} | uniq -c | sort -nr | head -n 10'
1646 # truecrypt; use e.g. via 'truec /dev/ice /mnt/ice' or 'truec -i'
1647 if check_com -c truecrypt ; then
1649 alias truec='truecrypt --mount-options "rw,sync,dirsync,users,uid=1000,gid=users,umask=077,utf8" '
1651 alias truec='truecrypt --mount-options "rw,sync,dirsync,users,uid=1000,gid=users,umask=077" '
1655 #f1# Hints for the use of zsh on grml
1657 print "$bg[white]$fg[black]
1658 zsh-help - hints for use of zsh on grml
1659 =======================================$reset_color"
1662 Main configuration of zsh happens in /etc/zsh/zshrc (global)
1663 and /etc/skel/.zshrc which is copied to $HOME/.zshrc once.
1664 The files are part of the package grml-etc-core, if you want to
1665 use them on a non-grml-system just get the tar.gz from
1666 http://deb.grml.org/ or get the files from the mercurial
1669 http://hg.grml.org/grml-etc-core/raw-file/tip/etc/skel/.zshrc
1670 http://hg.grml.org/grml-etc-core/raw-file/tip/etc/zsh/zshrc
1672 If you want to stay in sync with zsh configuration of grml
1673 run '\''ln -sf /etc/skel/.zshrc $HOME/.zshrc'\'' and configure
1674 your own stuff in $HOME/.zshrc.local. System wide configuration
1675 without touching configuration files of grml can take place
1676 in /etc/zsh/zshrc.local.
1678 If you want to use the configuration of user grml also when
1679 running as user root just run '\''zshskel'\'' which will source
1680 the file /etc/skel/.zshrc.
1682 For information regarding zsh start at http://grml.org/zsh/
1684 Take a look at grml'\''s zsh refcard:
1685 % xpdf =(zcat /usr/share/doc/grml-docs/zsh/grml-zsh-refcard.pdf.gz)
1687 Check out the main zsh refcard:
1688 % '$BROWSER' http://www.bash2zsh.com/zsh_refcard/refcard.pdf
1690 And of course visit the zsh-lovers:
1693 You can adjust some options through environment variables when
1694 invoking zsh without having to edit configuration files.
1695 Basically meant for bash users who are not used to the power of
1698 "NOCOR=1 zsh" => deactivate automatic correction
1699 "NOMENU=1 zsh" => do not use menu completion (note: use strg-d for completion instead!)
1700 "NOPRECMD=1 zsh" => disable the precmd + preexec commands (set GNU screen title)
1701 "BATTERY=1 zsh" => activate battery status (via acpi) on right side of prompt'
1704 $bg[white]$fg[black]
1705 Please report wishes + bugs to the grml-team: http://grml.org/bugs/
1706 Enjoy your grml system with the zsh!$reset_color"
1710 if [[ -r /etc/debian_version ]] ; then
1711 #a3# Execute \kbd{apt-cache search}
1712 alias acs='apt-cache search'
1713 #a3# Execute \kbd{apt-cache show}
1714 alias acsh='apt-cache show'
1715 #a3# Execute \kbd{apt-cache policy}
1716 alias acp='apt-cache policy'
1717 #a3# Execute \kbd{apt-get dist-upgrade}
1718 salias adg="apt-get dist-upgrade"
1719 #a3# Execute \kbd{apt-get install}
1720 salias agi="apt-get install"
1721 #a3# Execute \kbd{aptitude install}
1722 salias ati="aptitude install"
1723 #a3# Execute \kbd{apt-get upgrade}
1724 salias ag="apt-get upgrade"
1725 #a3# Execute \kbd{apt-get update}
1726 salias au="apt-get update"
1727 #a3# Execute \kbd{aptitude update ; aptitude safe-upgrade}
1728 salias -a up="aptitude update ; aptitude safe-upgrade"
1729 #a3# Execute \kbd{dpkg-buildpackage}
1730 alias dbp='dpkg-buildpackage'
1731 #a3# Execute \kbd{grep-excuses}
1732 alias ge='grep-excuses'
1735 #f3# Execute \kbd{apt-get update \&\& }\\&\quad \kbd{apt-get dist-upgrade}
1737 if [[ -z "$1" ]] ; then
1738 $SUDO apt-get update
1739 $SUDO apt-get -u upgrade
1741 ssh $1 $SUDO apt-get update
1742 # ask before the upgrade
1744 ssh $1 $SUDO apt-get --no-act upgrade
1745 echo -n 'Process the upgrade?'
1747 if [[ $dummy == "y" ]] ; then
1748 ssh $1 $SUDO apt-get -u upgrade --yes
1753 # get a root shell as normal user in live-cd mode:
1754 if isgrmlcd && [[ $UID -ne 0 ]] ; then
1758 #a1# Take a look at the syslog: \kbd{\$PAGER /var/log/syslog}
1759 alias llog="$PAGER /var/log/syslog" # take a look at the syslog
1760 #a1# Take a look at the syslog: \kbd{tail -f /var/log/syslog}
1761 alias tlog="tail -f /var/log/syslog" # follow the syslog
1762 #a1# (Re)-source \kbd{/etc/skel/.zshrc}
1763 alias zshskel="source /etc/skel/.zshrc" # source skeleton zshrc
1766 # sort installed Debian-packages by size
1767 if check_com -c grep-status ; then
1768 #a3# List installed Debian-packages sorted by size
1769 alias debs-by-size='grep-status -FStatus -sInstalled-Size,Package -n "install ok installed" | paste -sd " \n" | sort -rn'
1772 # if cdrecord is a symlink (to wodim) or isn't present at all warn:
1773 if [[ -L /usr/bin/cdrecord ]] || ! check_com -c cdrecord ; then
1774 if check_com -c wodim ; then
1775 alias cdrecord="echo 'cdrecord is not provided under its original name by Debian anymore.
1776 See #377109 in the BTS of Debian for more details.
1778 Please use the wodim binary instead' ; return 1"
1782 # get_tw_cli has been renamed into get_3ware
1783 if check_com -c get_3ware ; then
1785 echo 'Warning: get_tw_cli has been renamed into get_3ware. Invoking get_3ware for you.'>&2
1790 # I hate lacking backward compatibility, so provide an alternative therefore
1791 if ! check_com -c apache2-ssl-certificate ; then
1793 apache2-ssl-certificate() {
1795 print 'Debian does not ship apache2-ssl-certificate anymore (see #398520). :('
1796 print 'You might want to take a look at Debian the package ssl-cert as well.'
1797 print 'To generate a certificate for use with apache2 follow the instructions:'
1801 export RANDFILE=/dev/random
1802 mkdir /etc/apache2/ssl/
1803 openssl req $@ -new -x509 -days 365 -nodes -out /etc/apache2/ssl/apache.pem -keyout /etc/apache2/ssl/apache.pem
1804 chmod 600 /etc/apache2/ssl/apache.pem
1806 Run "grml-tips ssl-certificate" if you need further instructions.
1812 # {{{ Use hard limits, except for a smaller stack and no core dumps
1814 is4 && limit stack 8192
1815 isgrmlcd && limit core 0 # important for a live-cd-system
1819 # {{{ completion system
1821 # called later (via is4 && grmlcomp)
1822 # notice: use 'zstyle' for getting current settings
1823 # press ^Xh (control-x h) for getting tags in context; ^X? (control-x ?) to run complete_debug with trace output
1825 # TODO: This could use some additional information
1827 # allow one error for every three characters typed in approximate completer
1828 zstyle ':completion:*:approximate:' max-errors 'reply=( $((($#PREFIX+$#SUFFIX)/3 )) numeric )'
1830 # don't complete backup files as executables
1831 zstyle ':completion:*:complete:-command-::commands' ignored-patterns '(aptitude-*|*\~)'
1833 # start menu completion only if it could find no unambiguous initial string
1834 zstyle ':completion:*:correct:*' insert-unambiguous true
1835 zstyle ':completion:*:corrections' format $'%{\e[0;31m%}%d (errors: %e)%{\e[0m%}'
1836 zstyle ':completion:*:correct:*' original true
1838 # activate color-completion
1839 zstyle ':completion:*:default' list-colors ${(s.:.)LS_COLORS}
1841 # format on completion
1842 zstyle ':completion:*:descriptions' format $'%{\e[0;31m%}completing %B%d%b%{\e[0m%}'
1844 # complete 'cd -<tab>' with menu
1845 zstyle ':completion:*:*:cd:*:directory-stack' menu yes select
1847 # insert all expansions for expand completer
1848 zstyle ':completion:*:expand:*' tag-order all-expansions
1849 zstyle ':completion:*:history-words' list false
1852 zstyle ':completion:*:history-words' menu yes
1854 # ignore duplicate entries
1855 zstyle ':completion:*:history-words' remove-all-dups yes
1856 zstyle ':completion:*:history-words' stop yes
1858 # match uppercase from lowercase
1859 zstyle ':completion:*' matcher-list 'm:{a-z}={A-Z}'
1861 # separate matches into groups
1862 zstyle ':completion:*:matches' group 'yes'
1863 zstyle ':completion:*' group-name ''
1865 if [[ -z "$NOMENU" ]] ; then
1866 # if there are more than 5 options allow selecting from a menu
1867 zstyle ':completion:*' menu select=5
1869 # don't use any menus at all
1873 zstyle ':completion:*:messages' format '%d'
1874 zstyle ':completion:*:options' auto-description '%d'
1876 # describe options in full
1877 zstyle ':completion:*:options' description 'yes'
1879 # on processes completion complete all user processes
1880 zstyle ':completion:*:processes' command 'ps -au$USER'
1882 # offer indexes before parameters in subscripts
1883 zstyle ':completion:*:*:-subscript-:*' tag-order indexes parameters
1885 # provide verbose completion information
1886 zstyle ':completion:*' verbose true
1888 # recent (as of Dec 2007) zsh versions are able to provide descriptions
1889 # for commands (read: 1st word in the line) that it will list for the user
1890 # to choose from. The following disables that, because it's not exactly fast.
1891 zstyle ':completion:*:-command-:*:' verbose false
1893 # set format for warnings
1894 zstyle ':completion:*:warnings' format $'%{\e[0;31m%}No matches for:%{\e[0m%} %d'
1896 # define files to ignore for zcompile
1897 zstyle ':completion:*:*:zcompile:*' ignored-patterns '(*~|*.zwc)'
1898 zstyle ':completion:correct:' prompt 'correct to: %e'
1900 # Ignore completion functions for commands you don't have:
1901 zstyle ':completion::(^approximate*):*:functions' ignored-patterns '_*'
1903 # Provide more processes in completion of programs like killall:
1904 zstyle ':completion:*:processes-names' command 'ps c -u ${USER} -o command | uniq'
1906 # complete manual by their section
1907 zstyle ':completion:*:manuals' separate-sections true
1908 zstyle ':completion:*:manuals.*' insert-sections true
1909 zstyle ':completion:*:man:*' menu yes select
1911 # run rehash on completion so new installed program are found automatically:
1913 (( CURRENT == 1 )) && rehash
1918 # some people don't like the automatic correction - so run 'NOCOR=1 zsh' to deactivate it
1919 if [[ -n "$NOCOR" ]] ; then
1920 zstyle ':completion:*' completer _oldlist _expand _force_rehash _complete _files _ignored
1923 # try to be smart about when to use what completer...
1925 zstyle -e ':completion:*' completer '
1926 if [[ $_last_try != "$HISTNO$BUFFER$CURSOR" ]] ; then
1927 _last_try="$HISTNO$BUFFER$CURSOR"
1928 reply=(_complete _match _ignored _prefix _files)
1930 if [[ $words[1] == (rm|mv) ]] ; then
1931 reply=(_complete _files)
1933 reply=(_oldlist _expand _force_rehash _complete _ignored _correct _approximate _files)
1938 # zstyle ':completion:*' completer _complete _correct _approximate
1939 # zstyle ':completion:*' expand prefix suffix
1941 # complete shell aliases
1942 # zstyle ':completion:*' completer _expand_alias _complete _approximate
1944 # command for process lists, the local web server details and host completion
1945 zstyle ':completion:*:urls' local 'www' '/var/www/' 'public_html'
1948 [[ -d $ZSHDIR/cache ]] && zstyle ':completion:*' use-cache yes && \
1949 zstyle ':completion::complete:*' cache-path $ZSHDIR/cache/
1951 # host completion /* add brackets as vim can't parse zsh's complex cmdlines 8-) {{{ */
1953 [[ -r ~/.ssh/known_hosts ]] && _ssh_hosts=(${${${${(f)"$(<$HOME/.ssh/known_hosts)"}:#[\|]*}%%\ *}%%,*}) || _ssh_hosts=()
1954 [[ -r /etc/hosts ]] && : ${(A)_etc_hosts:=${(s: :)${(ps:\t:)${${(f)~~"$(</etc/hosts)"}%%\#*}##[:blank:]#[^[:blank:]]#}}} || _etc_hosts=()
1966 zstyle ':completion:*:hosts' hosts $hosts
1967 # zstyle '*' hosts $hosts
1969 # specify your logins:
1971 # {grml,grml1}@foo.invalid
1972 # grml-devel@bar.invalid
1975 # {fred,root}@foo.invalid
1978 # zstyle ':completion:*:my-accounts' users-hosts $my_accounts
1979 # zstyle ':completion:*:other-accounts' users-hosts $other_accounts
1981 # specify specific port/service settings:
1982 # telnet_users_hosts_ports=(
1985 # @mail-server:{smtp,pop3}
1987 # @proxy-server:8000
1989 # zstyle ':completion:*:*:telnet:*' users-hosts-ports $telnet_users_hosts_ports
1991 # use generic completion system for programs not yet defined; (_gnu_generic works
1992 # with commands that provide a --help option with "standard" gnu-like output.)
1993 compdef _gnu_generic tail head feh cp mv df stow uname ipacsum fetchipac
1995 # see upgrade function in this file
1996 compdef _hosts upgrade
2002 # people should use 'grml-x'!
2004 if [[ -e /etc/X11/xorg.conf ]] ; then
2005 [[ -x /usr/bin/startx ]] && /usr/bin/startx "$@" || /usr/X11R6/bin/startx "$@"
2007 echo "Please use the script \"grml-x\" for starting the X Window System
2008 because there does not exist /etc/X11/xorg.conf yet.
2009 If you want to use startx anyway please call \"/usr/bin/startx\"."
2015 if [[ -e /etc/X11/xorg.conf ]] ; then
2016 [[ -x /usr/bin/xinit ]] && /usr/bin/xinit || /usr/X11R6/bin/xinit
2018 echo "Please use the script \"grml-x\" for starting the X Window System.
2019 because there does not exist /etc/X11/xorg.conf yet.
2020 If you want to use xinit anyway please call \"/usr/bin/xinit\"."
2025 if check_com -c 915resolution ; then
2026 alias 855resolution='echo -e "Please use 915resolution as resolution modify tool for Intel graphic chipset."; return -1'
2029 #a1# Output version of running grml
2030 alias grml-version='cat /etc/grml_version'
2032 if check_com -c rebuildfstab ; then
2033 #a1# Rebuild /etc/fstab
2034 alias grml-rebuildfstab='rebuildfstab -v -r -config'
2037 if check_com -c grml-debootstrap ; then
2038 alias debian2hd='print "Installing debian to harddisk is possible via using grml-debootstrap." ; return 1'
2043 # {{{ now run the functions
2045 is4 && isgrml && grmlstuff
2050 is4 && xsource "/etc/zsh/keephack"
2053 # {{{ wonderful idea of using "e" glob qualifier by Peter Stephenson
2054 # You use it as follows:
2055 # $ NTREF=/reference/file
2057 # This lists all the files in the current directory newer than the reference file.
2058 # You can also specify the reference file inline; note quotes:
2059 # $ ls -l *(e:'nt ~/.zshenv':)
2061 if [[ -n $1 ]] ; then
2064 [[ $REPLY -nt $NTREF ]]
2068 # shell functions {{{
2070 #f1# Provide csh compatibility
2071 setenv() { typeset -x "${1}${1:+=}${(@)argv[2,$#]}" } # csh compatibility
2073 #f1# Reload an autoloadable function
2074 freload() { while (( $# )); do; unfunction $1; autoload -U $1; shift; done }
2076 #f1# Reload zsh setup
2078 if [[ "$#*" -eq 0 ]] ; then
2079 [[ -r ~/.zshrc ]] && . ~/.zshrc
2088 compdef _functions reload freload
2090 #f1# List symlinks in detail (more detailed version of 'readlink -f' and 'whence -s')
2092 [[ -z "$1" ]] && printf 'Usage: %s <file(s)>\n' "$0" && return 1
2095 while [[ -h "$file" ]] ; do
2097 file=$(readlink "$file")
2102 # fast manual access
2103 if check_com qma ; then
2104 #f1# View the zsh manual
2105 manzsh() { qma zshall "$1" }
2108 manzsh() { /usr/bin/man zshall | vim -c "se ft=man| se hlsearch" +/"$1" - ; }
2109 # manzsh() { /usr/bin/man zshall | most +/"$1" ; }
2110 # [[ -f ~/.terminfo/m/mostlike ]] && MYLESS='LESS=C TERMINFO=~/.terminfo TERM=mostlike less' || MYLESS='less'
2111 # manzsh() { man zshall | $MYLESS -p $1 ; }
2114 if check_com -c $PAGER ; then
2115 #f1# View Debian's changelog of a given package
2117 if [[ -r /usr/share/doc/${1}/changelog.Debian.gz ]] ; then
2118 $PAGER /usr/share/doc/${1}/changelog.Debian.gz
2119 elif [[ -r /usr/share/doc/${1}/changelog.gz ]] ; then
2120 $PAGER /usr/share/doc/${1}/changelog.gz
2122 if check_com -c aptitude ; then
2123 echo "No changelog for package $1 found, using aptitude to retrieve it."
2125 aptitude -t unstable changelog ${1}
2127 aptitude changelog ${1}
2130 echo "No changelog for package $1 found, sorry."
2135 _dchange() { _files -W /usr/share/doc -/ }
2136 compdef _dchange dchange
2138 #f1# View Debian's NEWS of a given package
2140 if [[ -r /usr/share/doc/${1}/NEWS.Debian.gz ]] ; then
2141 $PAGER /usr/share/doc/${1}/NEWS.Debian.gz
2143 if [[ -r /usr/share/doc/${1}/NEWS.gz ]] ; then
2144 $PAGER /usr/share/doc/${1}/NEWS.gz
2146 echo "No NEWS file for package $1 found, sorry."
2151 _dnews() { _files -W /usr/share/doc -/ }
2152 compdef _dnews dnews
2154 #f1# View upstream's changelog of a given package
2156 if [[ -r /usr/share/doc/${1}/changelog.gz ]] ; then
2157 $PAGER /usr/share/doc/${1}/changelog.gz
2159 echo "No changelog for package $1 found, sorry."
2163 _uchange() { _files -W /usr/share/doc -/ }
2164 compdef _uchange uchange
2169 ZSH_PROFILE_RC=1 $SHELL "$@"
2172 #f1# Edit an alias via zle
2174 [[ -z "$1" ]] && { echo "Usage: edalias <alias_to_edit>" ; return 1 } || vared aliases'[$1]' ;
2176 compdef _aliases edalias
2178 #f1# Edit a function via zle
2180 [[ -z "$1" ]] && { echo "Usage: edfun <function_to_edit>" ; return 1 } || zed -f "$1" ;
2182 compdef _functions edfunc
2184 # use it e.g. via 'Restart apache2'
2185 #m# f6 Start() \kbd{/etc/init.d/\em{process}}\quad\kbd{start}
2186 #m# f6 Restart() \kbd{/etc/init.d/\em{process}}\quad\kbd{restart}
2187 #m# f6 Stop() \kbd{/etc/init.d/\em{process}}\quad\kbd{stop}
2188 #m# f6 Reload() \kbd{/etc/init.d/\em{process}}\quad\kbd{reload}
2189 #m# f6 Force-Reload() \kbd{/etc/init.d/\em{process}}\quad\kbd{force-reload}
2190 if [[ -d /etc/init.d || -d /etc/service ]] ; then
2192 local action_="${1:l}" # e.g Start/Stop/Restart
2196 local service_target_="$(readlink /etc/init.d/$service_)"
2197 if [[ $service_target_ == "/usr/bin/sv" ]]; then
2199 case "${action_}" in
2200 start) if [[ ! -e /etc/service/$service_ ]]; then
2201 $SUDO ln -s "/etc/sv/$service_" "/etc/service/"
2203 $SUDO "/etc/init.d/$service_" "${action_}" "$param_"
2205 # there is no reload in runits sysv emulation
2206 reload) $SUDO "/etc/init.d/$service_" "force-reload" "$param_" ;;
2207 *) $SUDO "/etc/init.d/$service_" "${action_}" "$param_" ;;
2211 $SUDO "/etc/init.d/$service_" "${action_}" "$param_"
2215 for i in Start Restart Stop Force-Reload Reload ; do
2216 eval "$i() { __start_stop $i \"\$1\" \"\$2\" ; }"
2220 #f1# Provides useful information on globbing
2227 p named pipes (FIFOs)
2228 * executable plain files (0100)
2229 % device files (character or block special)
2230 %b block special files
2231 %c character special files
2232 r owner-readable files (0400)
2233 w owner-writable files (0200)
2234 x owner-executable files (0100)
2235 A group-readable files (0040)
2236 I group-writable files (0020)
2237 E group-executable files (0010)
2238 R world-readable files (0004)
2239 W world-writable files (0002)
2240 X world-executable files (0001)
2241 s setuid files (04000)
2242 S setgid files (02000)
2243 t files with the sticky bit (01000)
2245 print *(m-1) # Files modified up to a day ago
2246 print *(a1) # Files accessed a day ago
2247 print *(@) # Just symlinks
2248 print *(Lk+50) # Files bigger than 50 kilobytes
2249 print *(Lk-50) # Files smaller than 50 kilobytes
2250 print **/*.c # All *.c files recursively starting in \$PWD
2251 print **/*.c~file.c # Same as above, but excluding 'file.c'
2252 print (foo|bar).* # Files starting with 'foo' or 'bar'
2253 print *~*.* # All Files that do not contain a dot
2254 chmod 644 *(.^x) # make all plain non-executable files publically readable
2255 print -l *(.c|.h) # Lists *.c and *.h
2256 print **/*(g:users:) # Recursively match all files that are owned by group 'users'
2257 echo /proc/*/cwd(:h:t:s/self//) # Analogous to >ps ax | awk '{print $1}'<"
2259 alias help-zshglob=H-Glob
2261 check_com -c qma && alias ?='qma zshall'
2263 # grep for running process, like: 'any vim'
2265 if [[ -z "$1" ]] ; then
2266 echo "any - grep for process(es) by keyword" >&2
2267 echo "Usage: any <keyword>" >&2 ; return 1
2270 local LENGTH=$(expr length $STRING)
2271 local FIRSCHAR=$(echo $(expr substr $STRING 1 1))
2272 local REST=$(echo $(expr substr $STRING 2 $LENGTH))
2273 ps xauwww| grep "[$FIRSCHAR]$REST"
2277 # After resuming from suspend, system is paging heavily, leading to very bad interactivity.
2278 # taken from $LINUX-KERNELSOURCE/Documentation/power/swsusp.txt
2279 [[ -r /proc/1/maps ]] && \
2281 print 'Reading /proc/[0-9]*/maps and sending output to /dev/null, this might take a while.'
2282 cat $(sed -ne 's:.* /:/:p' /proc/[0-9]*/maps | sort -u | grep -v '^/dev/') > /dev/null
2283 print 'Finished, running "swapoff -a; swapon -a" may also be useful.'
2286 # print hex value of a number
2288 [[ -n "$1" ]] && printf "%x\n" $1 || { print 'Usage: hex <number-to-convert>' ; return 1 }
2291 # calculate (or eval at all ;-)) with perl => p[erl-]eval
2292 # hint: also take a look at zcalc -> 'autoload zcalc' -> 'man zshmodules | less -p MATHFUNC'
2294 [[ -n "$1" ]] && CALC="$*" || print "Usage: calc [expression]"
2295 perl -e "print eval($CALC),\"\n\";"
2297 functions peval &>/dev/null && alias calc=peval
2299 # brltty seems to have problems with utf8 environment and/or font Uni3-Terminus16 under
2300 # certain circumstances, so work around it, no matter which environment we have
2302 if [[ -z "$DISPLAY" ]] ; then
2303 consolechars -f /usr/share/consolefonts/default8x16.psf.gz
2310 # just press 'asdf' keys to toggle between dvorak and us keyboard layout
2312 echo -n 'Switching to us keyboard layout: '
2313 [[ -z "$DISPLAY" ]] && $SUDO loadkeys us &>/dev/null || setxkbmap us &>/dev/null
2317 echo -n 'Switching to dvorak keyboard layout: '
2318 [[ -z "$DISPLAY" ]] && $SUDO loadkeys dvorak &>/dev/null || setxkbmap dvorak &>/dev/null
2321 # just press 'asdf' key to toggle from neon layout to us keyboard layout
2323 echo -n 'Switching to us keyboard layout: '
2324 setxkbmap us && echo 'Done' || echo 'Failed'
2327 # set up an ipv6 tunnel
2331 if ifconfig sit1 2>/dev/null | grep -q 'inet6 addr: 2002:.*:1::1' ; then
2332 print 'ipv6 tunnel already set up, nothing to be done.'
2333 print 'execute: "ifconfig sit1 down ; ifconfig sit0 down" to remove ipv6-tunnel.' ; return 1
2335 [[ -n "$PUBLIC_IP" ]] || \
2336 local PUBLIC_IP=$(ifconfig $(route -n | awk '/^0\.0\.0\.0/{print $8; exit}') | \
2337 awk '/inet addr:/ {print $2}' | tr -d 'addr:')
2339 [[ -n "$PUBLIC_IP" ]] || { print 'No $PUBLIC_IP set and could not determine default one.' ; return 1 }
2340 local IPV6ADDR=$(printf "2002:%02x%02x:%02x%02x:1::1" $(print ${PUBLIC_IP//./ }))
2341 print -n "Setting up ipv6 tunnel $IPV6ADDR via ${PUBLIC_IP}: "
2342 ifconfig sit0 tunnel ::192.88.99.1 up
2343 ifconfig sit1 add "$IPV6ADDR" && print done || print failed
2347 if ifconfig sit1 2>/dev/null | grep -q 'inet6 addr: 2002:.*:1::1' ; then
2348 print 'ipv6 tunnel available' ; return 0
2350 print 'ipv6 tunnel not available' ; return 1
2354 if ifconfig sit1 2>/dev/null | grep -q 'inet6 addr: 2002:.*:1::1' ; then
2355 print -n 'Stopping ipv6 tunnel (sit0 + sit1): '
2356 ifconfig sit1 down ; ifconfig sit0 down && print done || print failed
2358 print 'No ipv6 tunnel found, nothing to be done.' ; return 1
2362 print "Usage: ipv6-tunnel [start|stop|status]">&2 ; return 1
2367 # run dhclient for wireless device
2369 salias dhclient "$(wavemon -d | awk '/device/{print $2}')"
2372 # spawn a minimally set up ksh - useful if you want to umount /usr/.
2374 exec env -i ENV="/etc/minimal-shellrc" HOME="$HOME" TERM="$TERM" ksh
2377 # make a backup of a file
2379 cp -a "$1" "${1}_$(date --iso-8601=seconds)"
2382 # Switching shell safely and efficiently? http://www.zsh.org/mla/workers/2001/msg02410.html
2384 # NO_SWITCH="yes" command bash "$@"
2387 # exec $SHELL $SHELL_ARGS "$@"
2392 # log out? set timeout in seconds {{{
2394 # do not log out in some specific terminals:
2395 # if [[ "${TERM}" == ([Exa]term*|rxvt|dtterm|screen*) ]] ; then
2400 # {{{ make sure our environment is clean regarding colors
2401 for color in BLUE RED GREEN CYAN YELLOW MAGENTA WHITE ; unset $color
2404 # source another config file if present {{{
2405 xsource "/etc/zsh/zshrc.local"
2406 xsource "${HOME}/.zshenv"
2409 # "persistent history" {{{
2410 # just write important commands you always need to ~/.important_commands
2411 if [[ -r ~/.important_commands ]] ; then
2412 fc -R ~/.important_commands
2416 ## genrefcard.pl settings {{{
2417 ### example: split functions-search 8,16,24,32
2418 #@# split functions-search 8
2421 # add variable to be able to check whether the file has been read {{{
2422 ZSHRC_GLOBAL_HAS_BEEN_READ=1
2425 ## END OF FILE #################################################################
2426 # vim:filetype=zsh foldmethod=marker autoindent expandtab shiftwidth=4