1 # Filename: /etc/zsh/zshrc
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 ################################################################################
7 # This file is sourced only for interactive shells. It
8 # should contain commands to set up aliases, functions,
9 # options, key bindings, etc.
11 # Global Order: zshenv, zprofile, zshrc, zlogin
12 ################################################################################
15 # If you want to help to improve grml's zsh setup, clone the grml-etc-core
16 # repository from git.grml.org:
17 # git clone git://git.grml.org/grml-etc-core.git
19 # Make your changes, commit them; use 'git format-patch' to create a series
20 # of patches and send those to the following address via 'git send-email':
21 # grml-etc-core@grml.org
23 # Doing so makes sure the right people get your patches for review and
26 # zsh-refcard-tag documentation: {{{
27 # You may notice strange looking comments in this file.
28 # These are there for a purpose. grml's zsh-refcard can now be
29 # automatically generated from the contents of the actual configuration
30 # file. However, we need a little extra information on which comments
31 # and what lines of code to take into account (and for what purpose).
33 # Here is what they mean:
35 # List of tags (comment types) used:
36 # #a# Next line contains an important alias, that should
37 # be included in the grml-zsh-refcard.
38 # (placement tag: @@INSERT-aliases@@)
39 # #f# Next line contains the beginning of an important function.
40 # (placement tag: @@INSERT-functions@@)
41 # #v# Next line contains an important variable.
42 # (placement tag: @@INSERT-variables@@)
43 # #k# Next line contains an important keybinding.
44 # (placement tag: @@INSERT-keybindings@@)
45 # #d# Hashed directories list generation:
46 # start denotes the start of a list of 'hash -d'
48 # end denotes its end.
49 # (placement tag: @@INSERT-hasheddirs@@)
50 # #A# Abbreviation expansion list generation:
51 # start denotes the beginning of abbreviations.
52 # end denotes their end.
53 # Lines within this section that end in '#d .*' provide
54 # extra documentation to be included in the refcard.
55 # (placement tag: @@INSERT-abbrev@@)
56 # #m# This tag allows you to manually generate refcard entries
57 # for code lines that are hard/impossible to parse.
59 # #m# k ESC-h Call the run-help function
60 # That would add a refcard entry in the keybindings table
61 # for 'ESC-h' with the given comment.
62 # So the syntax is: #m# <section> <argument> <comment>
63 # #o# This tag lets you insert entries to the 'other' hash.
64 # Generally, this should not be used. It is there for
65 # things that cannot be done easily in another way.
66 # (placement tag: @@INSERT-other-foobar@@)
68 # All of these tags (except for m and o) take two arguments, the first
69 # within the tag, the other after the tag:
71 # #<tag><section># <comment>
73 # Where <section> is really just a number, which are defined by the
74 # @secmap array on top of 'genrefcard.pl'. The reason for numbers
75 # instead of names is, that for the reader, the tag should not differ
76 # much from a regular comment. For zsh, it is a regular comment indeed.
77 # The numbers have got the following meanings:
86 # So, the following will add an entry to the 'functions' table in the
87 # 'system' section, with a (hopefully) descriptive comment:
88 # #f1# Edit an alias via zle
91 # It will then show up in the @@INSERT-aliases-system@@ replacement tag
92 # that can be found in 'grml-zsh-refcard.tex.in'.
93 # If the section number is omitted, the 'default' section is assumed.
94 # Furthermore, in 'grml-zsh-refcard.tex.in' @@INSERT-aliases@@ is
95 # exactly the same as @@INSERT-aliases-default@@. If you want a list of
96 # *all* aliases, for example, use @@INSERT-aliases-all@@.
100 # just execute 'ZSH_PROFILE_RC=1 zsh' and run 'zprof' to get the details
101 if [[ $ZSH_PROFILE_RC -gt 0 ]] ; then
106 # load .zshrc.pre to give the user the chance to overwrite the defaults
107 [[ -r ${HOME}/.zshrc.pre ]] && source ${HOME}/.zshrc.pre
109 # {{{ check for version/system
110 # check for versions (compatibility reasons)
112 [[ $ZSH_VERSION == <4->* ]] && return 0
117 [[ $ZSH_VERSION == 4.<1->* || $ZSH_VERSION == <5->* ]] && return 0
122 [[ $ZSH_VERSION == 4.<2->* || $ZSH_VERSION == <5->* ]] && return 0
127 [[ $ZSH_VERSION == 4.2.<5->* || $ZSH_VERSION == 4.<3->* || $ZSH_VERSION == <5->* ]] && return 0
132 [[ $ZSH_VERSION == 4.<3->* || $ZSH_VERSION == <5->* ]] && return 0
137 [[ $ZSH_VERSION == 4.3.<3->* || $ZSH_VERSION == 4.<4->* || $ZSH_VERSION == <5->* ]] && return 0
142 [[ $ZSH_VERSION == 4.3.<9->* || $ZSH_VERSION == 4.<4->* || $ZSH_VERSION == <5->* ]] && return 0
146 #f1# Checks whether or not you're running grml
148 [[ -f /etc/grml_version ]] && return 0
152 #f1# Checks whether or not you're running a grml cd
154 [[ -f /etc/grml_cd ]] && return 0
159 #f1# Checks whether or not you're running grml-small
161 [[ ${${${(f)"$(</etc/grml_version)"}%% *}##*-} == 'small' ]] && return 0 ; return 1
164 isgrmlsmall() { return 1 }
168 [[ $OSTYPE == darwin* ]] && return 0
172 #f1# are we running within an utf environment?
174 case "$LANG $CHARSET $LANGUAGE" in
181 # check for user, if not running as root set $SUDO to sudo
182 (( EUID != 0 )) && SUDO='sudo' || SUDO=''
184 # change directory to home on first invocation of zsh
185 # important for rungetty -> autologin
186 # Thanks go to Bart Schaefer!
187 isgrml && checkhome() {
188 if [[ -z "$ALREADY_DID_CD_HOME" ]] ; then
189 export ALREADY_DID_CD_HOME=$HOME
194 # check for zsh v3.1.7+
196 if ! [[ ${ZSH_VERSION} == 3.1.<7->* \
197 || ${ZSH_VERSION} == 3.<2->.<->* \
198 || ${ZSH_VERSION} == <4->.<->* ]] ; then
201 printf '-!- In this configuration we try to make use of features, that only\n'
202 printf '-!- require version 3.1.7 of the shell; That way this setup can be\n'
203 printf '-!- used with a wide range of zsh versions, while using fairly\n'
204 printf '-!- advanced features in all supported versions.\n'
206 printf '-!- However, you are running zsh version %s.\n' "$ZSH_VERSION"
208 printf '-!- While this *may* work, it might as well fail.\n'
209 printf '-!- Please consider updating to at least version 3.1.7 of zsh.\n'
211 printf '-!- DO NOT EXPECT THIS TO WORK FLAWLESSLY!\n'
212 printf '-!- If it does today, you'\''ve been lucky.\n'
214 printf '-!- Ye been warned!\n'
217 function zstyle() { : }
220 # autoload wrapper - use this one instead of autoload directly
221 # We need to define this function as early as this, because autoloading
222 # 'is-at-least()' needs it.
223 function zrcautoload() {
231 for fdir in ${fpath} ; do
232 [[ -e ${fdir}/${ffile} ]] && (( ffound = 1 ))
235 (( ffound == 0 )) && return 1
236 if [[ $ZSH_VERSION == 3.1.<6-> || $ZSH_VERSION == <4->* ]] ; then
237 autoload -U ${ffile} || return 1
239 autoload ${ffile} || return 1
244 # Load is-at-least() for more precise version checks
245 # Note that this test will *always* fail, if the is-at-least
246 # function could not be marked for autoloading.
247 zrcautoload is-at-least || is-at-least() { return 1 }
251 # {{{ set some important options (as early as possible)
252 # Please update these tags, if you change the umask settings below.
254 #o# r_umaskstr rwxrwxr-x
256 #o# umaskstr rwxr-xr-x
257 (( EUID != 0 )) && umask 002 || umask 022
259 setopt append_history # append history list to the history file (important for multiple parallel zsh sessions!)
260 is4 && setopt SHARE_HISTORY # import new commands from the history file also in other zsh-session
261 setopt extended_history # save each command's beginning timestamp and the duration to the history file
262 is4 && setopt histignorealldups # If a new command line being added to the history
263 # list duplicates an older one, the older command is removed from the list
264 setopt histignorespace # remove command lines from the history list when
265 # the first character on the line is a space
266 setopt auto_cd # if a command is issued that can't be executed as a normal command,
267 # and the command is the name of a directory, perform the cd command to that directory
268 setopt extended_glob # in order to use #, ~ and ^ for filename generation
269 # grep word *~(*.gz|*.bz|*.bz2|*.zip|*.Z) ->
270 # -> searches for word not in compressed files
271 # don't forget to quote '^', '~' and '#'!
272 setopt longlistjobs # display PID when suspending processes as well
273 setopt notify # report the status of backgrounds jobs immediately
274 setopt hash_list_all # Whenever a command completion is attempted, make sure \
275 # the entire command path is hashed first.
276 setopt completeinword # not just at the end
277 setopt nohup # and don't kill them, either
278 setopt auto_pushd # make cd push the old directory onto the directory stack.
279 setopt nonomatch # try to avoid the 'zsh: no matches found...'
280 setopt nobeep # avoid "beep"ing
281 setopt pushd_ignore_dups # don't push the same dir twice.
282 setopt noglobdots # * shouldn't match dotfiles. ever.
283 setopt noshwordsplit # use zsh style word splitting
284 setopt unset # don't error out when unset parameters are used
288 # setting some default values {{{
292 NOPRECMD=${NOPRECMD:-0}
293 COMMAND_NOT_FOUND=${COMMAND_NOT_FOUND:-0}
294 GRML_ZSH_CNF_HANDLER=${GRML_ZSH_CNF_HANDLER:-/usr/share/command-not-found/command-not-found}
295 BATTERY=${BATTERY:-0}
296 GRMLSMALL_SPECIFIC=${GRMLSMALL_SPECIFIC:-1}
297 GRML_ALWAYS_LOAD_ALL=${GRML_ALWAYS_LOAD_ALL:-0}
298 ZSH_NO_DEFAULT_LOCALE=${ZSH_NO_DEFAULT_LOCALE:-0}
302 # utility functions {{{
303 # this function checks if a command exists and returns either true
304 # or false. This avoids using 'which' and 'whence', which will
305 # avoid problems with aliases for which on certain weird systems. :-)
306 # Usage: check_com [-c|-g] word
307 # -c only checks for external commands
308 # -g does the usual tests and also checks for global aliases
311 local -i comonly gatoo
313 if [[ $1 == '-c' ]] ; then
316 elif [[ $1 == '-g' ]] ; then
323 if (( ${#argv} != 1 )) ; then
324 printf 'usage: check_com [-c] <command>\n' >&2
328 if (( comonly > 0 )) ; then
329 [[ -n ${commands[$1]} ]] && return 0
333 if [[ -n ${commands[$1]} ]] \
334 || [[ -n ${functions[$1]} ]] \
335 || [[ -n ${aliases[$1]} ]] \
336 || [[ -n ${reswords[(r)$1]} ]] ; then
341 if (( gatoo > 0 )) && [[ -n ${galiases[$1]} ]] ; then
348 # creates an alias and precedes the command with
349 # sudo if $EUID is not zero.
352 local only=0 ; local multi=0
353 while [[ $1 == -* ]] ; do
357 (--) shift ; break ;;
359 printf 'usage: salias [-h|-o|-a] <alias-expression>\n'
360 printf ' -h shows this help text.\n'
361 printf ' -a replace '\'' ; '\'' sequences with '\'' ; sudo '\''.\n'
362 printf ' be careful using this option.\n'
363 printf ' -o only sets an alias if a preceding sudo would be needed.\n'
366 (*) printf "unkown option: '%s'\n" "$1" ; return 1 ;;
371 if (( ${#argv} > 1 )) ; then
372 printf 'Too many arguments %s\n' "${#argv}"
376 key="${1%%\=*}" ; val="${1#*\=}"
377 if (( EUID == 0 )) && (( only == 0 )); then
378 alias -- "${key}=${val}"
379 elif (( EUID > 0 )) ; then
380 (( multi > 0 )) && val="${val// ; / ; sudo }"
381 alias -- "${key}=sudo ${val}"
387 # a "print -l ${(u)foo}"-workaround for pre-4.2.0 shells
389 # Where foo is the *name* of the parameter you want printed.
390 # Note that foo is no typo; $foo would be wrong here!
398 if [[ -z ${parameter} ]] ; then
399 printf 'usage: uprint <parameter>\n'
403 for w in ${(P)parameter} ; do
404 [[ -z ${(M)u:#$w} ]] && u=( $u $w )
411 # Check if we can read given files and source those we can.
414 if (( ${#argv} < 1 )) ; then
415 printf 'usage: xsource FILE(s)...\n' >&2
419 while (( ${#argv} > 0 )) ; do
420 [[ -r $1 ]] && source $1
426 # Check if we can read a given file and 'cat(1)' it.
429 if (( ${#argv} != 1 )) ; then
430 printf 'usage: xcat FILE\n' >&2
434 [[ -r $1 ]] && cat $1
438 # Remove these functions again, they are of use only in these
439 # setup files. This should be called at the end of .zshrc.
443 funcs=(salias xcat xsource xunfunction zrcautoload)
445 for func in $funcs ; do
446 [[ -n ${functions[$func]} ]] \
452 # this allows us to stay in sync with grml's zshrc and put own
453 # modifications in ~/.zshrc.local
455 xsource "/etc/zsh/zshrc.local"
456 xsource "${HOME}/.zshrc.local"
463 if (( ZSH_NO_DEFAULT_LOCALE == 0 )); then
464 xsource "/etc/default/locale"
467 for var in LANG LC_ALL LC_MESSAGES ; do
468 [[ -n ${(P)var} ]] && export $var
471 xsource "/etc/sysconfig/keyboard"
473 TZ=$(xcat /etc/timezone)
476 # {{{ set some variables
477 if check_com -c vim ; then
479 export EDITOR=${EDITOR:-vim}
481 export EDITOR=${EDITOR:-vi}
485 export PAGER=${PAGER:-less}
488 export MAIL=${MAIL:-/var/mail/$USER}
490 # if we don't set $SHELL then aterm, rxvt,.. will use /bin/sh or /bin/bash :-/
491 export SHELL='/bin/zsh'
493 # color setup for ls:
494 check_com -c dircolors && eval $(dircolors -b)
495 # color setup for ls on OS X:
496 isdarwin && export CLICOLOR=1
498 # do MacPorts setup on darwin
499 if isdarwin && [[ -d /opt/local ]]; then
500 # Note: PATH gets set in /etc/zprofile on Darwin, so this can't go into
502 PATH="/opt/local/bin:/opt/local/sbin:$PATH"
503 MANPATH="/opt/local/share/man:$MANPATH"
505 # do Fink setup on darwin
506 isdarwin && xsource /sw/bin/init.sh
508 # load our function and completion directories
509 for fdir in /usr/share/grml/zsh/completion /usr/share/grml/functions; do
510 fpath=( ${fdir} ${fdir}/**/*(/N) ${fpath} )
511 if [[ ${fpath} == '/usr/share/grml/zsh/functions' ]] ; then
512 for func in ${fdir}/**/[^_]*[^~](N.) ; do
513 zrcautoload ${func:t}
519 # support colors in less
520 export LESS_TERMCAP_mb=$'\E[01;31m'
521 export LESS_TERMCAP_md=$'\E[01;31m'
522 export LESS_TERMCAP_me=$'\E[0m'
523 export LESS_TERMCAP_se=$'\E[0m'
524 export LESS_TERMCAP_so=$'\E[01;44;33m'
525 export LESS_TERMCAP_ue=$'\E[0m'
526 export LESS_TERMCAP_us=$'\E[01;32m'
528 MAILCHECK=30 # mailchecks
529 REPORTTIME=5 # report about cpu-/system-/user-time of command if running longer than 5 seconds
530 watch=(notme root) # watch for everyone but me and root
532 # automatically remove duplicates from these arrays
533 typeset -U path cdpath fpath manpath
537 if [[ "$TERM" != emacs ]] ; then
538 [[ -z "$terminfo[kdch1]" ]] || bindkey -M emacs "$terminfo[kdch1]" delete-char
539 [[ -z "$terminfo[khome]" ]] || bindkey -M emacs "$terminfo[khome]" beginning-of-line
540 [[ -z "$terminfo[kend]" ]] || bindkey -M emacs "$terminfo[kend]" end-of-line
541 [[ -z "$terminfo[kdch1]" ]] || bindkey -M vicmd "$terminfo[kdch1]" vi-delete-char
542 [[ -z "$terminfo[khome]" ]] || bindkey -M vicmd "$terminfo[khome]" vi-beginning-of-line
543 [[ -z "$terminfo[kend]" ]] || bindkey -M vicmd "$terminfo[kend]" vi-end-of-line
544 [[ -z "$terminfo[cuu1]" ]] || bindkey -M viins "$terminfo[cuu1]" vi-up-line-or-history
545 [[ -z "$terminfo[cuf1]" ]] || bindkey -M viins "$terminfo[cuf1]" vi-forward-char
546 [[ -z "$terminfo[kcuu1]" ]] || bindkey -M viins "$terminfo[kcuu1]" vi-up-line-or-history
547 [[ -z "$terminfo[kcud1]" ]] || bindkey -M viins "$terminfo[kcud1]" vi-down-line-or-history
548 [[ -z "$terminfo[kcuf1]" ]] || bindkey -M viins "$terminfo[kcuf1]" vi-forward-char
549 [[ -z "$terminfo[kcub1]" ]] || bindkey -M viins "$terminfo[kcub1]" vi-backward-char
551 [[ "$terminfo[kcuu1]" == $'\eO'* ]] && bindkey -M viins "${terminfo[kcuu1]/O/[}" vi-up-line-or-history
552 [[ "$terminfo[kcud1]" == $'\eO'* ]] && bindkey -M viins "${terminfo[kcud1]/O/[}" vi-down-line-or-history
553 [[ "$terminfo[kcuf1]" == $'\eO'* ]] && bindkey -M viins "${terminfo[kcuf1]/O/[}" vi-forward-char
554 [[ "$terminfo[kcub1]" == $'\eO'* ]] && bindkey -M viins "${terminfo[kcub1]/O/[}" vi-backward-char
555 [[ "$terminfo[khome]" == $'\eO'* ]] && bindkey -M viins "${terminfo[khome]/O/[}" beginning-of-line
556 [[ "$terminfo[kend]" == $'\eO'* ]] && bindkey -M viins "${terminfo[kend]/O/[}" end-of-line
557 [[ "$terminfo[khome]" == $'\eO'* ]] && bindkey -M emacs "${terminfo[khome]/O/[}" beginning-of-line
558 [[ "$terminfo[kend]" == $'\eO'* ]] && bindkey -M emacs "${terminfo[kend]/O/[}" end-of-line
561 ## keybindings (run 'bindkeys' for details, more details via man zshzle)
562 # use emacs style per default:
567 #if [[ "$TERM" == screen ]] ; then
568 bindkey '\e[1~' beginning-of-line # home
569 bindkey '\e[4~' end-of-line # end
570 bindkey '\e[A' up-line-or-search # cursor up
571 bindkey '\e[B' down-line-or-search # <ESC>-
573 bindkey '^xp' history-beginning-search-backward
574 bindkey '^xP' history-beginning-search-forward
575 # bindkey -s '^L' "|less\n" # ctrl-L pipes to less
576 # bindkey -s '^B' " &\n" # ctrl-B runs it in the background
577 # if terminal type is set to 'rxvt':
578 bindkey '\e[7~' beginning-of-line # home
579 bindkey '\e[8~' end-of-line # end
582 # insert unicode character
583 # usage example: 'ctrl-x i' 00A7 'ctrl-x i' will give you an §
584 # See for example http://unicode.org/charts/ for unicode characters code
585 zrcautoload insert-unicode-char
586 zle -N insert-unicode-char
587 #k# Insert Unicode character
588 bindkey '^Xi' insert-unicode-char
590 ## toggle the ,. abbreviation feature on/off
591 # NOABBREVIATION: default abbreviation-state
592 # 0 - enabled (default)
594 NOABBREVIATION=${NOABBREVIATION:-0}
596 grml_toggle_abbrev() {
597 if (( ${NOABBREVIATION} > 0 )) ; then
604 zle -N grml_toggle_abbrev
605 bindkey '^xA' grml_toggle_abbrev
607 # add a command line to the shells history without executing it
608 commit-to-history() {
609 print -s ${(z)BUFFER}
612 zle -N commit-to-history
613 bindkey "^x^h" commit-to-history
615 # only slash should be considered as a word separator:
616 slash-backward-kill-word() {
617 local WORDCHARS="${WORDCHARS:s@/@}"
619 zle backward-kill-word
621 zle -N slash-backward-kill-word
623 #k# Kill everything in a word up to its last \kbd{/}
624 bindkey '\ev' slash-backward-kill-word
626 # use the new *-pattern-* widgets for incremental history search
628 bindkey '^r' history-incremental-pattern-search-backward
629 bindkey '^s' history-incremental-pattern-search-forward
633 # a generic accept-line wrapper {{{
635 # This widget can prevent unwanted autocorrections from command-name
636 # to _command-name, rehash automatically on enter and call any number
637 # of builtin and user-defined widgets in different contexts.
639 # For a broader description, see:
640 # <http://bewatermyfriend.org/posts/2007/12-26.11-50-38-tooltime.html>
642 # The code is imported from the file 'zsh/functions/accept-line' from
643 # <http://ft.bewatermyfriend.org/comp/zsh/zsh-dotfiles.tar.bz2>, which
644 # distributed under the same terms as zsh itself.
646 # A newly added command will may not be found or will cause false
647 # correction attempts, if you got auto-correction set. By setting the
648 # following style, we force accept-line() to rehash, if it cannot
649 # find the first word on the command line in the $command[] hash.
650 zstyle ':acceptline:*' rehash true
652 function Accept-Line() {
658 zstyle -a ":acceptline:${alcontext}" actions subs
660 (( ${#subs} < 1 )) && return 0
663 for sub in ${subs} ; do
664 [[ ${sub} == 'accept-line' ]] && sub='.accept-line'
667 (( aldone > 0 )) && break
671 function Accept-Line-getdefault() {
675 zstyle -s ":acceptline:${alcontext}" default_action default_action
676 case ${default_action} in
678 printf ".accept-line"
681 printf ${default_action}
686 function accept-line() {
690 local buf com fname format msg default_action
694 cmdline=(${(z)BUFFER})
698 zstyle -t ":acceptline:${alcontext}" rehash \
699 && [[ -z ${commands[$com]} ]] \
702 if [[ -n ${reswords[(r)$com]} ]] \
703 || [[ -n ${aliases[$com]} ]] \
704 || [[ -n ${functions[$com]} ]] \
705 || [[ -n ${builtins[$com]} ]] \
706 || [[ -n ${commands[$com]} ]] ; then
708 # there is something sensible to execute, just do it.
712 default_action=$(Accept-Line-getdefault)
713 zstyle -T ":acceptline:${alcontext}" call_default \
714 && zle ${default_action}
718 if [[ -o correct ]] \
719 || [[ -o correctall ]] \
720 && [[ -n ${functions[$fname]} ]] ; then
722 # nothing there to execute but there is a function called
723 # _command_name; a completion widget. Makes no sense to
724 # call it on the commandline, but the correct{,all} options
725 # will ask for it nevertheless, so warn the user.
726 if [[ ${LASTWIDGET} == 'accept-line' ]] ; then
727 # Okay, we warned the user before, he called us again,
728 # so have it his way.
732 default_action=$(Accept-Line-getdefault)
733 zstyle -T ":acceptline:${alcontext}" call_default \
734 && zle ${default_action}
738 # prepare warning message for the user, configurable via zstyle.
739 zstyle -s ":acceptline:${alcontext}" compwarnfmt msg
741 if [[ -z ${msg} ]] ; then
742 msg="%c will not execute and completion %f exists."
745 zformat -f msg "${msg}" "c:${com}" "f:${fname}"
749 elif [[ -n ${buf//[$' \t\n']##/} ]] ; then
750 # If we are here, the commandline contains something that is not
751 # executable, which is neither subject to _command_name correction
752 # and is not empty. might be a variable assignment
756 default_action=$(Accept-Line-getdefault)
757 zstyle -T ":acceptline:${alcontext}" call_default \
758 && zle ${default_action}
762 # If we got this far, the commandline only contains whitespace, or is empty.
766 default_action=$(Accept-Line-getdefault)
767 zstyle -T ":acceptline:${alcontext}" call_default \
768 && zle ${default_action}
776 # power completion - abbreviation expansion {{{
777 # power completion / abbreviation expansion / buffer expansion
778 # see http://zshwiki.org/home/examples/zleiab for details
779 # less risky than the global aliases but powerful as well
780 # just type the abbreviation key and afterwards ',.' to expand it
783 setopt interactivecomments
785 # key # value (#d additional doc string)
791 'G' '|& grep --color=auto '
793 'Hl' ' --help |& less -r' #d (Display help in pager)
797 'N' '&>/dev/null' #d (No Output)
798 'R' '| tr A-z N-za-m' #d (ROT13)
804 'co' './configure && make && sudo make install'
812 if (( NOABBREVIATION > 0 )) ; then
813 LBUFFER="${LBUFFER},."
817 matched_chars='[.-|_a-zA-Z0-9]#'
818 LBUFFER=${LBUFFER%%(#m)[.-|_a-zA-Z0-9]#}
819 LBUFFER+=${abk[$MATCH]:-$MATCH}
823 bindkey ",." globalias
827 zrcautoload zmv # who needs mmv or rename?
828 zrcautoload history-search-end
830 # we don't want to quote/espace URLs on our own...
831 # if autoload -U url-quote-magic ; then
832 # zle -N self-insert url-quote-magic
833 # zstyle ':url-quote-magic:*' url-metas '*?[]^()~#{}='
835 # print 'Notice: no url-quote-magic available :('
837 alias url-quote='autoload -U url-quote-magic ; zle -N self-insert url-quote-magic'
839 #m# k ESC-h Call \kbd{run-help} for the 1st word on the command line
840 alias run-help >&/dev/null && unalias run-help
841 for rh in run-help{,-git,-svk,-svn}; do
846 if zrcautoload compinit ; then
847 compinit || print 'Notice: no compinit available :('
849 print 'Notice: no compinit available :('
854 is4 && zrcautoload zed # use ZLE editor to edit a file or function
857 for mod in complist deltochar mathfunc ; do
858 zmodload -i zsh/${mod} 2>/dev/null || print "Notice: no ${mod} available :("
861 # autoload zsh modules when they are referenced
869 while (( ${#tmpargs} > 0 )) ; do
870 zmodload -${tmpargs[1]} zsh/${tmpargs[2]} ${tmpargs[2]}
876 if is4 && zrcautoload insert-files && zle -N insert-files ; then
878 bindkey "^Xf" insert-files # C-x-f
881 bindkey ' ' magic-space # also do history expansion on space
882 #k# Trigger menu-complete
883 bindkey '\ei' menu-complete # menu completion via esc-i
885 # press esc-e for editing command line in $EDITOR or $VISUAL
886 if is4 && zrcautoload edit-command-line && zle -N edit-command-line ; then
887 #k# Edit the current line in \kbd{\$EDITOR}
888 bindkey '\ee' edit-command-line
891 if is4 && [[ -n ${(k)modules[zsh/complist]} ]] ; then
892 #k# menu selection: pick item but stay in the menu
893 bindkey -M menuselect '\e^M' accept-and-menu-complete
895 # accept a completion and try to complete again by using menu
896 # completion; very useful with completing directories
897 # by using 'undo' one's got a simple file browser
898 bindkey -M menuselect '^o' accept-and-infer-next-history
901 # press "ctrl-e d" to insert the actual date in the form yyyy-mm-dd
902 _bkdate() { BUFFER="$BUFFER$(date '+%F')"; CURSOR=$#BUFFER; }
905 #k# Insert a timestamp on the command line (yyyy-mm-dd)
906 bindkey '^Ed' _bkdate
908 # press esc-m for inserting last typed word again (thanks to caphuso!)
909 insert-last-typed-word() { zle insert-last-word -- 0 -1 };
910 zle -N insert-last-typed-word;
912 #k# Insert last typed word
913 bindkey "\em" insert-last-typed-word
915 #k# Shortcut for \kbd{fg<enter>}
916 bindkey -s '^z' "fg\n"
918 # run command line as user root via sudo:
919 sudo-command-line() {
920 [[ -z $BUFFER ]] && zle up-history
921 [[ $BUFFER != sudo\ * ]] && BUFFER="sudo $BUFFER"
923 zle -N sudo-command-line
925 #k# Put the current command line into a \kbd{sudo} call
926 bindkey "^Os" sudo-command-line
928 ### jump behind the first word on the cmdline.
929 ### useful to add options.
930 function jump_after_first_word() {
934 if (( ${#words} <= 1 )) ; then
937 CURSOR=${#${words[1]}}
940 zle -N jump_after_first_word
942 bindkey '^x1' jump_after_first_word
951 HISTFILE=$HOME/.zsh_history
952 isgrmlcd && HISTSIZE=500 || HISTSIZE=5000
953 isgrmlcd && SAVEHIST=1000 || SAVEHIST=10000 # useful for setopt append_history
957 # dirstack handling {{{
959 DIRSTACKSIZE=${DIRSTACKSIZE:-20}
960 DIRSTACKFILE=${DIRSTACKFILE:-${HOME}/.zdirs}
962 if [[ -f ${DIRSTACKFILE} ]] && [[ ${#dirstack[*]} -eq 0 ]] ; then
963 dirstack=( ${(f)"$(< $DIRSTACKFILE)"} )
964 # "cd -" won't work after login by just setting $OLDPWD, so
965 [[ -d $dirstack[0] ]] && cd $dirstack[0] && cd $OLDPWD
970 my_stack=( ${PWD} ${dirstack} )
972 builtin print -l ${(u)my_stack} >! ${DIRSTACKFILE}
974 uprint my_stack >! ${DIRSTACKFILE}
980 # directory based profiles {{{
984 CHPWD_PROFILE='default'
985 function chpwd_profiles() {
986 # Say you want certain settings to be active in certain directories.
987 # This is what you want.
989 # zstyle ':chpwd:profiles:/usr/src/grml(|/|/*)' profile grml
990 # zstyle ':chpwd:profiles:/usr/src/debian(|/|/*)' profile debian
992 # When that's done and you enter a directory that matches the pattern
993 # in the third part of the context, a function called chpwd_profile_grml,
994 # for example, is called (if it exists).
996 # If no pattern matches (read: no profile is detected) the profile is
997 # set to 'default', which means chpwd_profile_default is attempted to
1000 # A word about the context (the ':chpwd:profiles:*' stuff in the zstyle
1001 # command) which is used: The third part in the context is matched against
1002 # ${PWD}. That's why using a pattern such as /foo/bar(|/|/*) makes sense.
1003 # Because that way the profile is detected for all these values of ${PWD}:
1007 # So, if you want to make double damn sure a profile works in /foo/bar
1008 # and everywhere deeper in that tree, just use (|/|/*) and be happy.
1010 # The name of the detected profile will be available in a variable called
1011 # 'profile' in your functions. You don't need to do anything, it'll just
1014 # Then there is the parameter $CHPWD_PROFILE is set to the profile, that
1015 # was is currently active. That way you can avoid running code for a
1016 # profile that is already active, by running code such as the following
1017 # at the start of your function:
1019 # function chpwd_profile_grml() {
1020 # [[ ${profile} == ${CHPWD_PROFILE} ]] && return 1
1024 # The initial value for $CHPWD_PROFILE is 'default'.
1026 # Version requirement:
1027 # This feature requires zsh 4.3.3 or newer.
1028 # If you use this feature and need to know whether it is active in your
1029 # current shell, there are several ways to do that. Here are two simple
1032 # a) If knowing if the profiles feature is active when zsh starts is
1033 # good enough for you, you can put the following snippet into your
1036 # (( ${+functions[chpwd_profiles]} )) && print "directory profiles active"
1038 # b) If that is not good enough, and you would prefer to be notified
1039 # whenever a profile changes, you can solve that by making sure you
1040 # start *every* profile function you create like this:
1042 # function chpwd_profile_myprofilename() {
1043 # [[ ${profile} == ${CHPWD_PROFILE} ]] && return 1
1044 # print "chpwd(): Switching to profile: $profile"
1048 # That makes sure you only get notified if a profile is *changed*,
1049 # not everytime you change directory, which would probably piss
1050 # you off fairly quickly. :-)
1052 # There you go. Now have fun with that.
1055 zstyle -s ":chpwd:profiles:${PWD}" profile profile || profile='default'
1056 if (( ${+functions[chpwd_profile_$profile]} )) ; then
1057 chpwd_profile_${profile}
1060 CHPWD_PROFILE="${profile}"
1063 chpwd_functions=( ${chpwd_functions} chpwd_profiles )
1069 # {{{ display battery status on right side of prompt via running 'BATTERY=1 zsh'
1070 if [[ $BATTERY -gt 0 ]] ; then
1071 if ! check_com -c acpi ; then
1077 if [[ $BATTERY -gt 0 ]] ; then
1078 PERCENT="${${"$(acpi 2>/dev/null)"}/(#b)[[:space:]]#Battery <->: [^0-9]##, (<->)%*/${match[1]}}"
1079 if [[ -z "$PERCENT" ]] ; then
1080 PERCENT='acpi not present'
1082 if [[ "$PERCENT" -lt 20 ]] ; then
1083 PERCENT="warning: ${PERCENT}%%"
1085 PERCENT="${PERCENT}%%"
1092 # set colors for use in prompts {{{
1093 if zrcautoload colors && colors 2>/dev/null ; then
1094 BLUE="%{${fg[blue]}%}"
1095 RED="%{${fg_bold[red]}%}"
1096 GREEN="%{${fg[green]}%}"
1097 CYAN="%{${fg[cyan]}%}"
1098 MAGENTA="%{${fg[magenta]}%}"
1099 YELLOW="%{${fg[yellow]}%}"
1100 WHITE="%{${fg[white]}%}"
1101 NO_COLOUR="%{${reset_color}%}"
1103 BLUE=$'%{\e[1;34m%}'
1105 GREEN=$'%{\e[1;32m%}'
1106 CYAN=$'%{\e[1;36m%}'
1107 WHITE=$'%{\e[1;37m%}'
1108 MAGENTA=$'%{\e[1;35m%}'
1109 YELLOW=$'%{\e[1;33m%}'
1110 NO_COLOUR=$'%{\e[0m%}'
1115 # gather version control information for inclusion in a prompt {{{
1118 # Be quiet about version problems in grml's zshrc as the user cannot disable
1119 # loading vcs_info() as it is *in* the zshrc - as you can see. :-)
1120 # Just unset most probable variables and disable vcs_info altogether.
1122 for i in {0..9} ; do
1123 unset VCS_INFO_message_${i}_
1125 zstyle ':vcs_info:*' enable false
1128 # The following code is imported from the file 'zsh/functions/vcs_info'
1129 # from <http://ft.bewatermyfriend.org/comp/zsh/zsh-dotfiles.tar.bz2>,
1130 # which distributed under the same terms as zsh itself.
1132 # we will be using two variables, so let the code know now.
1133 zstyle ':vcs_info:*' max-exports 2
1135 # vcs_info() documentation:
1139 # This functionality requires zsh version >= 4.1.*.
1144 # To load vcs_info(), copy this file to your $fpath[] and do:
1145 # % autoload -Uz vcs_info && vcs_info
1147 # To work, vcs_info() needs 'setopt prompt_subst' in your setup.
1152 # To get vcs_info() working quickly (including colors), you can do the
1153 # following (assuming, you loaded vcs_info() properly - see above):
1155 # % RED=$'%{\e[31m%}'
1156 # % GR=$'%{\e[32m%}'
1157 # % MA=$'%{\e[35m%}'
1158 # % YE=$'%{\e[33m%}'
1161 # % zstyle ':vcs_info:*' actionformats \
1162 # "${MA}(${NC}%s${MA})${YE}-${MA}[${GR}%b${YE}|${RED}%a${MA}]${NC} "
1164 # % zstyle ':vcs_info:*' formats \
1165 # "${MA}(${NC}%s${MA})${Y}-${MA}[${GR}%b${MA}]${NC}%} "
1167 # % zstyle ':vcs_info:(sv[nk]|bzr):*' branchformat "%b${RED}:${YE}%r"
1169 # % precmd () { vcs_info }
1170 # % PS1='${MA}[${GR}%n${MA}] ${MA}(${RED}%!${MA}) ${YE}%3~ ${VCS_INFO_message_0_}${NC}%# '
1172 # Obviously, the las two lines are there for demonstration: You need to
1173 # call vcs_info() from your precmd() function (see 'SPECIAL FUNCTIONS' in
1174 # 'man zshmisc'). Once that is done you need a *single* quoted
1175 # '${VCS_INFO_message_0_}' in your prompt.
1177 # Now call the 'vcs_info_printsys' utility from the command line:
1179 # % vcs_info_printsys
1180 # # list of supported version control backends:
1181 # # disabled systems are prefixed by a hash sign (#)
1192 # # flavours (cannot be used in the disable style; they
1193 # # are disabled with their master [git-svn -> git]):
1197 # Ten version control backends as you can see. You may not want all
1198 # of these. Because there is no point in running the code to detect
1199 # systems you do not use. ever. So, there is a way to disable some
1200 # backends altogether:
1202 # % zstyle ':vcs_info:*' disable bzr cdv darcs mtn svk tla
1204 # If you rerun 'vcs_info_printsys' now, you will see the backends listed
1205 # in the 'disable' style marked as diabled by a hash sign. That means the
1206 # detection of these systems is skipped *completely*. No wasted time there.
1208 # For more control, read the reference below.
1213 # The vcs_info() feature can be configured via zstyle.
1215 # First, the context in which we are working:
1216 # :vcs_info:<vcs-string>:<user-context>
1218 # ...where <vcs-string> is one of:
1219 # - git, git-svn, git-p4, hg, darcs, bzr, cdv, mtn, svn, cvs, svk or tla.
1221 # ...and <user-context> is a freely configurable string, assignable by the
1222 # user as the first argument to vcs_info() (see its description below).
1224 # There is are three special values for <vcs-string>: The first is named
1225 # 'init', that is in effect as long as there was no decision what vcs
1226 # backend to use. The second is 'preinit; it is used *before* vcs_info()
1227 # is run, when initializing the data exporting variables. The third
1228 # special value is 'formats' and is used by the 'vcs_info_lastmsg' for
1229 # looking up its styles.
1231 # There are two pre-defined values for <user-context>:
1232 # default - the one used if none is specified
1233 # command - used by vcs_info_lastmsg to lookup its styles.
1235 # You may *not* use 'print_systems_' as a user-context string, because it
1236 # is used internally.
1238 # You can of course use ':vcs_info:*' to match all VCSs in all
1239 # user-contexts at once.
1241 # Another special context is 'formats', which is used by the
1242 # vcs_info_lastmsg() utility function (see below).
1245 # This is a description of all styles, that are looked up:
1246 # formats - A list of formats, used when actionformats is not
1247 # used (which is most of the time).
1248 # actionformats - A list of formats, used if a there is a special
1249 # action going on in your current repository;
1250 # (like an interactive rebase or a merge conflict)
1251 # branchformat - Some backends replace %b in the formats and
1252 # actionformats styles above, not only by a branch
1253 # name but also by a revision number. This style
1254 # let's you modify how that string should look like.
1255 # nvcsformats - These "formats" are exported, when we didn't detect
1256 # a version control system for the current directory.
1257 # This is useful, if you want vcs_info() to completely
1258 # take over the generation of your prompt.
1259 # You would do something like
1260 # PS1='${VCS_INFO_message_0_}'
1261 # to accomplish that.
1262 # max-exports - Defines the maximum number if VCS_INFO_message_*_
1263 # variables vcs_info() will export.
1264 # enable - Checked in the 'init' context. If set to false,
1265 # vcs_info() will do nothing.
1266 # disable - Provide a list of systems, you don't want
1267 # the vcs_info() to check for repositories
1268 # (checked in the 'init' context, too).
1269 # disable-patterns - A list of patterns that are checked against $PWD.
1270 # If the pattern matches, vcs_info will be disabled.
1271 # Say, ~/.zsh is a directory under version control,
1272 # in which you do not want vcs_info to be active, do:
1273 # zstyle ':vcs_info:*' disable-patterns "$HOME/.zsh+(|/*)"
1274 # use-simple - If there are two different ways of gathering
1275 # information, you can select the simpler one
1276 # by setting this style to true; the default
1277 # is to use the not-that-simple code, which is
1278 # potentially a lot slower but might be more
1279 # accurate in all possible cases.
1280 # use-prompt-escapes - determines if we assume that the assembled
1281 # string from vcs_info() includes prompt escapes.
1282 # (Used by vcs_info_lastmsg().
1284 # The use-simple style is only available for the bzr backend.
1286 # The default values for these in all contexts are:
1287 # formats " (%s)-[%b|%a]-"
1288 # actionformats " (%s)-[%b]-"
1289 # branchformat "%b:%r" (for bzr, svn and svk)
1293 # disable (empty list)
1294 # disable-patterns (empty list)
1296 # use-prompt-escapes true
1299 # In normal formats and actionformats, the following replacements
1301 # %s - The vcs in use (git, hg, svn etc.)
1302 # %b - Information about the current branch.
1303 # %a - An identifier, that describes the action.
1304 # Only makes sense in actionformats.
1305 # %R - base directory of the repository.
1306 # %r - repository name
1307 # If %R is '/foo/bar/repoXY', %r is 'repoXY'.
1308 # %S - subdirectory within a repository. if $PWD is
1309 # '/foo/bar/reposXY/beer/tasty', %S is 'beer/tasty'.
1312 # In branchformat these replacements are done:
1313 # %b - the branch name
1314 # %r - the current revision number
1316 # Not all vcs backends have to support all replacements.
1317 # nvcsformat does not perform *any* replacements. It is just a string.
1322 # If you want to use the %b (bold off) prompt expansion in 'formats', which
1323 # expands %b itself, use %%b. That will cause the vcs_info() expansion to
1324 # replace %%b with %b. So zsh's prompt expansion mechanism can handle it.
1325 # Similarly, to hand down %b from branchformat, use %%%%b. Sorry for this
1326 # inconvenience, but it cannot be easily avoided. Luckily we do not clash
1327 # with a lot of prompt expansions and this only needs to be done for those.
1328 # See 'man zshmisc' for details about EXPANSION OF PROMPT SEQUENCES.
1331 # FUNCTION DESCRIPTIONS (public API):
1334 # The main function, that runs all backends and assembles
1335 # all data into ${VCS_INFO_message_*_}. This is the function
1336 # you want to call from precmd() if you want to include
1337 # up-to-date information in your prompt (see VARIABLE
1338 # DESCRIPTION below).
1340 # vcs_info_printsys()
1341 # Prints a list of all supported version control systems.
1342 # Useful to find out possible contexts (and which of them are enabled)
1343 # or values for the 'disable' style.
1345 # vcs_info_lastmsg()
1346 # Outputs the last ${VCS_INFO_message_*_} value. Takes into account
1347 # the value of the use-prompt-escapes style in ':vcs_info:formats'.
1348 # It also only prints max-exports values.
1350 # All functions named VCS_INFO_* are for internal use only.
1353 # VARIABLE DESCRIPTION:
1355 # ${VCS_INFO_message_N_} (Note the trailing underscore)
1356 # Where 'N' is an integer, eg: VCS_INFO_message_0_
1357 # These variables are the storage for the informational message the
1358 # last vcs_info() call has assembled. These are strongly connected
1359 # to the formats, actionformats and nvcsformats styles described
1360 # above. Those styles are lists. the first member of that list gets
1361 # expanded into ${VCS_INFO_message_0_}, the second into
1362 # ${VCS_INFO_message_1_} and the Nth into ${VCS_INFO_message_N-1_}.
1363 # These parameters are exported into the environment.
1364 # (See the max-exports style above.)
1369 # Don't use vcs_info at all (even though it's in your prompt):
1370 # % zstyle ':vcs_info:*' enable false
1372 # Disable the backends for bzr and svk:
1373 # % zstyle ':vcs_info:*' disable bzr svk
1375 # Provide a special formats for git:
1376 # % zstyle ':vcs_info:git:*' formats ' GIT, BABY! [%b]'
1377 # % zstyle ':vcs_info:git:*' actionformats ' GIT ACTION! [%b|%a]'
1379 # Use the quicker bzr backend (if you do, please report if it does
1380 # the-right-thing[tm] - thanks):
1381 # % zstyle ':vcs_info:bzr:*' use-simple true
1383 # Display the revision number in yellow for bzr and svn:
1384 # % zstyle ':vcs_info:(svn|bzr):*' branchformat '%b%{'${fg[yellow]}'%}:%r'
1386 # If you want colors, make sure you enclose the color codes in %{...%},
1387 # if you want to use the string provided by vcs_info() in prompts.
1389 # Here is how to print the vcs infomation as a command:
1390 # % alias vcsi='vcs_info command; vcs_info_lastmsg'
1392 # This way, you can even define different formats for output via
1393 # vcs_info_lastmsg() in the ':vcs_info:command:*' namespace.
1397 VCS_INFO_adjust () { #{{{
1398 [[ -n ${vcs_comm[overwrite_name]} ]] && vcs=${vcs_comm[overwrite_name]}
1402 VCS_INFO_check_com () { #{{{
1403 (( ${+commands[$1]} )) && [[ -x ${commands[$1]} ]] && return 0
1407 VCS_INFO_formats () { # {{{
1408 setopt localoptions noksharrays
1409 local action=$1 branch=$2 base=$3
1413 if [[ -n ${action} ]] ; then
1414 zstyle -a ":vcs_info:${vcs}:${usercontext}" actionformats msgs
1415 (( ${#msgs} < 1 )) && msgs[1]=' (%s)-[%b|%a]-'
1417 zstyle -a ":vcs_info:${vcs}:${usercontext}" formats msgs
1418 (( ${#msgs} < 1 )) && msgs[1]=' (%s)-[%b]-'
1421 (( ${#msgs} > maxexports )) && msgs[$(( maxexports + 1 )),-1]=()
1422 for i in {1..${#msgs}} ; do
1423 zformat -f msg ${msgs[$i]} \
1429 S:"$(VCS_INFO_reposub ${base})"
1435 VCS_INFO_maxexports () { #{{{
1436 zstyle -s ":vcs_info:${vcs}:${usercontext}" "max-exports" maxexports || maxexports=2
1437 if [[ ${maxexports} != <-> ]] || (( maxexports < 1 )); then
1438 printf 'vcs_info(): expecting numeric arg >= 1 for max-exports (got %s).\n' ${maxexports}
1439 printf 'Defaulting to 2.\n'
1444 VCS_INFO_nvcsformats () { #{{{
1445 setopt localoptions noksharrays
1448 if [[ $1 == 'preinit' ]] ; then
1452 zstyle -a ":vcs_info:${v:-$vcs}:${c:-$usercontext}" nvcsformats msgs
1453 (( ${#msgs} > maxexports )) && msgs[${maxexports},-1]=()
1456 VCS_INFO_realpath () { #{{{
1457 # a portable 'readlink -f'
1458 # forcing a subshell, to ensure chpwd() is not removed
1459 # from the calling shell (if VCS_INFO_realpath() is called
1462 (( ${+functions[chpwd]} )) && unfunction chpwd
1464 cd $1 2>/dev/null && pwd
1468 VCS_INFO_reposub () { #{{{
1469 setopt localoptions extendedglob
1470 local base=${1%%/##}
1472 [[ ${PWD} == ${base}/* ]] || {
1476 printf '%s' ${PWD#$base/}
1480 VCS_INFO_set () { #{{{
1481 setopt localoptions noksharrays
1484 if [[ $1 == '--clear' ]] ; then
1485 for i in {0..9} ; do
1486 unset VCS_INFO_message_${i}_
1489 if [[ $1 == '--nvcs' ]] ; then
1490 [[ $2 == 'preinit' ]] && (( maxexports == 0 )) && (( maxexports = 1 ))
1491 for i in {0..$((maxexports - 1))} ; do
1492 typeset -gx VCS_INFO_message_${i}_=
1494 VCS_INFO_nvcsformats $2
1497 (( ${#msgs} - 1 < 0 )) && return 0
1498 for i in {0..$(( ${#msgs} - 1 ))} ; do
1500 typeset -gx VCS_INFO_message_${i}_=${msgs[$j]}
1505 # information gathering
1506 VCS_INFO_bzr_get_data () { # {{{
1507 setopt localoptions noksharrays
1511 if zstyle -t ":vcs_info:${vcs}:${usercontext}" "use-simple" ; then
1512 bzrbase=${vcs_comm[basedir]}
1513 bzrinfo[2]=${bzrbase:t}
1514 if [[ -f ${bzrbase}/.bzr/branch/last-revision ]] ; then
1515 bzrinfo[1]=$(< ${bzrbase}/.bzr/branch/last-revision)
1516 bzrinfo[1]=${${bzrinfo[1]}%% *}
1519 bzrbase=${${(M)${(f)"$( bzr info )"}:# ##branch\ root:*}/*: ##/}
1520 bzrinfo=( ${${${(M)${(f)"$( bzr version-info )"}:#(#s)(revno|branch-nick)*}/*: /}/*\//} )
1521 bzrbase="$(VCS_INFO_realpath ${bzrbase})"
1524 zstyle -s ":vcs_info:${vcs}:${usercontext}" branchformat bzrbr || bzrbr="%b:%r"
1525 zformat -f bzrbr "${bzrbr}" "b:${bzrinfo[2]}" "r:${bzrinfo[1]}"
1526 VCS_INFO_formats '' "${bzrbr}" "${bzrbase}"
1530 VCS_INFO_cdv_get_data () { # {{{
1533 cdvbase=${vcs_comm[basedir]}
1534 VCS_INFO_formats '' "${cdvbase:t}" "${cdvbase}"
1538 VCS_INFO_cvs_get_data () { # {{{
1539 local cvsbranch cvsbase basename
1542 while [[ -d "${cvsbase}/../CVS" ]]; do
1543 cvsbase="${cvsbase}/.."
1545 cvsbase="$(VCS_INFO_realpath ${cvsbase})"
1546 cvsbranch=$(< ./CVS/Repository)
1547 basename=${cvsbase:t}
1548 cvsbranch=${cvsbranch##${basename}/}
1549 [[ -z ${cvsbranch} ]] && cvsbranch=${basename}
1550 VCS_INFO_formats '' "${cvsbranch}" "${cvsbase}"
1554 VCS_INFO_darcs_get_data () { # {{{
1557 darcsbase=${vcs_comm[basedir]}
1558 VCS_INFO_formats '' "${darcsbase:t}" "${darcsbase}"
1562 VCS_INFO_git_getaction () { #{{{
1563 local gitaction='' gitdir=$1
1566 for tmp in "${gitdir}/rebase-apply" \
1567 "${gitdir}/rebase" \
1568 "${gitdir}/../.dotest" ; do
1569 if [[ -d ${tmp} ]] ; then
1570 if [[ -f "${tmp}/rebasing" ]] ; then
1572 elif [[ -f "${tmp}/applying" ]] ; then
1575 gitaction="am/rebase"
1577 printf '%s' ${gitaction}
1582 for tmp in "${gitdir}/rebase-merge/interactive" \
1583 "${gitdir}/.dotest-merge/interactive" ; do
1584 if [[ -f "${tmp}" ]] ; then
1585 printf '%s' "rebase-i"
1590 for tmp in "${gitdir}/rebase-merge" \
1591 "${gitdir}/.dotest-merge" ; do
1592 if [[ -d "${tmp}" ]] ; then
1593 printf '%s' "rebase-m"
1598 if [[ -f "${gitdir}/MERGE_HEAD" ]] ; then
1603 if [[ -f "${gitdir}/BISECT_LOG" ]] ; then
1604 printf '%s' "bisect"
1610 VCS_INFO_git_getbranch () { #{{{
1611 local gitbranch gitdir=$1 tmp actiondir
1612 local gitsymref='git symbolic-ref HEAD'
1615 for tmp in "${gitdir}/rebase-apply" \
1616 "${gitdir}/rebase" \
1617 "${gitdir}/../.dotest"; do
1618 if [[ -d ${tmp} ]]; then
1623 if [[ -n ${actiondir} ]]; then
1624 gitbranch="$(${(z)gitsymref} 2> /dev/null)"
1625 [[ -z ${gitbranch} ]] && [[ -r ${actiondir}/head-name ]] \
1626 && gitbranch="$(< ${actiondir}/head-name)"
1628 elif [[ -f "${gitdir}/MERGE_HEAD" ]] ; then
1629 gitbranch="$(${(z)gitsymref} 2> /dev/null)"
1630 [[ -z ${gitbranch} ]] && gitbranch="$(< ${gitdir}/MERGE_HEAD)"
1632 elif [[ -d "${gitdir}/rebase-merge" ]] ; then
1633 gitbranch="$(< ${gitdir}/rebase-merge/head-name)"
1635 elif [[ -d "${gitdir}/.dotest-merge" ]] ; then
1636 gitbranch="$(< ${gitdir}/.dotest-merge/head-name)"
1639 gitbranch="$(${(z)gitsymref} 2> /dev/null)"
1641 if [[ $? -ne 0 ]] ; then
1642 gitbranch="refs/tags/$(git describe --exact-match HEAD 2>/dev/null)"
1644 if [[ $? -ne 0 ]] ; then
1645 gitbranch="${${"$(< $gitdir/HEAD)"}[1,7]}..."
1650 printf '%s' "${gitbranch##refs/[^/]##/}"
1654 VCS_INFO_git_get_data () { # {{{
1655 setopt localoptions extendedglob
1656 local gitdir gitbase gitbranch gitaction
1658 gitdir=${vcs_comm[gitdir]}
1659 gitbranch="$(VCS_INFO_git_getbranch ${gitdir})"
1661 if [[ -z ${gitdir} ]] || [[ -z ${gitbranch} ]] ; then
1666 gitaction="$(VCS_INFO_git_getaction ${gitdir})"
1667 gitbase=${PWD%/${$( git rev-parse --show-prefix )%/##}}
1668 VCS_INFO_formats "${gitaction}" "${gitbranch}" "${gitbase}"
1672 VCS_INFO_hg_get_data () { # {{{
1673 local hgbranch hgbase file
1675 hgbase=${vcs_comm[basedir]}
1677 file="${hgbase}/.hg/branch"
1678 if [[ -r ${file} ]] ; then
1679 hgbranch=$(< ${file})
1684 VCS_INFO_formats '' "${hgbranch}" "${hgbase}"
1688 VCS_INFO_mtn_get_data () { # {{{
1689 local mtnbranch mtnbase
1691 mtnbase=${vcs_comm[basedir]}
1692 mtnbranch=${${(M)${(f)"$( mtn status )"}:#(#s)Current branch:*}/*: /}
1693 VCS_INFO_formats '' "${mtnbranch}" "${mtnbase}"
1697 VCS_INFO_svk_get_data () { # {{{
1698 local svkbranch svkbase
1700 svkbase=${vcs_comm[basedir]}
1701 zstyle -s ":vcs_info:${vcs}:${usercontext}" branchformat svkbranch || svkbranch="%b:%r"
1702 zformat -f svkbranch "${svkbranch}" "b:${vcs_comm[branch]}" "r:${vcs_comm[revision]}"
1703 VCS_INFO_formats '' "${svkbranch}" "${svkbase}"
1707 VCS_INFO_svn_get_data () { # {{{
1708 setopt localoptions noksharrays
1709 local svnbase svnbranch
1713 while [[ -d "${svnbase}/../.svn" ]]; do
1714 svnbase="${svnbase}/.."
1716 svnbase="$(VCS_INFO_realpath ${svnbase})"
1717 svninfo=( ${${${(M)${(f)"$( svn info )"}:#(#s)(URL|Revision)*}/*: /}/*\//} )
1719 zstyle -s ":vcs_info:${vcs}:${usercontext}" branchformat svnbranch || svnbranch="%b:%r"
1720 zformat -f svnbranch "${svnbranch}" "b:${svninfo[1]}" "r:${svninfo[2]}"
1721 VCS_INFO_formats '' "${svnbranch}" "${svnbase}"
1725 VCS_INFO_tla_get_data () { # {{{
1726 local tlabase tlabranch
1728 tlabase="$(VCS_INFO_realpath ${vcs_comm[basedir]})"
1729 # tree-id gives us something like 'foo@example.com/demo--1.0--patch-4', so:
1730 tlabranch=${${"$( tla tree-id )"}/*\//}
1731 VCS_INFO_formats '' "${tlabranch}" "${tlabase}"
1736 VCS_INFO_detect_by_dir() { #{{{
1738 local basedir="." realbasedir
1740 realbasedir="$(VCS_INFO_realpath ${basedir})"
1741 while [[ ${realbasedir} != '/' ]]; do
1742 [[ -r ${realbasedir} ]] || return 1
1743 if [[ -n ${vcs_comm[detect_need_file]} ]] ; then
1744 [[ -d ${basedir}/${dirname} ]] && \
1745 [[ -e ${basedir}/${dirname}/${vcs_comm[detect_need_file]} ]] && \
1748 [[ -d ${basedir}/${dirname} ]] && break
1751 basedir=${basedir}/..
1752 realbasedir="$(VCS_INFO_realpath ${basedir})"
1755 [[ ${realbasedir} == "/" ]] && return 1
1756 vcs_comm[basedir]=${realbasedir}
1760 VCS_INFO_bzr_detect() { #{{{
1761 VCS_INFO_check_com bzr || return 1
1762 vcs_comm[detect_need_file]=branch/format
1763 VCS_INFO_detect_by_dir '.bzr'
1767 VCS_INFO_cdv_detect() { #{{{
1768 VCS_INFO_check_com cdv || return 1
1769 vcs_comm[detect_need_file]=format
1770 VCS_INFO_detect_by_dir '.cdv'
1774 VCS_INFO_cvs_detect() { #{{{
1775 VCS_INFO_check_com svn || return 1
1776 [[ -d "./CVS" ]] && [[ -r "./CVS/Repository" ]] && return 0
1780 VCS_INFO_darcs_detect() { #{{{
1781 VCS_INFO_check_com darcs || return 1
1782 vcs_comm[detect_need_file]=format
1783 VCS_INFO_detect_by_dir '_darcs'
1787 VCS_INFO_git_detect() { #{{{
1788 if VCS_INFO_check_com git && git rev-parse --is-inside-work-tree &> /dev/null ; then
1789 vcs_comm[gitdir]="$(git rev-parse --git-dir 2> /dev/null)" || return 1
1790 if [[ -d ${vcs_comm[gitdir]}/svn ]] ; then vcs_comm[overwrite_name]='git-svn'
1791 elif [[ -d ${vcs_comm[gitdir]}/refs/remotes/p4 ]] ; then vcs_comm[overwrite_name]='git-p4' ; fi
1797 VCS_INFO_hg_detect() { #{{{
1798 VCS_INFO_check_com hg || return 1
1799 vcs_comm[detect_need_file]=store
1800 VCS_INFO_detect_by_dir '.hg'
1804 VCS_INFO_mtn_detect() { #{{{
1805 VCS_INFO_check_com mtn || return 1
1806 vcs_comm[detect_need_file]=revision
1807 VCS_INFO_detect_by_dir '_MTN'
1811 VCS_INFO_svk_detect() { #{{{
1812 setopt localoptions noksharrays extendedglob
1817 VCS_INFO_check_com svk || return 1
1818 [[ -f ~/.svk/config ]] || return 1
1820 # This detection function is a bit different from the others.
1821 # We need to read svk's config file to detect a svk repository
1822 # in the first place. Therefore, we'll just proceed and read
1823 # the other information, too. This is more then any of the
1824 # other detections do but this takes only one file open for
1825 # svk at most. VCS_INFO_svk_get_data() get simpler, too. :-)
1826 while IFS= read -r line ; do
1827 if [[ -n ${vcs_comm[basedir]} ]] ; then
1829 [[ ${line} == depotpath:* ]] && vcs_comm[branch]=${line##*/}
1830 [[ ${line} == revision:* ]] && vcs_comm[revision]=${line##*[[:space:]]##}
1831 [[ -n ${vcs_comm[branch]} ]] && [[ -n ${vcs_comm[revision]} ]] && break
1834 (( fhash > 0 )) && [[ ${line} == ' '[^[:space:]]*:* ]] && break
1835 [[ ${line} == ' hash:'* ]] && fhash=1 && continue
1836 (( fhash == 0 )) && continue
1837 [[ ${PWD}/ == ${${line## ##}%:*}/* ]] && vcs_comm[basedir]=${${line## ##}%:*}
1838 done < ~/.svk/config
1840 [[ -n ${vcs_comm[basedir]} ]] && \
1841 [[ -n ${vcs_comm[branch]} ]] && \
1842 [[ -n ${vcs_comm[revision]} ]] && return 0
1846 VCS_INFO_svn_detect() { #{{{
1847 VCS_INFO_check_com svn || return 1
1848 [[ -d ".svn" ]] && return 0
1852 VCS_INFO_tla_detect() { #{{{
1853 VCS_INFO_check_com tla || return 1
1854 vcs_comm[basedir]="$(tla tree-root 2> /dev/null)" && return 0
1859 vcs_info_printsys () { # {{{
1860 vcs_info print_systems_
1863 vcs_info_lastmsg () { # {{{
1868 for i in {0..$((maxexports - 1))} ; do
1869 printf '$VCS_INFO_message_%d_: "' $i
1870 if zstyle -T ':vcs_info:formats:command' use-prompt-escapes ; then
1871 print -nP ${(P)${:-VCS_INFO_message_${i}_}}
1873 print -n ${(P)${:-VCS_INFO_message_${i}_}}
1883 [[ -r . ]] || return 1
1887 local -a VCSs disabled dps
1888 local -x vcs usercontext
1889 local -ix maxexports
1894 VCSs=(git hg bzr darcs svk mtn svn cvs cdv tla)
1897 zstyle -a ":vcs_info:${vcs}:${usercontext}" "disable" disabled
1898 print -l '# list of supported version control backends:' \
1899 '# disabled systems are prefixed by a hash sign (#)'
1900 for vcs in ${VCSs} ; do
1901 [[ -n ${(M)disabled:#${vcs}} ]] && printf '#'
1902 printf '%s\n' ${vcs}
1904 print -l '# flavours (cannot be used in the disable style; they' \
1905 '# are disabled with their master [git-svn -> git]):' \
1910 [[ -z ${usercontext} ]] && usercontext=default
1912 (*) [[ -z ${usercontext} ]] && usercontext=$1
1916 zstyle -T ":vcs_info:${vcs}:${usercontext}" "enable" || {
1917 [[ -n ${VCS_INFO_message_0_} ]] && VCS_INFO_set --clear
1920 zstyle -a ":vcs_info:${vcs}:${usercontext}" "disable" disabled
1922 zstyle -a ":vcs_info:${vcs}:${usercontext}" "disable-patterns" dps
1923 for pat in ${dps} ; do
1924 if [[ ${PWD} == ${~pat} ]] ; then
1925 [[ -n ${vcs_info_msg_0_} ]] && VCS_INFO_set --clear
1933 for vcs in ${VCSs} ; do
1934 [[ -n ${(M)disabled:#${vcs}} ]] && continue
1936 VCS_INFO_${vcs}_detect && (( found = 1 )) && break
1939 (( found == 0 )) && {
1944 VCS_INFO_${vcs}_get_data || {
1953 VCS_INFO_set --nvcs preinit
1956 # Change vcs_info formats for the grml prompt. The 2nd format sets up
1957 # $vcs_info_msg_1_ to contain "zsh: repo-name" used to set our screen title.
1958 # TODO: The included vcs_info() version still uses $VCS_INFO_message_N_.
1959 # That needs to be the use of $VCS_INFO_message_N_ needs to be changed
1960 # to $vcs_info_msg_N_ as soon as we use the included version.
1961 if [[ "$TERM" == dumb ]] ; then
1962 zstyle ':vcs_info:*' actionformats "(%s%)-[%b|%a] " "zsh: %r"
1963 zstyle ':vcs_info:*' formats "(%s%)-[%b] " "zsh: %r"
1965 # these are the same, just with a lot of colours:
1966 zstyle ':vcs_info:*' actionformats "${MAGENTA}(${NO_COLOUR}%s${MAGENTA})${YELLOW}-${MAGENTA}[${GREEN}%b${YELLOW}|${RED}%a${MAGENTA}]${NO_COLOUR} " \
1968 zstyle ':vcs_info:*' formats "${MAGENTA}(${NO_COLOUR}%s${MAGENTA})${YELLOW}-${MAGENTA}[${GREEN}%b${MAGENTA}]${NO_COLOUR}%} " \
1970 zstyle ':vcs_info:(sv[nk]|bzr):*' branchformat "%b${RED}:${YELLOW}%r"
1975 # command not found handling {{{
1977 (( ${COMMAND_NOT_FOUND} == 1 )) &&
1978 function command_not_found_handler() {
1980 if [[ -x ${GRML_ZSH_CNF_HANDLER} ]] ; then
1981 ${GRML_ZSH_CNF_HANDLER} $1
1989 if zrcautoload promptinit && promptinit 2>/dev/null ; then
1990 promptinit # people should be able to use their favourite prompt
1992 print 'Notice: no promptinit available :('
1997 # make sure to use right prompt only when not running a command
1998 is41 && setopt transient_rprompt
2000 # TODO: revise all these NO* variables and especially their documentation
2001 # in zsh-help() below.
2002 is4 && [[ $NOPRECMD -eq 0 ]] && precmd () {
2003 [[ $NOPRECMD -gt 0 ]] && return 0
2004 # update VCS information
2007 if [[ $TERM == screen* ]] ; then
2008 if [[ -n ${VCS_INFO_message_1_} ]] ; then
2009 print -nP "\ek${VCS_INFO_message_1_}\e\\"
2011 print -nP "\ekzsh\e\\"
2014 # just use DONTSETRPROMPT=1 to be able to overwrite RPROMPT
2015 if [[ $DONTSETRPROMPT -eq 0 ]] ; then
2016 if [[ $BATTERY -gt 0 ]] ; then
2017 # update battery (dropped into $PERCENT) information
2019 RPROMPT="%(?..:() ${PERCENT}"
2024 # adjust title of xterm
2025 # see http://www.faqs.org/docs/Linux-mini/Xterm-Title.html
2026 [[ ${NOTITLE} -gt 0 ]] && return 0
2029 print -Pn "\e]0;%n@%m: %~\a"
2034 # preexec() => a function running before every command
2035 is4 && [[ $NOPRECMD -eq 0 ]] && \
2037 [[ $NOPRECMD -gt 0 ]] && return 0
2038 # set hostname if not running on host with name 'grml'
2039 if [[ -n "$HOSTNAME" ]] && [[ "$HOSTNAME" != $(hostname) ]] ; then
2042 # get the name of the program currently running and hostname of local machine
2043 # set screen window title if running in a screen
2044 if [[ "$TERM" == screen* ]] ; then
2045 # local CMD=${1[(wr)^(*=*|sudo|ssh|-*)]} # don't use hostname
2046 local CMD="${1[(wr)^(*=*|sudo|ssh|-*)]}$NAME" # use hostname
2047 echo -ne "\ek$CMD\e\\"
2049 # adjust title of xterm
2050 [[ ${NOTITLE} -gt 0 ]] && return 0
2053 print -Pn "\e]0;%n@%m: $1\a"
2058 EXITCODE="%(?..%?%1v )"
2059 PS2='\`%_> ' # secondary prompt, printed when the shell needs more information to complete a command.
2060 PS3='?# ' # selection prompt used within a select loop.
2061 PS4='+%N:%i:%_> ' # the execution trace prompt (setopt xtrace). default: '+%N:%i>'
2063 # set variable debian_chroot if running in a chroot with /etc/debian_chroot
2064 if [[ -z "$debian_chroot" ]] && [[ -r /etc/debian_chroot ]] ; then
2065 debian_chroot=$(cat /etc/debian_chroot)
2068 # don't use colors on dumb terminals (like emacs):
2069 if [[ "$TERM" == dumb ]] ; then
2070 PROMPT="${EXITCODE}${debian_chroot:+($debian_chroot)}%n@%m %40<...<%B%~%b%<< "'${VCS_INFO_message_0_}'"%# "
2072 # only if $GRMLPROMPT is set (e.g. via 'GRMLPROMPT=1 zsh') use the extended prompt
2073 # set variable identifying the chroot you work in (used in the prompt below)
2074 if [[ $GRMLPROMPT -gt 0 ]] ; then
2075 PROMPT="${RED}${EXITCODE}${CYAN}[%j running job(s)] ${GREEN}{history#%!} ${RED}%(3L.+.) ${BLUE}%* %D
2076 ${BLUE}%n${NO_COLOUR}@%m %40<...<%B%~%b%<< "'${VCS_INFO_message_0_}'"%# "
2078 # This assembles the primary prompt string
2079 if (( EUID != 0 )); then
2080 PROMPT="${RED}${EXITCODE}${WHITE}${debian_chroot:+($debian_chroot)}${BLUE}%n${NO_COLOUR}@%m %40<...<%B%~%b%<< "'${VCS_INFO_message_0_}'"%# "
2082 PROMPT="${BLUE}${EXITCODE}${WHITE}${debian_chroot:+($debian_chroot)}${RED}%n${NO_COLOUR}@%m %40<...<%B%~%b%<< "'${VCS_INFO_message_0_}'"%# "
2087 # if we are inside a grml-chroot set a specific prompt theme
2088 if [[ -n "$GRML_CHROOT" ]] ; then
2089 PROMPT="%{$fg[red]%}(CHROOT) %{$fg_bold[red]%}%n%{$fg_no_bold[white]%}@%m %40<...<%B%~%b%<< %\# "
2093 # {{{ 'hash' some often used directories
2095 hash -d deb=/var/cache/apt/archives
2096 hash -d doc=/usr/share/doc
2097 hash -d linux=/lib/modules/$(command uname -r)/build/
2098 hash -d log=/var/log
2099 hash -d slog=/var/log/syslog
2100 hash -d src=/usr/src
2101 hash -d templ=/usr/share/doc/grml-templates
2102 hash -d tt=/usr/share/doc/texttools-doc
2103 hash -d www=/var/www
2108 if check_com -c screen ; then
2109 if [[ $UID -eq 0 ]] ; then
2110 [[ -r /etc/grml/screenrc ]] && alias screen="${commands[screen]} -c /etc/grml/screenrc"
2111 elif [[ -r $HOME/.screenrc ]] ; then
2112 alias screen="${commands[screen]} -c $HOME/.screenrc"
2114 [[ -r /etc/grml/screenrc_grml ]] && alias screen="${commands[screen]} -c /etc/grml/screenrc_grml"
2118 # do we have GNU ls with color-support?
2119 if ls --help 2>/dev/null | grep -- --color= >/dev/null && [[ "$TERM" != dumb ]] ; then
2120 #a1# execute \kbd{@a@}:\quad ls with colors
2121 alias ls='ls -b -CF --color=auto'
2122 #a1# execute \kbd{@a@}:\quad list all files, with colors
2123 alias la='ls -la --color=auto'
2124 #a1# long colored list, without dotfiles (@a@)
2125 alias ll='ls -l --color=auto'
2126 #a1# long colored list, human readable sizes (@a@)
2127 alias lh='ls -hAl --color=auto'
2128 #a1# List files, append qualifier to filenames \\&\quad(\kbd{/} for directories, \kbd{@} for symlinks ...)
2129 alias l='ls -lF --color=auto'
2131 alias ls='ls -b -CF'
2138 alias mdstat='cat /proc/mdstat'
2139 alias ...='cd ../../'
2141 # generate alias named "$KERNELVERSION-reboot" so you can use boot with kexec:
2142 if [[ -x /sbin/kexec ]] && [[ -r /proc/cmdline ]] ; then
2143 alias "$(uname -r)-reboot"="kexec -l --initrd=/boot/initrd.img-"$(uname -r)" --command-line=\"$(cat /proc/cmdline)\" /boot/vmlinuz-"$(uname -r)""
2146 alias cp='nocorrect cp' # no spelling correction on cp
2147 alias mkdir='nocorrect mkdir' # no spelling correction on mkdir
2148 alias mv='nocorrect mv' # no spelling correction on mv
2149 alias rm='nocorrect rm' # no spelling correction on rm
2151 #a1# Execute \kbd{rmdir}
2153 #a1# Execute \kbd{mkdir}
2156 # see http://www.cl.cam.ac.uk/~mgk25/unicode.html#term for details
2157 alias term2iso="echo 'Setting terminal to iso mode' ; print -n '\e%@'"
2158 alias term2utf="echo 'Setting terminal to utf-8 mode'; print -n '\e%G'"
2160 # make sure it is not assigned yet
2161 [[ -n ${aliases[utf2iso]} ]] && unalias utf2iso
2164 for ENV in $(env | command grep -i '.utf') ; do
2165 eval export "$(echo $ENV | sed 's/UTF-8/iso885915/ ; s/utf8/iso885915/')"
2170 # make sure it is not assigned yet
2171 [[ -n ${aliases[iso2utf]} ]] && unalias iso2utf
2173 if ! isutfenv ; then
2174 for ENV in $(env | command grep -i '\.iso') ; do
2175 eval export "$(echo $ENV | sed 's/iso.*/UTF-8/ ; s/ISO.*/UTF-8/')"
2180 # set up software synthesizer via speakup
2182 if [ -x /usr/sbin/swspeak-setup ] ; then
2183 setopt singlelinezle
2186 /usr/sbin/swspeak-setup $@
2188 if ! [[ -r /dev/softsynth ]] ; then
2189 flite -o play -t "Sorry, software synthesizer not available. Did you boot with swspeak bootoption?"
2192 setopt singlelinezle
2195 nice -n -20 speechd-up
2197 flite -o play -t "Finished setting up software synthesizer"
2202 # I like clean prompt, so provide simple way to get that
2203 check_com 0 || alias 0='return 0'
2205 # for really lazy people like mika:
2206 check_com S &>/dev/null || alias S='screen'
2207 check_com s &>/dev/null || alias s='ssh'
2209 # get top 10 shell commands:
2210 alias top10='print -l ? ${(o)history%% *} | uniq -c | sort -nr | head -n 10'
2212 # truecrypt; use e.g. via 'truec /dev/ice /mnt/ice' or 'truec -i'
2213 if check_com -c truecrypt ; then
2215 alias truec='truecrypt --mount-options "rw,sync,dirsync,users,uid=1000,gid=users,umask=077,utf8" '
2217 alias truec='truecrypt --mount-options "rw,sync,dirsync,users,uid=1000,gid=users,umask=077" '
2221 #f1# Hints for the use of zsh on grml
2223 print "$bg[white]$fg[black]
2224 zsh-help - hints for use of zsh on grml
2225 =======================================$reset_color"
2228 Main configuration of zsh happens in /etc/zsh/zshrc.
2229 That file is part of the package grml-etc-core, if you want to
2230 use them on a non-grml-system just get the tar.gz from
2231 http://deb.grml.org/ or (preferably) get it from the git repository:
2233 http://git.grml.org/f/grml-etc-core/etc/zsh/zshrc
2235 This version of grml'\''s zsh setup does not use skel/.zshrc anymore.
2236 The file is still there, but it is empty for backwards compatibility.
2238 For your own changes use these two files:
2242 The former is sourced very early in our zshrc, the latter is sourced
2245 System wide configuration without touching configuration files of grml
2246 can take place in /etc/zsh/zshrc.local.
2248 Normally, the root user (EUID == 0) does not get the whole grml setup.
2249 If you want to force the whole setup for that user, too, set
2250 GRML_ALWAYS_LOAD_ALL=1 in .zshrc.pre in root'\''s home directory.
2252 For information regarding zsh start at http://grml.org/zsh/
2254 Take a look at grml'\''s zsh refcard:
2255 % xpdf =(zcat /usr/share/doc/grml-docs/zsh/grml-zsh-refcard.pdf.gz)
2257 Check out the main zsh refcard:
2258 % '$BROWSER' http://www.bash2zsh.com/zsh_refcard/refcard.pdf
2260 And of course visit the zsh-lovers:
2263 You can adjust some options through environment variables when
2264 invoking zsh without having to edit configuration files.
2265 Basically meant for bash users who are not used to the power of
2268 "NOCOR=1 zsh" => deactivate automatic correction
2269 "NOMENU=1 zsh" => do not use auto menu completion (note: use ctrl-d for completion instead!)
2270 "NOPRECMD=1 zsh" => disable the precmd + preexec commands (set GNU screen title)
2271 "NOTITLE=1 zsh" => disable setting the title of xterms without disabling
2272 preexec() and precmd() completely
2273 "BATTERY=1 zsh" => activate battery status (via acpi) on right side of prompt
2274 "COMMAND_NOT_FOUND=1 zsh"
2275 => Enable a handler if an external command was not found
2276 The command called in the handler can be altered by setting
2277 the GRML_ZSH_CNF_HANDLER variable, the default is:
2278 "/usr/share/command-not-found/command-not-found"
2280 A value greater than 0 is enables a feature; a value equal to zero
2281 disables it. If you like one or the other of these settings, you can
2282 add them to ~/.zshrc.pre to ensure they are set when sourcing grml'\''s
2286 $bg[white]$fg[black]
2287 Please report wishes + bugs to the grml-team: http://grml.org/bugs/
2288 Enjoy your grml system with the zsh!$reset_color"
2292 if [[ -r /etc/debian_version ]] ; then
2293 #a3# Execute \kbd{apt-cache search}
2294 alias acs='apt-cache search'
2295 #a3# Execute \kbd{apt-cache show}
2296 alias acsh='apt-cache show'
2297 #a3# Execute \kbd{apt-cache policy}
2298 alias acp='apt-cache policy'
2299 #a3# Execute \kbd{apt-get dist-upgrade}
2300 salias adg="apt-get dist-upgrade"
2301 #a3# Execute \kbd{apt-get install}
2302 salias agi="apt-get install"
2303 #a3# Execute \kbd{aptitude install}
2304 salias ati="aptitude install"
2305 #a3# Execute \kbd{apt-get upgrade}
2306 salias ag="apt-get upgrade"
2307 #a3# Execute \kbd{apt-get update}
2308 salias au="apt-get update"
2309 #a3# Execute \kbd{aptitude update ; aptitude safe-upgrade}
2310 salias -a up="aptitude update ; aptitude safe-upgrade"
2311 #a3# Execute \kbd{dpkg-buildpackage}
2312 alias dbp='dpkg-buildpackage'
2313 #a3# Execute \kbd{grep-excuses}
2314 alias ge='grep-excuses'
2317 #f3# Execute \kbd{apt-get update \&\& }\\&\quad \kbd{apt-get dist-upgrade}
2320 if [[ -z $1 ]] ; then
2321 $SUDO apt-get update
2322 $SUDO apt-get -u upgrade
2324 ssh $1 $SUDO apt-get update
2325 # ask before the upgrade
2327 ssh $1 $SUDO apt-get --no-act upgrade
2328 echo -n 'Process the upgrade?'
2330 if [[ $dummy == "y" ]] ; then
2331 ssh $1 $SUDO apt-get -u upgrade --yes
2336 # get a root shell as normal user in live-cd mode:
2337 if isgrmlcd && [[ $UID -ne 0 ]] ; then
2341 #a1# Take a look at the syslog: \kbd{\$PAGER /var/log/syslog}
2342 salias llog="$PAGER /var/log/syslog" # take a look at the syslog
2343 #a1# Take a look at the syslog: \kbd{tail -f /var/log/syslog}
2344 salias tlog="tail -f /var/log/syslog" # follow the syslog
2347 # sort installed Debian-packages by size
2348 if check_com -c grep-status ; then
2349 #a3# List installed Debian-packages sorted by size
2350 alias debs-by-size='grep-status -FStatus -sInstalled-Size,Package -n "install ok installed" | paste -sd " \n" | sort -rn'
2353 # if cdrecord is a symlink (to wodim) or isn't present at all warn:
2354 if [[ -L /usr/bin/cdrecord ]] || ! check_com -c cdrecord; then
2355 if check_com -c wodim; then
2358 cdrecord is not provided under its original name by Debian anymore.
2359 See #377109 in the BTS of Debian for more details.
2361 Please use the wodim binary instead
2368 # get_tw_cli has been renamed into get_3ware
2369 if check_com -c get_3ware ; then
2371 echo 'Warning: get_tw_cli has been renamed into get_3ware. Invoking get_3ware for you.'>&2
2376 # I hate lacking backward compatibility, so provide an alternative therefore
2377 if ! check_com -c apache2-ssl-certificate ; then
2379 apache2-ssl-certificate() {
2381 print 'Debian does not ship apache2-ssl-certificate anymore (see #398520). :('
2382 print 'You might want to take a look at Debian the package ssl-cert as well.'
2383 print 'To generate a certificate for use with apache2 follow the instructions:'
2387 export RANDFILE=/dev/random
2388 mkdir /etc/apache2/ssl/
2389 openssl req $@ -new -x509 -days 365 -nodes -out /etc/apache2/ssl/apache.pem -keyout /etc/apache2/ssl/apache.pem
2390 chmod 600 /etc/apache2/ssl/apache.pem
2392 Run "grml-tips ssl-certificate" if you need further instructions.
2398 # {{{ Use hard limits, except for a smaller stack and no core dumps
2400 is425 && limit stack 8192
2401 isgrmlcd && limit core 0 # important for a live-cd-system
2405 # {{{ completion system
2407 # called later (via is4 && grmlcomp)
2408 # note: use 'zstyle' for getting current settings
2409 # press ^Xh (control-x h) for getting tags in context; ^X? (control-x ?) to run complete_debug with trace output
2411 # TODO: This could use some additional information
2413 # allow one error for every three characters typed in approximate completer
2414 zstyle ':completion:*:approximate:' max-errors 'reply=( $((($#PREFIX+$#SUFFIX)/3 )) numeric )'
2416 # don't complete backup files as executables
2417 zstyle ':completion:*:complete:-command-::commands' ignored-patterns '(aptitude-*|*\~)'
2419 # start menu completion only if it could find no unambiguous initial string
2420 zstyle ':completion:*:correct:*' insert-unambiguous true
2421 zstyle ':completion:*:corrections' format $'%{\e[0;31m%}%d (errors: %e)%{\e[0m%}'
2422 zstyle ':completion:*:correct:*' original true
2424 # activate color-completion
2425 zstyle ':completion:*:default' list-colors ${(s.:.)LS_COLORS}
2427 # format on completion
2428 zstyle ':completion:*:descriptions' format $'%{\e[0;31m%}completing %B%d%b%{\e[0m%}'
2430 # complete 'cd -<tab>' with menu
2431 zstyle ':completion:*:*:cd:*:directory-stack' menu yes select
2433 # insert all expansions for expand completer
2434 zstyle ':completion:*:expand:*' tag-order all-expansions
2435 zstyle ':completion:*:history-words' list false
2438 zstyle ':completion:*:history-words' menu yes
2440 # ignore duplicate entries
2441 zstyle ':completion:*:history-words' remove-all-dups yes
2442 zstyle ':completion:*:history-words' stop yes
2444 # match uppercase from lowercase
2445 zstyle ':completion:*' matcher-list 'm:{a-z}={A-Z}'
2447 # separate matches into groups
2448 zstyle ':completion:*:matches' group 'yes'
2449 zstyle ':completion:*' group-name ''
2451 if [[ "$NOMENU" -eq 0 ]] ; then
2452 # if there are more than 5 options allow selecting from a menu
2453 zstyle ':completion:*' menu select=5
2455 # don't use any menus at all
2459 zstyle ':completion:*:messages' format '%d'
2460 zstyle ':completion:*:options' auto-description '%d'
2462 # describe options in full
2463 zstyle ':completion:*:options' description 'yes'
2465 # on processes completion complete all user processes
2466 zstyle ':completion:*:processes' command 'ps -au$USER'
2468 # offer indexes before parameters in subscripts
2469 zstyle ':completion:*:*:-subscript-:*' tag-order indexes parameters
2471 # provide verbose completion information
2472 zstyle ':completion:*' verbose true
2474 # recent (as of Dec 2007) zsh versions are able to provide descriptions
2475 # for commands (read: 1st word in the line) that it will list for the user
2476 # to choose from. The following disables that, because it's not exactly fast.
2477 zstyle ':completion:*:-command-:*:' verbose false
2479 # set format for warnings
2480 zstyle ':completion:*:warnings' format $'%{\e[0;31m%}No matches for:%{\e[0m%} %d'
2482 # define files to ignore for zcompile
2483 zstyle ':completion:*:*:zcompile:*' ignored-patterns '(*~|*.zwc)'
2484 zstyle ':completion:correct:' prompt 'correct to: %e'
2486 # Ignore completion functions for commands you don't have:
2487 zstyle ':completion::(^approximate*):*:functions' ignored-patterns '_*'
2489 # Provide more processes in completion of programs like killall:
2490 zstyle ':completion:*:processes-names' command 'ps c -u ${USER} -o command | uniq'
2492 # complete manual by their section
2493 zstyle ':completion:*:manuals' separate-sections true
2494 zstyle ':completion:*:manuals.*' insert-sections true
2495 zstyle ':completion:*:man:*' menu yes select
2497 # provide .. as a completion
2498 zstyle ':completion:*' special-dirs ..
2500 # run rehash on completion so new installed program are found automatically:
2502 (( CURRENT == 1 )) && rehash
2507 # some people don't like the automatic correction - so run 'NOCOR=1 zsh' to deactivate it
2508 if [[ "$NOCOR" -gt 0 ]] ; then
2509 zstyle ':completion:*' completer _oldlist _expand _force_rehash _complete _files _ignored
2512 # try to be smart about when to use what completer...
2514 zstyle -e ':completion:*' completer '
2515 if [[ $_last_try != "$HISTNO$BUFFER$CURSOR" ]] ; then
2516 _last_try="$HISTNO$BUFFER$CURSOR"
2517 reply=(_complete _match _ignored _prefix _files)
2519 if [[ $words[1] == (rm|mv) ]] ; then
2520 reply=(_complete _files)
2522 reply=(_oldlist _expand _force_rehash _complete _ignored _correct _approximate _files)
2527 # command for process lists, the local web server details and host completion
2528 zstyle ':completion:*:urls' local 'www' '/var/www/' 'public_html'
2531 [[ -d $ZSHDIR/cache ]] && zstyle ':completion:*' use-cache yes && \
2532 zstyle ':completion::complete:*' cache-path $ZSHDIR/cache/
2534 # host completion /* add brackets as vim can't parse zsh's complex cmdlines 8-) {{{ */
2536 [[ -r ~/.ssh/known_hosts ]] && _ssh_hosts=(${${${${(f)"$(<$HOME/.ssh/known_hosts)"}:#[\|]*}%%\ *}%%,*}) || _ssh_hosts=()
2537 [[ -r /etc/hosts ]] && : ${(A)_etc_hosts:=${(s: :)${(ps:\t:)${${(f)~~"$(</etc/hosts)"}%%\#*}##[:blank:]#[^[:blank:]]#}}} || _etc_hosts=()
2549 zstyle ':completion:*:hosts' hosts $hosts
2550 # TODO: so, why is this here?
2551 # zstyle '*' hosts $hosts
2553 # use generic completion system for programs not yet defined; (_gnu_generic works
2554 # with commands that provide a --help option with "standard" gnu-like output.)
2555 for compcom in cp deborphan df feh fetchipac head hnb ipacsum mv \
2556 pal stow tail uname ; do
2557 [[ -z ${_comps[$compcom]} ]] && compdef _gnu_generic ${compcom}
2560 # see upgrade function in this file
2561 compdef _hosts upgrade
2567 # people should use 'grml-x'!
2569 if [[ -e /etc/X11/xorg.conf ]] ; then
2570 [[ -x /usr/bin/startx ]] && /usr/bin/startx "$@" || /usr/X11R6/bin/startx "$@"
2572 echo "Please use the script \"grml-x\" for starting the X Window System
2573 because there does not exist /etc/X11/xorg.conf yet.
2574 If you want to use startx anyway please call \"/usr/bin/startx\"."
2580 if [[ -e /etc/X11/xorg.conf ]] ; then
2581 [[ -x /usr/bin/xinit ]] && /usr/bin/xinit || /usr/X11R6/bin/xinit
2583 echo "Please use the script \"grml-x\" for starting the X Window System.
2584 because there does not exist /etc/X11/xorg.conf yet.
2585 If you want to use xinit anyway please call \"/usr/bin/xinit\"."
2590 if check_com -c 915resolution; then
2592 echo "Please use 915resolution as resolution modifying tool for Intel \
2598 #a1# Output version of running grml
2599 alias grml-version='cat /etc/grml_version'
2601 if check_com -c rebuildfstab ; then
2602 #a1# Rebuild /etc/fstab
2603 alias grml-rebuildfstab='rebuildfstab -v -r -config'
2606 if check_com -c grml-debootstrap ; then
2608 echo "Installing debian to harddisk is possible by using grml-debootstrap."
2615 # {{{ now run the functions
2617 is4 && isgrml && grmlstuff
2622 is4 && xsource "/etc/zsh/keephack"
2625 # {{{ wonderful idea of using "e" glob qualifier by Peter Stephenson
2626 # You use it as follows:
2627 # $ NTREF=/reference/file
2629 # This lists all the files in the current directory newer than the reference file.
2630 # You can also specify the reference file inline; note quotes:
2631 # $ ls -l *(e:'nt ~/.zshenv':)
2633 if [[ -n $1 ]] ; then
2636 [[ $REPLY -nt $NTREF ]]
2640 # shell functions {{{
2642 #f1# Provide csh compatibility
2643 setenv() { typeset -x "${1}${1:+=}${(@)argv[2,$#]}" } # csh compatibility
2645 #f1# Reload an autoloadable function
2646 freload() { while (( $# )); do; unfunction $1; autoload -U $1; shift; done }
2647 compdef _functions freload
2649 #f1# List symlinks in detail (more detailed version of 'readlink -f' and 'whence -s')
2651 [[ -z "$1" ]] && printf 'Usage: %s <file(s)>\n' "$0" && return 1
2652 for file in "$@" ; do
2653 while [[ -h "$file" ]] ; do
2655 file=$(readlink "$file")
2660 # fast manual access
2661 if check_com qma ; then
2662 #f1# View the zsh manual
2663 manzsh() { qma zshall "$1" }
2666 manzsh() { /usr/bin/man zshall | vim -c "se ft=man| se hlsearch" +/"$1" - ; }
2669 # TODO: Is it supported to use pager settings like this?
2670 # PAGER='less -Mr' - If so, the use of $PAGER here needs fixing
2671 # with respect to wordsplitting. (ie. ${=PAGER})
2672 if check_com -c $PAGER ; then
2673 #f1# View Debian's changelog of a given package
2676 if [[ -r /usr/share/doc/$1/changelog.Debian.gz ]] ; then
2677 $PAGER /usr/share/doc/$1/changelog.Debian.gz
2678 elif [[ -r /usr/share/doc/$1/changelog.gz ]] ; then
2679 $PAGER /usr/share/doc/$1/changelog.gz
2681 if check_com -c aptitude ; then
2682 echo "No changelog for package $1 found, using aptitude to retrieve it."
2684 aptitude -t unstable changelog $1
2686 aptitude changelog $1
2689 echo "No changelog for package $1 found, sorry."
2694 _dchange() { _files -W /usr/share/doc -/ }
2695 compdef _dchange dchange
2697 #f1# View Debian's NEWS of a given package
2700 if [[ -r /usr/share/doc/$1/NEWS.Debian.gz ]] ; then
2701 $PAGER /usr/share/doc/$1/NEWS.Debian.gz
2703 if [[ -r /usr/share/doc/$1/NEWS.gz ]] ; then
2704 $PAGER /usr/share/doc/$1/NEWS.gz
2706 echo "No NEWS file for package $1 found, sorry."
2711 _dnews() { _files -W /usr/share/doc -/ }
2712 compdef _dnews dnews
2714 #f1# View upstream's changelog of a given package
2717 if [[ -r /usr/share/doc/$1/changelog.gz ]] ; then
2718 $PAGER /usr/share/doc/$1/changelog.gz
2720 echo "No changelog for package $1 found, sorry."
2724 _uchange() { _files -W /usr/share/doc -/ }
2725 compdef _uchange uchange
2730 ZSH_PROFILE_RC=1 $SHELL "$@"
2733 #f1# Edit an alias via zle
2735 [[ -z "$1" ]] && { echo "Usage: edalias <alias_to_edit>" ; return 1 } || vared aliases'[$1]' ;
2737 compdef _aliases edalias
2739 #f1# Edit a function via zle
2741 [[ -z "$1" ]] && { echo "Usage: edfun <function_to_edit>" ; return 1 } || zed -f "$1" ;
2743 compdef _functions edfunc
2745 # use it e.g. via 'Restart apache2'
2746 #m# f6 Start() \kbd{/etc/init.d/\em{process}}\quad\kbd{start}
2747 #m# f6 Restart() \kbd{/etc/init.d/\em{process}}\quad\kbd{restart}
2748 #m# f6 Stop() \kbd{/etc/init.d/\em{process}}\quad\kbd{stop}
2749 #m# f6 Reload() \kbd{/etc/init.d/\em{process}}\quad\kbd{reload}
2750 #m# f6 Force-Reload() \kbd{/etc/init.d/\em{process}}\quad\kbd{force-reload}
2751 if [[ -d /etc/init.d || -d /etc/service ]] ; then
2753 local action_="${1:l}" # e.g Start/Stop/Restart
2757 local service_target_="$(readlink /etc/init.d/$service_)"
2758 if [[ $service_target_ == "/usr/bin/sv" ]]; then
2760 case "${action_}" in
2761 start) if [[ ! -e /etc/service/$service_ ]]; then
2762 $SUDO ln -s "/etc/sv/$service_" "/etc/service/"
2764 $SUDO "/etc/init.d/$service_" "${action_}" "$param_"
2766 # there is no reload in runits sysv emulation
2767 reload) $SUDO "/etc/init.d/$service_" "force-reload" "$param_" ;;
2768 *) $SUDO "/etc/init.d/$service_" "${action_}" "$param_" ;;
2772 $SUDO "/etc/init.d/$service_" "${action_}" "$param_"
2776 for i in Start Restart Stop Force-Reload Reload ; do
2777 eval "$i() { __start_stop $i \"\$1\" \"\$2\" ; }"
2781 #f1# Provides useful information on globbing
2788 p named pipes (FIFOs)
2789 * executable plain files (0100)
2790 % device files (character or block special)
2791 %b block special files
2792 %c character special files
2793 r owner-readable files (0400)
2794 w owner-writable files (0200)
2795 x owner-executable files (0100)
2796 A group-readable files (0040)
2797 I group-writable files (0020)
2798 E group-executable files (0010)
2799 R world-readable files (0004)
2800 W world-writable files (0002)
2801 X world-executable files (0001)
2802 s setuid files (04000)
2803 S setgid files (02000)
2804 t files with the sticky bit (01000)
2806 print *(m-1) # Files modified up to a day ago
2807 print *(a1) # Files accessed a day ago
2808 print *(@) # Just symlinks
2809 print *(Lk+50) # Files bigger than 50 kilobytes
2810 print *(Lk-50) # Files smaller than 50 kilobytes
2811 print **/*.c # All *.c files recursively starting in \$PWD
2812 print **/*.c~file.c # Same as above, but excluding 'file.c'
2813 print (foo|bar).* # Files starting with 'foo' or 'bar'
2814 print *~*.* # All Files that do not contain a dot
2815 chmod 644 *(.^x) # make all plain non-executable files publically readable
2816 print -l *(.c|.h) # Lists *.c and *.h
2817 print **/*(g:users:) # Recursively match all files that are owned by group 'users'
2818 echo /proc/*/cwd(:h:t:s/self//) # Analogous to >ps ax | awk '{print $1}'<"
2820 alias help-zshglob=H-Glob
2822 check_com -c qma && alias ?='qma zshall'
2824 # grep for running process, like: 'any vim'
2827 if [[ -z "$1" ]] ; then
2828 echo "any - grep for process(es) by keyword" >&2
2829 echo "Usage: any <keyword>" >&2 ; return 1
2832 local LENGTH=$(expr length $STRING)
2833 local FIRSCHAR=$(echo $(expr substr $STRING 1 1))
2834 local REST=$(echo $(expr substr $STRING 2 $LENGTH))
2835 ps xauwww| grep "[$FIRSCHAR]$REST"
2839 # After resuming from suspend, system is paging heavily, leading to very bad interactivity.
2840 # taken from $LINUX-KERNELSOURCE/Documentation/power/swsusp.txt
2841 [[ -r /proc/1/maps ]] && \
2843 print 'Reading /proc/[0-9]*/maps and sending output to /dev/null, this might take a while.'
2844 cat $(sed -ne 's:.* /:/:p' /proc/[0-9]*/maps | sort -u | grep -v '^/dev/') > /dev/null
2845 print 'Finished, running "swapoff -a; swapon -a" may also be useful.'
2848 # print hex value of a number
2851 [[ -n "$1" ]] && printf "%x\n" $1 || { print 'Usage: hex <number-to-convert>' ; return 1 }
2854 # calculate (or eval at all ;-)) with perl => p[erl-]eval
2855 # hint: also take a look at zcalc -> 'autoload zcalc' -> 'man zshmodules | less -p MATHFUNC'
2857 [[ -n "$1" ]] && CALC="$*" || print "Usage: calc [expression]"
2858 perl -e "print eval($CALC),\"\n\";"
2860 functions peval &>/dev/null && alias calc=peval
2862 # brltty seems to have problems with utf8 environment and/or font Uni3-Terminus16 under
2863 # certain circumstances, so work around it, no matter which environment we have
2865 if [[ -z "$DISPLAY" ]] ; then
2866 consolechars -f /usr/share/consolefonts/default8x16.psf.gz
2873 # just press 'asdf' keys to toggle between dvorak and us keyboard layout
2875 echo -n 'Switching to us keyboard layout: '
2876 [[ -z "$DISPLAY" ]] && $SUDO loadkeys us &>/dev/null || setxkbmap us &>/dev/null
2880 echo -n 'Switching to dvorak keyboard layout: '
2881 [[ -z "$DISPLAY" ]] && $SUDO loadkeys dvorak &>/dev/null || setxkbmap dvorak &>/dev/null
2884 # just press 'asdf' key to toggle from neon layout to us keyboard layout
2886 echo -n 'Switching to us keyboard layout: '
2887 setxkbmap us && echo 'Done' || echo 'Failed'
2890 # set up an ipv6 tunnel
2895 if ifconfig sit1 2>/dev/null | grep -q 'inet6 addr: 2002:.*:1::1' ; then
2896 print 'ipv6 tunnel already set up, nothing to be done.'
2897 print 'execute: "ifconfig sit1 down ; ifconfig sit0 down" to remove ipv6-tunnel.' ; return 1
2899 [[ -n "$PUBLIC_IP" ]] || \
2900 local PUBLIC_IP=$(ifconfig $(route -n | awk '/^0\.0\.0\.0/{print $8; exit}') | \
2901 awk '/inet addr:/ {print $2}' | tr -d 'addr:')
2903 [[ -n "$PUBLIC_IP" ]] || { print 'No $PUBLIC_IP set and could not determine default one.' ; return 1 }
2904 local IPV6ADDR=$(printf "2002:%02x%02x:%02x%02x:1::1" $(print ${PUBLIC_IP//./ }))
2905 print -n "Setting up ipv6 tunnel $IPV6ADDR via ${PUBLIC_IP}: "
2906 ifconfig sit0 tunnel ::192.88.99.1 up
2907 ifconfig sit1 add "$IPV6ADDR" && print done || print failed
2911 if ifconfig sit1 2>/dev/null | grep -q 'inet6 addr: 2002:.*:1::1' ; then
2912 print 'ipv6 tunnel available' ; return 0
2914 print 'ipv6 tunnel not available' ; return 1
2918 if ifconfig sit1 2>/dev/null | grep -q 'inet6 addr: 2002:.*:1::1' ; then
2919 print -n 'Stopping ipv6 tunnel (sit0 + sit1): '
2920 ifconfig sit1 down ; ifconfig sit0 down && print done || print failed
2922 print 'No ipv6 tunnel found, nothing to be done.' ; return 1
2926 print "Usage: ipv6-tunnel [start|stop|status]">&2 ; return 1
2931 # run dhclient for wireless device
2933 salias dhclient "$(wavemon -d | awk '/device/{print $2}')"
2936 # spawn a minimally set up ksh - useful if you want to umount /usr/.
2938 exec env -i ENV="/etc/minimal-shellrc" HOME="$HOME" TERM="$TERM" ksh
2941 # a wrapper for vim, that deals with title setting
2943 # set this array to a set of options to vim you always want
2944 # to have set when calling vim (in .zshrc.local), like:
2945 # VIM_OPTIONS=( -p )
2946 # This will cause vim to send every file given on the
2947 # commandline to be send to it's own tab (needs vim7).
2949 VIM_PLEASE_SET_TITLE='yes' command vim ${VIM_OPTIONS} "$@"
2952 # make a backup of a file
2954 cp -a "$1" "${1}_$(date --iso-8601=seconds)"
2957 #f1# grep for patterns in grml's zsh setup
2963 print "usage: zg -[anr] <pattern>\n";
2964 print " Search for patterns in grml'\''s zshrc.\n";
2965 print " zg takes no or exactly one option plus a non empty pattern.\n\n";
2966 print " options:\n";
2967 print " -- no options (use if your pattern starts in with a dash.\n";
2968 print " -a search for the pattern in all code regions\n";
2969 print " -n search for the pattern in non-root code only\n";
2970 print " -r search in code for everyone (also root) only\n\n";
2971 print " The default is -a for non-root users and -r for root.\n\n";
2972 print " If you installed the zshrc to a non-default locations (ie *NOT*\n";
2973 print " in /etc/zsh/zshrc) do: export GRML_ZSHRC=\$HOME/.zshrc\n";
2974 print " ...in case you copied the file to that location.\n\n";
2978 if ($ENV{GRML_ZSHRC} ne "") {
2979 $RC = $ENV{GRML_ZSHRC};
2981 $RC = "/etc/zsh/zshrc";
2984 usage if ($#ARGV < 0 || $#ARGV > 1);
2985 if ($> == 0) { $mode = "allonly"; }
2986 else { $mode = "all"; }
2989 if ($opt eq "--") { shift; }
2990 elsif ($opt eq "-a") { $mode = "all"; shift; }
2991 elsif ($opt eq "-n") { $mode = "nonroot"; shift; }
2992 elsif ($opt eq "-r" ) { $mode = "allonly"; shift; }
2993 elsif ($opt =~ m/^-/ || $#ARGV > 0) { usage(); }
2995 $pattern = $ARGV[0];
2996 usage() if ($pattern eq "");
2998 open FH, "<$RC" or die "zg: Could not open $RC: $!\n";
2999 while ($line = <FH>) {
3001 if ($line =~ m/^#:grep:marker:for:mika:/) { $markerfound = 1; next; }
3002 next if ($mode eq "nonroot" && markerfound == 0);
3003 break if ($mode eq "allonly" && markerfound == 1);
3004 print $line, "\n" if ($line =~ /$pattern/);
3014 ssl_hashes=( sha512 sha256 sha1 md5 )
3016 for sh in ${ssl_hashes}; do
3019 if [[ -z $1 ]] ; then
3020 printf 'usage: %s <file>\n' "ssh-cert-${sh}"
3023 openssl x509 -noout -fingerprint -${sh} -in $1
3027 ssl-cert-fingerprints() {
3030 if [[ -z $1 ]] ; then
3031 printf 'usage: ssl-cert-fingerprints <file>\n'
3034 for i in ${ssl_hashes}
3041 if [[ -z $1 ]] ; then
3042 printf 'usage: ssl-cert-info <file>\n'
3045 openssl x509 -noout -text -in $1
3046 ssl-cert-fingerprints $1
3051 # {{{ make sure our environment is clean regarding colors
3052 for color in BLUE RED GREEN CYAN YELLOW MAGENTA WHITE ; unset $color
3055 # "persistent history" {{{
3056 # just write important commands you always need to ~/.important_commands
3057 if [[ -r ~/.important_commands ]] ; then
3058 fc -R ~/.important_commands
3062 #:grep:marker:for:mika: :-)
3063 ### non-root (EUID != 0) code below
3066 if (( GRML_ALWAYS_LOAD_ALL == 0 )) && (( $EUID == 0 )) ; then
3074 # set terminal property (used e.g. by msgid-chooser)
3075 export COLORTERM="yes"
3077 # set default browser
3078 if [[ -z "$BROWSER" ]] ; then
3079 if [[ -n "$DISPLAY" ]] ; then
3080 #v# If X11 is running
3081 check_com -c firefox && export BROWSER=firefox
3083 #v# If no X11 is running
3084 check_com -c w3m && export BROWSER=w3m
3088 #m# v QTDIR \kbd{/usr/share/qt[34]}\quad [for non-root only]
3089 [[ -d /usr/share/qt3 ]] && export QTDIR=/usr/share/qt3
3090 [[ -d /usr/share/qt4 ]] && export QTDIR=/usr/share/qt4
3092 # support running 'jikes *.java && jamvm HelloWorld' OOTB:
3093 #v# [for non-root only]
3094 [[ -f /usr/share/classpath/glibj.zip ]] && export JIKESPATH=/usr/share/classpath/glibj.zip
3099 # Xterm resizing-fu.
3100 # Based on http://svn.kitenet.net/trunk/home-full/.zshrc?rev=11710&view=log (by Joey Hess)
3101 alias hide='echo -en "\033]50;nil2\007"'
3102 alias tiny='echo -en "\033]50;-misc-fixed-medium-r-normal-*-*-80-*-*-c-*-iso8859-15\007"'
3103 alias small='echo -en "\033]50;6x10\007"'
3104 alias medium='echo -en "\033]50;-misc-fixed-medium-r-normal--13-120-75-75-c-80-iso8859-15\007"'
3105 alias default='echo -e "\033]50;-misc-fixed-medium-r-normal-*-*-140-*-*-c-*-iso8859-15\007"'
3106 alias large='echo -en "\033]50;-misc-fixed-medium-r-normal-*-*-150-*-*-c-*-iso8859-15\007"'
3107 alias huge='echo -en "\033]50;-misc-fixed-medium-r-normal-*-*-210-*-*-c-*-iso8859-15\007"'
3108 alias smartfont='echo -en "\033]50;-artwiz-smoothansi-*-*-*-*-*-*-*-*-*-*-*-*\007"'
3109 alias semifont='echo -en "\033]50;-misc-fixed-medium-r-semicondensed-*-*-120-*-*-*-*-iso8859-15\007"'
3112 #a2# Execute \kbd{du -sch}
3114 #a2# Execute \kbd{jobs -l}
3118 #a2# Execute \kbd{./configure}
3119 alias CO="./configure"
3120 #a2# Execute \kbd{./configure --help}
3121 alias CH="./configure --help"
3124 #a2# Execute \kbd{ls -lSrah}
3125 alias dir="ls -lSrah"
3126 #a2# Only show dot-directories
3127 alias lad='ls -d .*(/)' # only show dot-directories
3128 #a2# Only show dot-files
3129 alias lsa='ls -a .*(.)' # only show dot-files
3130 #a2# Only files with setgid/setuid/sticky flag
3131 alias lss='ls -l *(s,S,t)' # only files with setgid/setuid/sticky flag
3132 #a2# Only show 1st ten symlinks
3133 alias lsl='ls -l *(@)' # only symlinks
3134 #a2# Display only executables
3135 alias lsx='ls -l *(*)' # only executables
3136 #a2# Display world-{readable,writable,executable} files
3137 alias lsw='ls -ld *(R,W,X.^ND/)' # world-{readable,writable,executable} files
3138 #a2# Display the ten biggest files
3139 alias lsbig="ls -flh *(.OL[1,10])" # display the biggest files
3140 #a2# Only show directories
3141 alias lsd='ls -d *(/)' # only show directories
3142 #a2# Only show empty directories
3143 alias lse='ls -d *(/^F)' # only show empty directories
3144 #a2# Display the ten newest files
3145 alias lsnew="ls -rl *(D.om[1,10])" # display the newest files
3146 #a2# Display the ten oldest files
3147 alias lsold="ls -rtlh *(D.om[1,10])" # display the oldest files
3148 #a2# Display the ten smallest files
3149 alias lssmall="ls -Srl *(.oL[1,10])" # display the smallest files
3152 #a2# Execute \kbd{chmod 600}
3153 alias rw-='chmod 600'
3154 #a2# Execute \kbd{chmod 700}
3155 alias rwx='chmod 700'
3156 #m# a2 r-{}- Execute \kbd{chmod 644}
3157 alias r--='chmod 644'
3158 #a2# Execute \kbd{chmod 755}
3159 alias r-x='chmod 755'
3161 # some useful aliases
3162 #a2# Execute \kbd{mkdir -o}
3166 #a2# Execute \kbd{mplayer -vo fbdev}
3167 alias cmplayer='mplayer -vo fbdev'
3168 #a2# Execute \kbd{mplayer -vo fbdev -fs -zoom}
3169 alias fbmplayer='mplayer -vo fbdev -fs -zoom'
3170 #a2# Execute \kbd{links2 -driver fb}
3171 alias fblinks='links2 -driver fb'
3173 #a2# ssh with StrictHostKeyChecking=no \\&\quad and UserKnownHostsFile unset
3174 alias insecssh='ssh -o "StrictHostKeyChecking=no" -o "UserKnownHostsFile=/dev/null"'
3175 alias insecscp='scp -o "StrictHostKeyChecking=no" -o "UserKnownHostsFile=/dev/null"'
3178 check_com -c python && alias http="python -m SimpleHTTPServer"
3180 # Use 'g' instead of 'git':
3181 check_com g || alias g='git'
3183 # work around non utf8 capable software in utf environment via $LANG and luit
3184 if check_com isutfenv && check_com luit ; then
3185 if check_com -c mrxvt ; then
3186 isutfenv && [[ -n "$LANG" ]] && \
3187 alias mrxvt="LANG=${LANG/(#b)(*)[.@]*/$match[1].iso885915} luit mrxvt"
3190 if check_com -c aterm ; then
3191 isutfenv && [[ -n "$LANG" ]] && \
3192 alias aterm="LANG=${LANG/(#b)(*)[.@]*/$match[1].iso885915} luit aterm"
3195 if check_com -c centericq ; then
3196 isutfenv && [[ -n "$LANG" ]] && \
3197 alias centericq="LANG=${LANG/(#b)(*)[.@]*/$match[1].iso885915} luit centericq"
3202 # useful functions {{{
3205 #f4# Search for newspostings from authors
3206 agoogle() { ${=BROWSER} "http://groups.google.com/groups?as_uauthors=$*" ; }
3207 #f4# Search Debian Bug Tracking System
3211 if [[ $# -eq 1 ]]; then
3214 ${=BROWSER} "http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=$1"
3217 ${=BROWSER} "http://bugs.debian.org/cgi-bin/pkgreport.cgi?submitter=$1"
3220 ${=BROWSER} "http://bugs.debian.org/$*"
3224 print "$0 needs one argument"
3228 #f4# Search Debian Bug Tracking System in mbox format
3236 ${=BROWSER} http://search.dmoz.org/cgi-bin/search\?search=${1// /_}
3238 #f4# Search German Wiktionary
3241 ${=BROWSER} http://de.wiktionary.org/wiki/${(C)1// /_}
3243 #f4# Search English Wiktionary
3246 ${=BROWSER} http://en.wiktionary.org/wiki/${(C)1// /_}
3248 #f4# Search Google Groups
3251 ${=BROWSER} "http://groups.google.com/groups?q=$*"
3256 ${=BROWSER} "http://www.google.com/search?&num=100&q=$*"
3258 #f4# Search Google Groups for MsgID
3261 ${=BROWSER} "http://groups.google.com/groups?selm=$*"
3263 #f4# Search Netcraft
3266 ${=BROWSER} "http://toolbar.netcraft.com/site_report?url=$1"
3268 #f4# Use German Wikipedia's full text search
3271 ${=BROWSER} http://de.wikipedia.org/wiki/Spezial:Search/${(C)1}
3273 #f4# search \kbd{dict.leo.org}
3276 ${=BROWSER} "http://dict.leo.org/?search=$*"
3278 #f4# Search German Wikipedia
3281 ${=BROWSER} http://de.wikipedia.org/wiki/"${(C)*}"
3283 #f4# Search English Wikipedia
3286 ${=BROWSER} http://en.wikipedia.org/wiki/"${(C)*}"
3288 #f4# Search official debs
3291 ${=BROWSER} "http://packages.debian.org/search?keywords=$1&searchon=contents&suite=${2:=unstable}§ion=all"
3294 #m# f4 gex() Exact search via Google
3295 check_com google && gex () {
3296 google "\"[ $1]\" $*"
3300 #f5# Backup \kbd{file {\rm to} file\_timestamp}
3303 cp -b $1 $1_`date --iso-8601=m`
3308 diff -crd "$*" | egrep -v "^Only in |^Binary files "
3310 #f5# cd to directoy and list files
3318 cvs add $* && cvs com -m 'initial checkin' $*
3323 cvs diff -N $* |& $PAGER
3328 cvs log $* |& $PAGER
3345 #f5# Disassemble source files using gcc and as
3348 gcc -pipe -S -o - -O -g $* | as -aldh -o /dev/null
3350 #f5# Firefox remote control - open given URL
3352 if [ -e /etc/debian_version ]; then
3353 firefox -a iceweasel -remote "openURL($1)" || firefox ${1}&
3355 firefox -a firefox -remote "openURL($1)" || firefox ${1}&
3358 #f5# Create Directoy and \kbd{cd} to it
3360 mkdir -p "$@" && cd "$@"
3362 #f5# Unified diff to timestamped outputfile
3364 diff -udrP "$1" "$2" > diff.`date "+%Y-%m-%d"`."$1"
3366 #f5# Memory overview
3368 ps aux | awk '{if (NR > 1) print $5; if (NR > 2) print "+"} END { print "p" }' | dc
3370 #f5# Show contents of gzipped tar file
3373 gunzip -c $1 | tar -tf - -- | $PAGER
3375 #f5# Show contents of zip file
3378 unzip -l $1 | $PAGER
3383 diff -urd $* | egrep -v "^Only in |^Binary files "
3385 #f5# (Mis)use \kbd{vim} as \kbd{less}
3388 vim --cmd 'let no_plugin_maps = 1' -c "so \$VIMRUNTIME/macros/less.vim" "${@:--}"
3391 # Function Usage: uopen $URL/$file
3392 #f5# Download a file and display it locally
3395 if ! [[ -n "$1" ]] ; then
3396 print "Usage: uopen \$URL/\$file">&2
3400 MIME=$(curl --head $FILE | grep Content-Type | cut -d ' ' -f 2 | cut -d\; -f 1)
3402 curl $FILE | see ${MIME}:-
3406 # Function Usage: doc packagename
3407 #f5# \kbd{cd} to /usr/share/doc/\textit{package}
3410 cd /usr/share/doc/$1 && ls
3412 _doc() { _files -W /usr/share/doc -/ }
3413 check_com compdef && compdef _doc doc
3415 #f5# Make screenshot
3417 [[ ! -d ~/shots ]] && mkdir ~/shots
3418 #cd ~/shots ; sleep 5 ; import -window root -depth 8 -quality 80 `date "+%Y-%m-%d--%H:%M:%S"`.png
3419 cd ~/shots ; sleep 5; import -window root shot_`date --iso-8601=m`.jpg
3425 images=( *.{jpg,gif,png}(.N) )
3427 if [[ $#images -eq 0 ]] ; then
3428 print "No image files found"
3434 #f5# Create PDF file from source code
3439 a2ps --medium A4dj -E -o $output $*
3443 # zsh with perl-regex - use it e.g. via:
3444 # regcheck '\s\d\.\d{3}\.\d{3} Euro' ' 1.000.000 Euro'
3445 #f5# Checks whether a regex matches or not.\\&\quad Example: \kbd{regcheck '.\{3\} EUR' '500 EUR'}
3448 zmodload -i zsh/pcre
3449 pcre_compile $1 && \
3450 pcre_match $2 && echo "regex matches" || echo "regex does not match"
3453 #f5# List files which have been modified within the last {\it n} days
3459 #f5# Grep in history
3464 # use colors when GNU grep with color-support
3465 #a2# Execute \kbd{grep -{}-color=auto}
3466 (grep --help 2>/dev/null |grep -- --color) >/dev/null && alias grep='grep --color=auto'
3467 #a2# Execute \kbd{grep -i -{}-color=auto}
3468 alias GREP='grep -i --color=auto'
3470 #f5# Watch manpages in a stretched style
3471 man2() { PAGER='dash -c "sed G | /usr/bin/less"' command man "$@" ; }
3473 # d():Copyright 2005 Nikolai Weibull <nikolai@bitwi.se>
3474 # note: option AUTO_PUSHD has to be set
3475 #f5# Jump between directories
3479 local color=$fg_bold[blue]
3481 dirs -p | while read dir; do
3482 local num="${$(printf "%-4d " $i)/ /.}"
3483 printf " %s $color%s$reset_color\n" $num $dir
3487 read -r 'dir?Jump to directory: ' || return
3488 (( dir == -1 )) && return
3489 if (( dir < 0 || dir >= i )); then
3490 echo d: no such directory stack entry: $dir
3496 # usage example: 'lcheck strcpy'
3497 #f5# Find out which libs define a symbol
3499 if [[ -n "$1" ]] ; then
3500 nm -go /usr/lib/lib*.a 2>/dev/null | grep ":[[:xdigit:]]\{8\} . .*$1"
3502 echo "Usage: lcheck <function>" >&2
3506 #f5# Clean up directory - remove well known tempfiles
3508 FILES=(*~(N) .*~(N) \#*\#(N) *.o(N) a.out(N) *.core(N) *.cmo(N) *.cmi(N) .*.swp(N))
3510 if [[ $NBFILES > 0 ]] ; then
3513 echo -n "Remove these files? [y/n] "
3515 if [[ $ans == "y" ]] ; then
3517 echo ">> $PWD purged, $NBFILES files removed"
3519 echo "Ok. .. then not.."
3525 # 'translate' looks up fot a word in a file with language-to-language
3526 # translations (field separator should be " : "). A typical wordlist looks
3528 # | english-word : german-transmission
3529 # It's also only possible to translate english to german but not reciprocal.
3530 # Use the following oneliner to turn back the sort order:
3531 # $ awk -F ':' '{ print $2" : "$1" "$3 }' \
3532 # /usr/local/lib/words/en-de.ISO-8859-1.vok > ~/.translate/de-en.ISO-8859-1.vok
3533 #f5# Translates a word
3538 translate -l de-en $2
3541 translate -l en-de $2
3544 echo "Usage: $0 { -D | -E }"
3545 echo " -D == German to English"
3546 echo " -E == English to German"
3550 #f5# List all occurrences of programm in current PATH
3553 if [[ $# = 0 ]] ; then
3554 echo "Usage: $0 program"
3555 echo "Example: $0 zsh"
3556 echo "Lists all occurrences of program in the current PATH."
3558 ls -l ${^path}/*$1*(*N)
3562 # Found in the mailinglistarchive from Zsh (IIRC ~1996)
3563 #f5# Select items for specific command(s) from history
3568 echo "Usage: $0 command"
3571 cmd=(${(f)"$(grep -w $1 $HISTFILE | sort | uniq | pr -tn)"})
3572 print -l $cmd | less -F
3573 echo -n "enter number of desired command [1 - $(( ${#cmd[@]} - 1 ))]: "
3576 print -z "${cmd[$answer]#*$TAB}"
3579 # Use vim to convert plaintext to HTML
3580 #f5# Transform files to html with highlighting
3583 vim -u NONE -n -c ':syntax on' -c ':so $VIMRUNTIME/syntax/2html.vim' -c ':wqa' $1 &>/dev/null
3586 # Usage: simple-extract <file>
3587 #f5# Smart archive extractor
3590 if [[ -f $1 ]] ; then
3592 *.tar.bz2) bzip2 -v -d $1 ;;
3593 *.tar.gz) tar -xvzf $1 ;;
3596 *.bz2) bzip2 -d $1 ;;
3598 *.gz) gunzip -d $1 ;;
3599 *.tar) tar -xvf $1 ;;
3600 *.tgz) gunzip -d $1 ;;
3601 *.tbz2) tar -jxvf $1 ;;
3603 *.Z) uncompress $1 ;;
3604 *) echo "'$1' Error. Please go away" ;;
3607 echo "'$1' is not a valid file"
3611 # Usage: smartcompress <file> (<type>)
3612 #f5# Smart archive creator
3615 if [[ -n $2 ]] ; then
3617 tgz | tar.gz) tar -zcvf$1.$2 $1 ;;
3618 tbz2 | tar.bz2) tar -jcvf$1.$2 $1 ;;
3619 tar.Z) tar -Zcvf$1.$2 $1 ;;
3620 tar) tar -cvf$1.$2 $1 ;;
3621 gz | gzip) gzip $1 ;;
3622 bz2 | bzip2) bzip2 $1 ;;
3624 echo "Error: $2 is not a valid compression type"
3628 smartcompress $1 tar.gz
3632 # Usage: show-archive <archive>
3633 #f5# List an archive's content
3636 if [[ -f $1 ]] ; then
3638 *.tar.gz) gunzip -c $1 | tar -tf - -- ;;
3639 *.tar) tar -tf $1 ;;
3640 *.tgz) tar -ztf $1 ;;
3641 *.zip) unzip -l $1 ;;
3643 *.deb) dpkg-deb --fsys-tarfile $1 | tar -tf - -- ;;
3644 *) echo "'$1' Error. Please go away" ;;
3647 echo "'$1' is not a valid archive"
3651 # It's shameless stolen from <http://www.vim.org/tips/tip.php?tip_id=167>
3652 #f5# Use \kbd{vim} as your manpage reader
3655 man $* | col -b | view -c 'set ft=man nomod nolist' -
3658 # function readme() { $PAGER -- (#ia3)readme* }
3659 #f5# View all README-like files in current directory in pager
3663 files=(./(#i)*(read*me|lue*m(in|)ut)*(ND))
3664 if (($#files)) ; then
3667 print 'No README files.'
3671 # function ansi-colors()
3672 #f5# Display ANSI colors
3674 typeset esc="\033[" line1 line2
3675 echo " _ _ _40 _ _ _41_ _ _ _42 _ _ 43_ _ _ 44_ _ _45 _ _ _ 46_ _ _ 47_ _ _ 49_ _"
3676 for fore in 30 31 32 33 34 35 36 37; do
3679 for back in 40 41 42 43 44 45 46 47 49; do
3680 line1="${line1}${esc}${back};${fore}m Normal ${esc}0m"
3681 line2="${line2}${esc}${back};${fore};1m Bold ${esc}0m"
3683 echo -e "$line1\n$line2"
3687 #f5# Find all files in \$PATH with setuid bit set
3688 suidfind() { ls -latg $path | grep '^...s' }
3690 # TODO: So, this is the third incarnation of this function!?
3691 #f5# Reload given functions
3693 for func in $argv ; do
3699 # a small check to see which DIR is located on which server/partition.
3700 # stolen and modified from Sven's zshrc.forall
3701 #f5# Report diskusage of a directory
3704 if [[ -n "$1" ]] ; then
3705 for dir in "$@" ; do
3706 if [[ -d "$dir" ]] ; then
3707 ( cd $dir; echo "-<$dir>"; du -shx .; echo);
3709 echo "warning: $dir does not exist" >&2
3713 for dir in $path; do
3714 if [[ -d "$dir" ]] ; then
3715 ( cd $dir; echo "-<$dir>"; du -shx .; echo);
3717 echo "warning: $dir does not exist" >&2
3723 # % slow_print `cat /etc/passwd`
3724 #f5# Slowly print out parameters
3726 for argument in "$@" ; do
3727 for ((i = 1; i <= ${#1} ;i++)) ; do
3728 print -n "${argument[i]}"
3736 #f5# Show some status info
3739 print "Date..: "$(date "+%Y-%m-%d %H:%M:%S")
3740 print "Shell.: Zsh $ZSH_VERSION (PID = $$, $SHLVL nests)"
3741 print "Term..: $TTY ($TERM), ${BAUD:+$BAUD bauds, }$COLUMNS x $LINES chars"
3742 print "Login.: $LOGNAME (UID = $EUID) on $HOST"
3743 print "System: $(cat /etc/[A-Za-z]*[_-][rv]e[lr]*)"
3744 print "Uptime:$(uptime)"
3749 #f5# Rip an audio CD
3753 cdrdao read-cd --device $DEVICE --driver generic-mmc audiocd.toc
3754 cdrdao read-cddb --device $DEVICE --driver generic-mmc audiocd.toc
3755 echo " * Would you like to burn the cd now? (yes/no)"
3757 if [[ "$input" = "yes" ]] ; then
3758 echo " ! Burning Audio CD"
3762 echo " ! Invalid response."
3767 #f5# Burn an audio CD (in combination with audiorip)
3770 cdrdao write --device $DEVICE --driver generic-mmc audiocd.toc
3771 echo " * Should I remove the temporary files? (yes/no)"
3773 if [[ "$input" = "yes" ]] ; then
3774 echo " ! Removing Temporary Files."
3779 echo " ! Invalid response."
3783 #f5# Make an audio CD from all mp3 files
3785 # TODO: do the renaming more zshish, possibly with zmv()
3788 for i in *.[Mm][Pp]3; do mv "$i" `echo $i | tr '[A-Z]' '[a-z]'`; done
3789 for i in *.mp3; do mv "$i" `echo $i | tr ' ' '_'`; done
3790 for i in *.mp3; do mpg123 -w `basename $i .mp3`.wav $i; done
3792 for i in *.wav; do sox $i.wav -r 44100 $i.wav resample; done
3795 #f5# Create an ISO image. You are prompted for\\&\quad volume name, filename and directory
3798 echo " * Volume name "
3800 echo " * ISO Name (ie. tmp.iso)"
3802 echo " * Directory or File"
3804 mkisofs -o ~/$iso -A $volume -allow-multidot -J -R -iso-level 3 -V $volume -R $files
3807 #f5# Simple thumbnails generator
3809 rm -rf thumb-* index.html
3813 <title>Images</title>
3815 <body>" > index.html
3816 for f in *.(gif|jpeg|jpg|png) ; do
3817 convert -size 100x200 "$f" -resize 100x200 thumb-"$f"
3818 echo " <a href=\"$f\"><img src=\"thumb-$f\"></a>" >> index.html
3822 </html>" >> index.html
3825 #f5# Set all ulimit parameters to \kbd{unlimited}
3836 # ogg2mp3 with bitrate of 192
3839 oggdec -o - $1 | lame -b 192 - ${1:r}.mp3
3842 #f5# RFC 2396 URL encoding in Z-Shell
3847 print ${(j::)input/(#b)([^A-Za-z0-9_.!~*\'\(\)-])/%${(l:2::0:)$(([##16]#match))}}
3850 #f5# Install x-lite (VoIP software)
3854 [[ -d ~/tmp ]] || mkdir ~/tmp
3857 echo "Downloading http://www.counterpath.com/download/X-Lite_Install.tar.gz and storing it in ~/tmp:"
3858 if wget http://www.counterpath.com/download/X-Lite_Install.tar.gz ; then
3859 unp X-Lite_Install.tar.gz && echo done || echo failed
3861 echo "Error while downloading." ; return 1
3864 if [[ -x xten-xlite/xtensoftphone ]] ; then
3865 echo "Execute xten-xlite/xtensoftphone to start xlite."
3873 echo "Downloading debian package of skype."
3874 echo "Notice: If you want to use a more recent skype version run 'getskypebeta'."
3875 wget http://www.skype.com/go/getskype-linux-deb
3876 $SUDO dpkg -i skype*.deb && echo "skype installed."
3879 #f5# Install beta-version of skype
3883 echo "Downloading debian package of skype (beta version)."
3884 wget http://www.skype.com/go/getskype-linux-beta-deb
3885 $SUDO dpkg -i skype-beta*.deb && echo "skype installed."
3888 #f5# Install gizmo (VoIP software)
3892 echo "libgtk2.0-0, gconf2, libstdc++6, libasound2 and zlib1g have to be available. Installing."
3893 $SUDO apt-get update
3894 $SUDO apt-get install libgtk2.0-0 gconf2 libstdc++6 libasound2 zlib1g
3895 wget "$(lynx --dump http://gizmo5.com/pc/download/linux/ | awk '/libstdc\+\+6.*\.deb/ {print $2}')"
3896 $SUDO dpkg -i gizmo-project*.deb && echo "gizmo installed."
3899 #f5# Get and run AIR (Automated Image and Restore)
3903 [[ -w . ]] || { echo 'Error: you do not have write permissions in this directory. Exiting.' ; return 1 }
3905 wget http://puzzle.dl.sourceforge.net/sourceforge/air-imager/air-$VER.tar.gz
3906 tar zxf air-$VER.tar.gz
3908 INTERACTIVE=no $SUDO ./install-air-1.2.8
3909 [[ -x /usr/local/bin/air ]] && [[ -n "$DISPLAY" ]] && $SUDO air
3912 #f5# Get specific git commitdiff
3915 if [[ -z $GITTREE ]] ; then
3916 GITTREE='linux/kernel/git/torvalds/linux-2.6.git'
3918 if ! [[ -z $1 ]] ; then
3919 ${=BROWSER} "http://kernel.org/git/?p=$GITTREE;a=commitdiff;h=$1"
3921 echo "Usage: git-get-diff <commit>"
3925 #f5# Get specific git commit
3928 if [[ -z $GITTREE ]] ; then
3929 GITTREE='linux/kernel/git/torvalds/linux-2.6.git'
3931 if ! [[ -z $1 ]] ; then
3932 ${=BROWSER} "http://kernel.org/git/?p=$GITTREE;a=commit;h=$1"
3934 echo "Usage: git-get-commit <commit>"
3938 #f5# Get specific git diff
3939 git-get-plaindiff () {
3941 if [[ -z $GITTREE ]] ; then
3942 GITTREE='linux/kernel/git/torvalds/linux-2.6.git'
3944 if [[ -z $1 ]] ; then
3945 echo 'Usage: git-get-plaindiff '
3947 echo -n "Downloading $1.diff ... "
3948 # avoid "generating ..." stuff from kernel.org server:
3949 wget --quiet "http://kernel.org/git/?p=$GITTREE;a=commitdiff_plain;h=$1" -O /dev/null
3950 wget --quiet "http://kernel.org/git/?p=$GITTREE;a=commitdiff_plain;h=$1" -O $1.diff \
3951 && echo done || echo failed
3956 # http://strcat.de/blog/index.php?/archives/335-Software-sauber-deinstallieren...html
3957 #f5# Log 'make install' output
3960 [[ ! -d ~/.errorlogs ]] && mkdir ~/.errorlogs
3961 make -n install > ~/.errorlogs/${PWD##*/}-makelog
3964 #f5# Indent source code
3966 indent -npro -kr -i8 -ts8 -sob -l80 -ss -ncs "$@"
3969 # highlight important stuff in diff output, usage example: hg diff | hidiff
3970 #m# a2 hidiff \kbd{histring} oneliner for diffs
3971 check_com -c histring && \
3972 alias hidiff="histring -fE '^Comparing files .*|^diff .*' | histring -c yellow -fE '^\-.*' | histring -c green -fE '^\+.*'"
3974 # rename pictures based on information found in exif headers
3975 #f5# Rename pictures based on information found in exif headers
3978 if [[ $# -lt 1 ]] ; then
3979 echo 'Usage: jpgrename $FILES' >& 2
3982 echo -n 'Checking for jhead with version newer than 1.9: '
3983 jhead_version=`jhead -h | grep 'used by most Digital Cameras. v.*' | awk '{print $6}' | tr -d v`
3984 if [[ $jhead_version > '1.9' ]]; then
3985 echo 'success - now running jhead.'
3986 jhead -n%Y-%m-%d_%Hh%M_%f $*
3988 echo 'failed - exiting.'
3993 # get_ic() - queries imap servers for capabilities; real simple. no imaps
3997 if [[ ! -z $1 ]] ; then
3999 print "querying imap server on $1:${port}...\n";
4000 print "a1 capability\na2 logout\n" | nc $1 ${port}
4002 print "usage:\n $0 <imap-server> [port]"
4006 # creates a Maildir/ with its {new,cur,tmp} subdirs
4010 root=${MAILDIR_ROOT:-${HOME}/Mail}
4011 if [[ -z ${1} ]] ; then print "Usage:\n $0 <dirname>" ; return 1 ; fi
4013 mkdir -p ${root}/${subdir}/{cur,new,tmp}
4016 #f5# Change the xterm title from within GNU-screen
4019 if [[ $1 != "-f" ]] ; then
4020 if [[ -z ${DISPLAY} ]] ; then
4021 printf 'xtrename only makes sense in X11.\n'
4027 if [[ -z $1 ]] ; then
4028 printf 'usage: xtrename [-f] "title for xterm"\n'
4029 printf ' renames the title of xterm from _within_ screen.\n'
4030 printf ' also works without screen.\n'
4031 printf ' will not work if DISPLAY is unset, use -f to override.\n'
4034 print -n "\eP\e]0;${1}\C-G\e\\"
4038 # hl() highlighted less
4039 # http://ft.bewatermyfriend.org/comp/data/zsh/zfunct.html
4040 if check_com -c highlight ; then
4044 theme=${HL_THEME:-""}
4047 ( printf 'available languages (syntax parameter):\n\n' ;
4048 highlight --list-langs ; ) | less -SMr
4051 ( printf 'available themes (style parameter):\n\n' ;
4052 highlight --list-themes ; ) | less -SMr
4055 printf 'usage: hl <syntax[:theme]> <file>\n'
4056 printf ' available options: --list (-l), --themes (-t), --help (-h)\n\n'
4057 printf ' Example: hl c main.c\n'
4060 if [[ -z ${2} ]] || (( ${#argv} > 2 )) ; then
4061 printf 'usage: hl <syntax[:theme]> <file>\n'
4062 printf ' available options: --list (-l), --themes (-t), --help (-h)\n'
4063 (( ${#argv} > 2 )) && printf ' Too many arguments.\n'
4067 [[ ${1} == *:* ]] && [[ -n ${1#*:} ]] && theme=${1#*:}
4068 if [[ -n ${theme} ]] ; then
4069 highlight --xterm256 --syntax ${lang} --style ${theme} ${2} | less -SMr
4071 highlight --ansi --syntax ${lang} ${2} | less -SMr
4077 # ... and a proper completion for hl()
4078 # needs 'highlight' as well, so it fits fine in here.
4079 function _hl_genarg() {
4081 if [[ -prefix 1 *: ]] ; then
4083 themes=(${${${(f)"$(LC_ALL=C highlight --list-themes)"}/ #/}:#*(Installed|Use name)*})
4085 _wanted -C list themes expl theme compadd ${themes}
4088 langs=(${${${(f)"$(LC_ALL=C highlight --list-langs)"}/ #/}:#*(Installed|Use name)*})
4089 _wanted -C list languages expl languages compadd -S ':' -q ${langs}
4092 function _hl_complete() {
4093 _arguments -s '1: :_hl_genarg' '2:files:_path_files'
4095 compdef _hl_complete hl
4098 # Create small urls via http://tinyurl.com using wget(1).
4101 [[ -z $1 ]] && { print "USAGE: zurl <URL>" ; return 1 }
4103 local PN url tiny grabber search result preview
4106 # Check existence of given URL with the help of ping(1).
4107 # N.B. ping(1) only works without an eventual given protocol.
4108 ping -c 1 ${${url#(ftp|http)://}%%/*} >& /dev/null || \
4109 read -q "?Given host ${${url#http://*/}%/*} is not reachable by pinging. Proceed anyway? [y|n] "
4111 if (( $? == 0 )) ; then
4112 # Prepend 'http://' to given URL where necessary for later output.
4113 [[ ${url} != http(s|)://* ]] && url='http://'${url}
4114 tiny='http://tinyurl.com/create.php?url='
4115 if check_com -c wget ; then
4116 grabber='wget -O- -o/dev/null'
4118 print "wget is not available, but mandatory for ${PN}. Aborting."
4120 # Looking for i.e.`copy('http://tinyurl.com/7efkze')' in TinyURL's HTML code.
4121 search='copy\(?http://tinyurl.com/[[:alnum:]]##*'
4122 result=${(M)${${${(f)"$(${=grabber} ${tiny}${url})"}[(fr)${search}*]}//[()\';]/}%%http:*}
4123 # TinyURL provides the rather new feature preview for more confidence. <http://tinyurl.com/preview.php>
4124 preview='http://preview.'${result#http://}
4126 printf '%s\n\n' "${PN} - Shrinking long URLs via webservice TinyURL <http://tinyurl.com>."
4127 printf '%s\t%s\n\n' 'Given URL:' ${url}
4128 printf '%s\t%s\n\t\t%s\n' 'TinyURL:' ${result} ${preview}
4134 #f2# Print a specific line of file(s).
4138 if [ $# -lt 2 ] ; then
4139 print "Usage: linenr <number>[,<number>] <file>" ; return 1
4140 elif [ $# -eq 2 ] ; then
4143 command ed -s $file <<< "${number}n"
4147 for file in "$@" ; do
4148 if [ ! -d $file ] ; then
4150 command ed -s $file <<< "${number}n" 2> /dev/null
4159 #f2# Find history events by search pattern and list them by date.
4163 local usage help ident format_l format_s first_char remain first last
4164 usage='USAGE: whatwhen [options] <searchstring> <search range>'
4165 help='Use' \`'whatwhen -h'\'' for further explanations.'
4166 ident=${(l,${#${:-Usage: }},, ,)}
4167 format_l="${ident}%s\t\t\t%s\n"
4168 format_s="${format_l//(\\t)##/\\t}"
4169 # Make the first char of the word to search for case
4170 # insensitive; e.g. [aA]
4171 first_char=[${(L)1[1]}${(U)1[1]}]
4173 # Default search range is `-100'.
4175 # Optional, just used for `<first> <last>' given.
4179 printf '%s\n\n' 'ERROR: No search string specified. Aborting.'
4180 printf '%s\n%s\n\n' ${usage} ${help} && return 1
4183 printf '%s\n\n' ${usage}
4185 printf $format_l '-h' 'show help text'
4187 print 'SEARCH RANGE:'
4188 printf $format_l "'0'" 'the whole history,'
4189 printf $format_l '-<n>' 'offset to the current history number; (default: -100)'
4190 printf $format_s '<[-]first> [<last>]' 'just searching within a give range'
4191 printf '\n%s\n' 'EXAMPLES:'
4192 printf ${format_l/(\\t)/} 'whatwhen grml' '# Range is set to -100 by default.'
4193 printf $format_l 'whatwhen zsh -250'
4194 printf $format_l 'whatwhen foo 1 99'
4197 printf '%s\n%s\n\n' ${usage} ${help} && return 1
4200 # -l list results on stout rather than invoking $EDITOR.
4201 # -i Print dates as in YYYY-MM-DD.
4202 # -m Search for a - quoted - pattern within the history.
4203 fc -li -m "*${first_char}${remain}*" $first $last
4209 # change fluxbox keys from 'Alt-#' to 'Alt-F#' and vice versa
4212 [[ -n "$FLUXKEYS" ]] || local FLUXKEYS="$HOME/.fluxbox/keys"
4213 if ! [[ -r "$FLUXKEYS" ]] ; then
4214 echo "Sorry, \$FLUXKEYS file $FLUXKEYS could not be read - nothing to be done."
4217 if grep -q 'Mod1 F[0-9] :Workspace [0-9]' $FLUXKEYS ; then
4218 echo -n 'Switching to Alt-# mode in ~/.fluxbox/keys: '
4219 sed -i -e 's|^\(Mod[0-9]\+[: space :]\+\)F\([0-9]\+[: space :]\+:Workspace.*\)|\1\2|' $FLUXKEYS && echo done || echo failed
4220 elif grep -q 'Mod1 [0-9] :Workspace [0-9]' $FLUXKEYS ; then
4221 echo -n 'Switching to Alt-F# mode in ~/.fluxbox/keys: '
4222 sed -i -e 's|^\(Mod[0-9]\+[: space :]\+\)\([0-9]\+[: space :]\+:Workspace.*\)|\1F\2|' $FLUXKEYS && echo done || echo failed
4224 echo 'Sorry, do not know what to do.'
4230 # retrieve weather information on the console
4231 # Usage example: 'weather LOWG'
4235 print 'Usage: weather <station_id>' >&2
4236 print 'List of stations: http://en.wikipedia.org/wiki/List_of_airports_by_ICAO_code'>&2
4240 local PLACE="${1:u}"
4241 local FILE="$HOME/.weather/$PLACE"
4242 local LOG="$HOME/.weather/log"
4244 [[ -d $HOME/.weather ]] || {
4245 print -n "Creating $HOME/.weather: "
4246 mkdir $HOME/.weather
4250 print "Retrieving information for ${PLACE}:"
4252 wget -T 10 --no-verbose --output-file=$LOG --output-document=$FILE --timestamping http://weather.noaa.gov/pub/data/observations/metar/decoded/$PLACE.TXT
4254 if [[ $? -eq 0 ]] ; then
4255 if [[ -n "$VERBOSE" ]] ; then
4258 DATE=$(grep 'UTC' $FILE | sed 's#.* /##')
4259 TEMPERATURE=$(awk '/Temperature/ { print $4" degree Celcius / " $2" degree Fahrenheit" }' $FILE| tr -d '(')
4261 echo "temp: $TEMPERATURE"
4264 print "There was an error retrieving the weather information for $PLACE" >&2
4271 # mercurial related stuff {{{
4272 if check_com -c hg ; then
4273 # gnu like diff for mercurial
4274 # http://www.selenic.com/mercurial/wiki/index.cgi/TipsAndTricks
4275 #f5# GNU like diff for mercurial
4278 for i in $(hg status -marn "$@") ; diff -ubwd <(hg cat "$i") "$i"
4281 # build debian package
4282 #a2# Alias for \kbd{hg-buildpackage}
4283 alias hbp='hg-buildpackage'
4285 # execute commands on the versioned patch-queue from the current repos
4286 alias mq='hg -R $(readlink -f $(hg root)/.hg/patches)'
4288 # diffstat for specific version of a mercurial repository
4289 # hgstat => display diffstat between last revision and tip
4290 # hgstat 1234 => display diffstat between revision 1234 and tip
4291 #f5# Diffstat for specific version of a mercurial repos
4294 [[ -n "$1" ]] && hg diff -r $1 -r tip | diffstat || hg export tip | diffstat
4297 #f5# Get current mercurial tip via hg itself
4301 if [[ -f mercurial-tree/.hg ]] ; then
4303 echo "Running hg pull for retreiving latest version..."
4305 echo "Finished update. Building mercurial"
4307 echo "Setting \$PATH to $PWD:\$PATH..."
4308 export PATH="$PWD:$PATH"
4310 echo "Downloading mercurial via hg"
4311 hg clone http://selenic.com/repo/hg mercurial-tree
4313 echo "Building mercurial"
4315 echo "Setting \$PATH to $PWD:\$PATH..."
4316 export PATH="$PWD:$PATH"
4317 echo "make sure you set it permanent via ~/.zshrc if you plan to use it permanently."
4318 # echo "Setting \$PYTHONPATH to PYTHONPATH=\${HOME}/lib/python,"
4319 # export PYTHONPATH=${HOME}/lib/python
4323 fi # end of check whether we have the 'hg'-executable
4325 # get current mercurial snapshot
4326 #f5# Get current mercurial snapshot
4330 if [[ -f mercurial-snapshot.tar.gz ]] ; then
4331 echo "mercurial-snapshot.tar.gz exists already, skipping download."
4333 echo "Downloading mercurial snapshot"
4334 wget http://www.selenic.com/mercurial/mercurial-snapshot.tar.gz
4336 echo "Unpacking mercurial-snapshot.tar.gz"
4337 tar zxf mercurial-snapshot.tar.gz
4338 cd mercurial-snapshot/
4339 echo "Installing required build-dependencies"
4340 $SUDO apt-get update
4341 $SUDO apt-get install python2.4-dev
4342 echo "Building mercurial"
4344 echo "Setting \$PATH to $PWD:\$PATH..."
4345 export PATH="$PWD:$PATH"
4346 echo "make sure you set it permanent via ~/.zshrc if you plan to use it permanently."
4350 # some useful commands often hard to remember - let's grep for them {{{
4351 # actually use our zg() function now. :)
4353 # Work around ion/xterm resize bug.
4354 #if [[ "$SHLVL" -eq 1 ]]; then
4355 # if check_com -c resize ; then
4356 # eval `resize </dev/null`
4361 # /usr/bin/jackd -dalsa -dhw:0 -r48000 -p1024 -n2
4362 # now play audio file:
4363 # alsaplayer -o jack foobar.mp3
4365 # send files via netcat
4367 # send() {j=$*; tar cpz ${j/%${!#}/}|nc -w 1 ${!#} 51330;}
4369 # alias receive='nc -vlp 51330 | tar xzvp'
4372 # dh_make -e foo@localhost -f $1
4373 # dpkg-buildpackage -rfakeroot
4375 # dpkg-scanpackages ./ /dev/null | gzip > Packages.gz
4376 # dpkg-scansources . | gzip > Sources.gz
4377 # grep-dctrl --field Maintainer $* /var/lib/apt/lists/*
4380 # convert -geometry 200x200 -interlace LINE -verbose
4381 # ldapsearch -x -b "OU=Bedienstete,O=tug" -h ldap.tugraz.at sn=$1
4382 # ps -ao user,pcpu,start,command
4383 # gpg --keyserver blackhole.pca.dfn.de --recv-keys
4384 # xterm -bg black -fg yellow -fn -misc-fixed-medium-r-normal--14-140-75-75-c-90-iso8859-15 -ah
4385 # nc -vz $1 1-1024 # portscan via netcat
4386 # wget --mirror --no-parent --convert-links
4388 # autoload -U tetris; zle -N tetris; bindkey '...' ; echo "press ... for playing tennis"
4390 # modify console cursor
4391 # see http://www.tldp.org/HOWTO/Framebuffer-HOWTO-5.html
4392 # print $'\e[?96;0;64c'
4395 # grml-small cleanups {{{
4397 # The following is used to remove zsh-config-items that do not work
4398 # in grml-small by default.
4399 # If you do not want these adjustments (for whatever reason), set
4400 # $GRMLSMALL_SPECIFIC to 0 in your .zshrc.pre file (which this configuration
4401 # sources if it is there).
4403 if (( GRMLSMALL_SPECIFIC > 0 )) && isgrmlsmall ; then
4406 unalias 'V' &> /dev/null
4407 unfunction vman &> /dev/null
4408 unfunction viless &> /dev/null
4409 unfunction 2html &> /dev/null
4411 # manpages are not in grmlsmall
4412 unfunction manzsh &> /dev/null
4413 unfunction man2 &> /dev/null
4421 ## genrefcard.pl settings {{{
4423 ### doc strings for external functions from files
4424 #m# f5 grml-wallpaper() Sets a wallpaper (try completion for possible values)
4426 ### example: split functions-search 8,16,24,32
4427 #@# split functions-search 8
4431 ## END OF FILE #################################################################
4432 # vim:filetype=zsh foldmethod=marker autoindent expandtab shiftwidth=4