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 == <5->* ]] && return 0
141 #f1# Checks whether or not you're running grml
143 [[ -f /etc/grml_version ]] && return 0
147 #f1# Checks whether or not you're running a grml cd
149 [[ -f /etc/grml_cd ]] && return 0
154 #f1# Checks whether or not you're running grml-small
156 [[ ${${${(f)"$(</etc/grml_version)"}%% *}##*-} == 'small' ]] && return 0 ; return 1
159 isgrmlsmall() { return 1 }
163 [[ $OSTYPE == darwin* ]] && return 0
167 #f1# are we running within an utf environment?
169 case "$LANG $CHARSET $LANGUAGE" in
176 # check for user, if not running as root set $SUDO to sudo
177 (( EUID != 0 )) && SUDO='sudo' || SUDO=''
179 # change directory to home on first invocation of zsh
180 # important for rungetty -> autologin
181 # Thanks go to Bart Schaefer!
182 isgrml && checkhome() {
183 if [[ -z "$ALREADY_DID_CD_HOME" ]] ; then
184 export ALREADY_DID_CD_HOME=$HOME
189 # check for zsh v3.1.7+
191 if ! [[ ${ZSH_VERSION} == 3.1.<7->* \
192 || ${ZSH_VERSION} == 3.<2->.<->* \
193 || ${ZSH_VERSION} == <4->.<->* ]] ; then
196 printf '-!- In this configuration we try to make use of features, that only\n'
197 printf '-!- require version 3.1.7 of the shell; That way this setup can be\n'
198 printf '-!- used with a wide range of zsh versions, while using fairly\n'
199 printf '-!- advanced features in all supported versions.\n'
201 printf '-!- However, you are running zsh version %s.\n' "$ZSH_VERSION"
203 printf '-!- While this *may* work, it might as well fail.\n'
204 printf '-!- Please consider updating to at least version 3.1.7 of zsh.\n'
206 printf '-!- DO NOT EXPECT THIS TO WORK FLAWLESSLY!\n'
207 printf '-!- If it does today, you'\''ve been lucky.\n'
209 printf '-!- Ye been warned!\n'
212 function zstyle() { : }
215 # autoload wrapper - use this one instead of autoload directly
216 # We need to define this function as early as this, because autoloading
217 # 'is-at-least()' needs it.
218 function zrcautoload() {
226 for fdir in ${fpath} ; do
227 [[ -e ${fdir}/${ffile} ]] && (( ffound = 1 ))
230 (( ffound == 0 )) && return 1
231 if [[ $ZSH_VERSION == 3.1.<6-> || $ZSH_VERSION == <4->* ]] ; then
232 autoload -U ${ffile} || return 1
234 autoload ${ffile} || return 1
239 # Load is-at-least() for more precise version checks
240 # Note that this test will *always* fail, if the is-at-least
241 # function could not be marked for autoloading.
242 zrcautoload is-at-least || is-at-least() { return 1 }
246 # {{{ set some important options (as early as possible)
247 # Please update these tags, if you change the umask settings below.
249 #o# r_umaskstr rwxrwxr-x
251 #o# umaskstr rwxr-xr-x
252 (( EUID != 0 )) && umask 002 || umask 022
254 setopt append_history # append history list to the history file (important for multiple parallel zsh sessions!)
255 is4 && setopt SHARE_HISTORY # import new commands from the history file also in other zsh-session
256 setopt extended_history # save each command's beginning timestamp and the duration to the history file
257 is4 && setopt histignorealldups # If a new command line being added to the history
258 # list duplicates an older one, the older command is removed from the list
259 setopt histignorespace # remove command lines from the history list when
260 # the first character on the line is a space
261 setopt auto_cd # if a command is issued that can't be executed as a normal command,
262 # and the command is the name of a directory, perform the cd command to that directory
263 setopt extended_glob # in order to use #, ~ and ^ for filename generation
264 # grep word *~(*.gz|*.bz|*.bz2|*.zip|*.Z) ->
265 # -> searches for word not in compressed files
266 # don't forget to quote '^', '~' and '#'!
267 setopt longlistjobs # display PID when suspending processes as well
268 setopt notify # report the status of backgrounds jobs immediately
269 setopt hash_list_all # Whenever a command completion is attempted, make sure \
270 # the entire command path is hashed first.
271 setopt completeinword # not just at the end
272 setopt nohup # and don't kill them, either
273 setopt auto_pushd # make cd push the old directory onto the directory stack.
274 setopt nonomatch # try to avoid the 'zsh: no matches found...'
275 setopt nobeep # avoid "beep"ing
276 setopt pushd_ignore_dups # don't push the same dir twice.
277 setopt noglobdots # * shouldn't match dotfiles. ever.
278 setopt noshwordsplit # use zsh style word splitting
282 # setting some default values {{{
286 NOPRECMD=${NOPRECMD:-0}
287 COMMAND_NOT_FOUND=${COMMAND_NOT_FOUND:-0}
288 GRML_ZSH_CNF_HANDLER=${GRML_ZSH_CNF_HANDLER:-/usr/share/command-not-found/command-not-found}
289 BATTERY=${BATTERY:-0}
290 GRMLSMALL_SPECIFIC=${GRMLSMALL_SPECIFIC:-1}
291 GRML_ALWAYS_LOAD_ALL=${GRML_ALWAYS_LOAD_ALL:-0}
292 ZSH_NO_DEFAULT_LOCALE=${ZSH_NO_DEFAULT_LOCALE:-0}
296 # utility functions {{{
297 # this function checks if a command exists and returns either true
298 # or false. This avoids using 'which' and 'whence', which will
299 # avoid problems with aliases for which on certain weird systems. :-)
300 # Usage: check_com [-c|-g] word
301 # -c only checks for external commands
302 # -g does the usual tests and also checks for global aliases
305 local -i comonly gatoo
307 if [[ $1 == '-c' ]] ; then
310 elif [[ $1 == '-g' ]] ; then
317 if (( ${#argv} != 1 )) ; then
318 printf 'usage: check_com [-c] <command>\n' >&2
322 if (( comonly > 0 )) ; then
323 [[ -n ${commands[$1]} ]] && return 0
327 if [[ -n ${commands[$1]} ]] \
328 || [[ -n ${functions[$1]} ]] \
329 || [[ -n ${aliases[$1]} ]] \
330 || [[ -n ${reswords[(r)$1]} ]] ; then
335 if (( gatoo > 0 )) && [[ -n ${galiases[$1]} ]] ; then
342 # creates an alias and precedes the command with
343 # sudo if $EUID is not zero.
346 local only=0 ; local multi=0
347 while [[ $1 == -* ]] ; do
351 (--) shift ; break ;;
353 printf 'usage: salias [-h|-o|-a] <alias-expression>\n'
354 printf ' -h shows this help text.\n'
355 printf ' -a replace '\'' ; '\'' sequences with '\'' ; sudo '\''.\n'
356 printf ' be careful using this option.\n'
357 printf ' -o only sets an alias if a preceding sudo would be needed.\n'
360 (*) printf "unkown option: '%s'\n" "$1" ; return 1 ;;
365 if (( ${#argv} > 1 )) ; then
366 printf 'Too many arguments %s\n' "${#argv}"
370 key="${1%%\=*}" ; val="${1#*\=}"
371 if (( EUID == 0 )) && (( only == 0 )); then
372 alias -- "${key}=${val}"
373 elif (( EUID > 0 )) ; then
374 (( multi > 0 )) && val="${val// ; / ; sudo }"
375 alias -- "${key}=sudo ${val}"
381 # a "print -l ${(u)foo}"-workaround for pre-4.2.0 shells
383 # Where foo is the *name* of the parameter you want printed.
384 # Note that foo is no typo; $foo would be wrong here!
392 if [[ -z ${parameter} ]] ; then
393 printf 'usage: uprint <parameter>\n'
397 for w in ${(P)parameter} ; do
398 [[ -z ${(M)u:#$w} ]] && u=( $u $w )
405 # Check if we can read given files and source those we can.
408 if (( ${#argv} < 1 )) ; then
409 printf 'usage: xsource FILE(s)...\n' >&2
413 while (( ${#argv} > 0 )) ; do
414 [[ -r $1 ]] && source $1
420 # Check if we can read a given file and 'cat(1)' it.
423 if (( ${#argv} != 1 )) ; then
424 printf 'usage: xcat FILE\n' >&2
428 [[ -r $1 ]] && cat $1
432 # Remove these functions again, they are of use only in these
433 # setup files. This should be called at the end of .zshrc.
437 funcs=(salias xcat xsource xunfunction zrcautoload)
439 for func in $funcs ; do
440 [[ -n ${functions[$func]} ]] \
446 # this allows us to stay in sync with grml's zshrc and put own
447 # modifications in ~/.zshrc.local
449 xsource "/etc/zsh/zshrc.local"
450 xsource "${HOME}/.zshrc.local"
457 if (( ZSH_NO_DEFAULT_LOCALE == 0 )); then
458 xsource "/etc/default/locale"
461 for var in LANG LC_ALL LC_MESSAGES ; do
462 [[ -n ${(P)var} ]] && export $var
465 xsource "/etc/sysconfig/keyboard"
467 TZ=$(xcat /etc/timezone)
470 # {{{ set some variables
471 if check_com -c vim ; then
473 export EDITOR=${EDITOR:-vim}
475 export EDITOR=${EDITOR:-vi}
479 export PAGER=${PAGER:-less}
482 export MAIL=${MAIL:-/var/mail/$USER}
484 # if we don't set $SHELL then aterm, rxvt,.. will use /bin/sh or /bin/bash :-/
485 export SHELL='/bin/zsh'
487 # color setup for ls:
488 check_com -c dircolors && eval $(dircolors -b)
489 # color setup for ls on OS X:
490 isdarwin && export CLICOLOR=1
492 # do MacPorts setup on darwin
493 if isdarwin && [[ -d /opt/local ]]; then
494 # Note: PATH gets set in /etc/zprofile on Darwin, so this can't go into
496 PATH="/opt/local/bin:/opt/local/sbin:$PATH"
497 MANPATH="/opt/local/share/man:$MANPATH"
499 # do Fink setup on darwin
500 isdarwin && xsource /sw/bin/init.sh
502 # load our function and completion directories
503 for fdir in /usr/share/grml/zsh/completion /usr/share/grml/functions; do
504 fpath=( ${fdir} ${fdir}/**/*(/N) ${fpath} )
505 if [[ ${fpath} == '/usr/share/grml/zsh/functions' ]] ; then
506 for func in ${fdir}/**/[^_]*[^~](N.) ; do
507 zrcautoload ${func:t}
513 # support colors in less
514 export LESS_TERMCAP_mb=$'\E[01;31m'
515 export LESS_TERMCAP_md=$'\E[01;31m'
516 export LESS_TERMCAP_me=$'\E[0m'
517 export LESS_TERMCAP_se=$'\E[0m'
518 export LESS_TERMCAP_so=$'\E[01;44;33m'
519 export LESS_TERMCAP_ue=$'\E[0m'
520 export LESS_TERMCAP_us=$'\E[01;32m'
522 MAILCHECK=30 # mailchecks
523 REPORTTIME=5 # report about cpu-/system-/user-time of command if running longer than 5 seconds
524 watch=(notme root) # watch for everyone but me and root
526 # automatically remove duplicates from these arrays
527 typeset -U path cdpath fpath manpath
531 if [[ "$TERM" != emacs ]] ; then
532 [[ -z "$terminfo[kdch1]" ]] || bindkey -M emacs "$terminfo[kdch1]" delete-char
533 [[ -z "$terminfo[khome]" ]] || bindkey -M emacs "$terminfo[khome]" beginning-of-line
534 [[ -z "$terminfo[kend]" ]] || bindkey -M emacs "$terminfo[kend]" end-of-line
535 [[ -z "$terminfo[kdch1]" ]] || bindkey -M vicmd "$terminfo[kdch1]" vi-delete-char
536 [[ -z "$terminfo[khome]" ]] || bindkey -M vicmd "$terminfo[khome]" vi-beginning-of-line
537 [[ -z "$terminfo[kend]" ]] || bindkey -M vicmd "$terminfo[kend]" vi-end-of-line
538 [[ -z "$terminfo[cuu1]" ]] || bindkey -M viins "$terminfo[cuu1]" vi-up-line-or-history
539 [[ -z "$terminfo[cuf1]" ]] || bindkey -M viins "$terminfo[cuf1]" vi-forward-char
540 [[ -z "$terminfo[kcuu1]" ]] || bindkey -M viins "$terminfo[kcuu1]" vi-up-line-or-history
541 [[ -z "$terminfo[kcud1]" ]] || bindkey -M viins "$terminfo[kcud1]" vi-down-line-or-history
542 [[ -z "$terminfo[kcuf1]" ]] || bindkey -M viins "$terminfo[kcuf1]" vi-forward-char
543 [[ -z "$terminfo[kcub1]" ]] || bindkey -M viins "$terminfo[kcub1]" vi-backward-char
545 [[ "$terminfo[kcuu1]" == $'\eO'* ]] && bindkey -M viins "${terminfo[kcuu1]/O/[}" vi-up-line-or-history
546 [[ "$terminfo[kcud1]" == $'\eO'* ]] && bindkey -M viins "${terminfo[kcud1]/O/[}" vi-down-line-or-history
547 [[ "$terminfo[kcuf1]" == $'\eO'* ]] && bindkey -M viins "${terminfo[kcuf1]/O/[}" vi-forward-char
548 [[ "$terminfo[kcub1]" == $'\eO'* ]] && bindkey -M viins "${terminfo[kcub1]/O/[}" vi-backward-char
549 [[ "$terminfo[khome]" == $'\eO'* ]] && bindkey -M viins "${terminfo[khome]/O/[}" beginning-of-line
550 [[ "$terminfo[kend]" == $'\eO'* ]] && bindkey -M viins "${terminfo[kend]/O/[}" end-of-line
551 [[ "$terminfo[khome]" == $'\eO'* ]] && bindkey -M emacs "${terminfo[khome]/O/[}" beginning-of-line
552 [[ "$terminfo[kend]" == $'\eO'* ]] && bindkey -M emacs "${terminfo[kend]/O/[}" end-of-line
555 ## keybindings (run 'bindkeys' for details, more details via man zshzle)
556 # use emacs style per default:
561 #if [[ "$TERM" == screen ]] ; then
562 bindkey '\e[1~' beginning-of-line # home
563 bindkey '\e[4~' end-of-line # end
564 bindkey '\e[A' up-line-or-search # cursor up
565 bindkey '\e[B' down-line-or-search # <ESC>-
567 bindkey '^xp' history-beginning-search-backward
568 bindkey '^xP' history-beginning-search-forward
569 # bindkey -s '^L' "|less\n" # ctrl-L pipes to less
570 # bindkey -s '^B' " &\n" # ctrl-B runs it in the background
571 # if terminal type is set to 'rxvt':
572 bindkey '\e[7~' beginning-of-line # home
573 bindkey '\e[8~' end-of-line # end
576 # insert unicode character
577 # usage example: 'ctrl-x i' 00A7 'ctrl-x i' will give you an §
578 # See for example http://unicode.org/charts/ for unicode characters code
579 zrcautoload insert-unicode-char
580 zle -N insert-unicode-char
581 #k# Insert Unicode character
582 bindkey '^Xi' insert-unicode-char
584 ## toggle the ,. abbreviation feature on/off
585 # NOABBREVIATION: default abbreviation-state
586 # 0 - enabled (default)
588 NOABBREVIATION=${NOABBREVIATION:-0}
590 grml_toggle_abbrev() {
591 if (( ${NOABBREVIATION} > 0 )) ; then
598 zle -N grml_toggle_abbrev
599 bindkey '^xA' grml_toggle_abbrev
601 # add a command line to the shells history without executing it
602 commit-to-history() {
603 print -s ${(z)BUFFER}
606 zle -N commit-to-history
607 bindkey "^x^h" commit-to-history
609 # only slash should be considered as a word separator:
610 slash-backward-kill-word() {
611 local WORDCHARS="${WORDCHARS:s@/@}"
613 zle backward-kill-word
615 zle -N slash-backward-kill-word
617 #k# Kill everything in a word up to its last \kbd{/}
618 bindkey '\ev' slash-backward-kill-word
622 # a generic accept-line wrapper {{{
624 # This widget can prevent unwanted autocorrections from command-name
625 # to _command-name, rehash automatically on enter and call any number
626 # of builtin and user-defined widgets in different contexts.
628 # For a broader description, see:
629 # <http://bewatermyfriend.org/posts/2007/12-26.11-50-38-tooltime.html>
631 # The code is imported from the file 'zsh/functions/accept-line' from
632 # <http://ft.bewatermyfriend.org/comp/zsh/zsh-dotfiles.tar.bz2>, which
633 # distributed under the same terms as zsh itself.
635 # A newly added command will may not be found or will cause false
636 # correction attempts, if you got auto-correction set. By setting the
637 # following style, we force accept-line() to rehash, if it cannot
638 # find the first word on the command line in the $command[] hash.
639 zstyle ':acceptline:*' rehash true
641 function Accept-Line() {
642 setopt localoptions noksharrays
647 zstyle -a ":acceptline:${alcontext}" actions subs
649 (( ${#subs} < 1 )) && return 0
652 for sub in ${subs} ; do
653 [[ ${sub} == 'accept-line' ]] && sub='.accept-line'
656 (( aldone > 0 )) && break
660 function Accept-Line-getdefault() {
663 zstyle -s ":acceptline:${alcontext}" default_action default_action
664 case ${default_action} in
666 printf ".accept-line"
669 printf ${default_action}
674 function accept-line() {
675 setopt localoptions noksharrays
678 local buf com fname format msg default_action
682 cmdline=(${(z)BUFFER})
686 zstyle -t ":acceptline:${alcontext}" rehash \
687 && [[ -z ${commands[$com]} ]] \
690 if [[ -n ${reswords[(r)$com]} ]] \
691 || [[ -n ${aliases[$com]} ]] \
692 || [[ -n ${functions[$com]} ]] \
693 || [[ -n ${builtins[$com]} ]] \
694 || [[ -n ${commands[$com]} ]] ; then
696 # there is something sensible to execute, just do it.
700 default_action=$(Accept-Line-getdefault)
701 zstyle -T ":acceptline:${alcontext}" call_default \
702 && zle ${default_action}
706 if [[ -o correct ]] \
707 || [[ -o correctall ]] \
708 && [[ -n ${functions[$fname]} ]] ; then
710 # nothing there to execute but there is a function called
711 # _command_name; a completion widget. Makes no sense to
712 # call it on the commandline, but the correct{,all} options
713 # will ask for it nevertheless, so warn the user.
714 if [[ ${LASTWIDGET} == 'accept-line' ]] ; then
715 # Okay, we warned the user before, he called us again,
716 # so have it his way.
720 default_action=$(Accept-Line-getdefault)
721 zstyle -T ":acceptline:${alcontext}" call_default \
722 && zle ${default_action}
726 # prepare warning message for the user, configurable via zstyle.
727 zstyle -s ":acceptline:${alcontext}" compwarnfmt msg
729 if [[ -z ${msg} ]] ; then
730 msg="%c will not execute and completion %f exists."
733 zformat -f msg "${msg}" "c:${com}" "f:${fname}"
737 elif [[ -n ${buf//[$' \t\n']##/} ]] ; then
738 # If we are here, the commandline contains something that is not
739 # executable, which is neither subject to _command_name correction
740 # and is not empty. might be a variable assignment
744 default_action=$(Accept-Line-getdefault)
745 zstyle -T ":acceptline:${alcontext}" call_default \
746 && zle ${default_action}
750 # If we got this far, the commandline only contains whitespace, or is empty.
754 default_action=$(Accept-Line-getdefault)
755 zstyle -T ":acceptline:${alcontext}" call_default \
756 && zle ${default_action}
764 # power completion - abbreviation expansion {{{
765 # power completion / abbreviation expansion / buffer expansion
766 # see http://zshwiki.org/home/examples/zleiab for details
767 # less risky than the global aliases but powerful as well
768 # just type the abbreviation key and afterwards ',.' to expand it
771 setopt interactivecomments
773 # key # value (#d additional doc string)
779 'G' '|& grep --color=auto '
781 'Hl' ' --help |& less -r' #d (Display help in pager)
785 'N' '&>/dev/null' #d (No Output)
786 'R' '| tr A-z N-za-m' #d (ROT13)
792 'co' './configure && make && sudo make install'
800 if (( NOABBREVIATION > 0 )) ; then
801 LBUFFER="${LBUFFER},."
805 matched_chars='[.-|_a-zA-Z0-9]#'
806 LBUFFER=${LBUFFER%%(#m)[.-|_a-zA-Z0-9]#}
807 LBUFFER+=${abk[$MATCH]:-$MATCH}
811 bindkey ",." globalias
815 zrcautoload zmv # who needs mmv or rename?
816 zrcautoload history-search-end
818 # we don't want to quote/espace URLs on our own...
819 # if autoload -U url-quote-magic ; then
820 # zle -N self-insert url-quote-magic
821 # zstyle ':url-quote-magic:*' url-metas '*?[]^()~#{}='
823 # print 'Notice: no url-quote-magic available :('
825 alias url-quote='autoload -U url-quote-magic ; zle -N self-insert url-quote-magic'
827 #m# k ESC-h Call \kbd{run-help} for the 1st word on the command line
828 alias run-help >&/dev/null && unalias run-help
829 for rh in run-help{,-git,-svk,-svn}; do
834 if zrcautoload compinit ; then
835 compinit || print 'Notice: no compinit available :('
837 print 'Notice: no compinit available :('
842 is4 && zrcautoload zed # use ZLE editor to edit a file or function
845 for mod in complist deltochar mathfunc ; do
846 zmodload -i zsh/${mod} 2>/dev/null || print "Notice: no ${mod} available :("
849 # autoload zsh modules when they are referenced
857 while (( ${#tmpargs} > 0 )) ; do
858 zmodload -${tmpargs[1]} zsh/${tmpargs[2]} ${tmpargs[2]}
864 if is4 && zrcautoload insert-files && zle -N insert-files ; then
866 bindkey "^Xf" insert-files # C-x-f
869 bindkey ' ' magic-space # also do history expansion on space
870 #k# Trigger menu-complete
871 bindkey '\ei' menu-complete # menu completion via esc-i
873 # press esc-e for editing command line in $EDITOR or $VISUAL
874 if is4 && zrcautoload edit-command-line && zle -N edit-command-line ; then
875 #k# Edit the current line in \kbd{\$EDITOR}
876 bindkey '\ee' edit-command-line
879 if is4 && [[ -n ${(k)modules[zsh/complist]} ]] ; then
880 #k# menu selection: pick item but stay in the menu
881 bindkey -M menuselect '\e^M' accept-and-menu-complete
883 # accept a completion and try to complete again by using menu
884 # completion; very useful with completing directories
885 # by using 'undo' one's got a simple file browser
886 bindkey -M menuselect '^o' accept-and-infer-next-history
889 # press "ctrl-e d" to insert the actual date in the form yyyy-mm-dd
890 _bkdate() { BUFFER="$BUFFER$(date '+%F')"; CURSOR=$#BUFFER; }
893 #k# Insert a timestamp on the command line (yyyy-mm-dd)
894 bindkey '^Ed' _bkdate
896 # press esc-m for inserting last typed word again (thanks to caphuso!)
897 insert-last-typed-word() { zle insert-last-word -- 0 -1 };
898 zle -N insert-last-typed-word;
900 #k# Insert last typed word
901 bindkey "\em" insert-last-typed-word
903 #k# Shortcut for \kbd{fg<enter>}
904 bindkey -s '^z' "fg\n"
906 # run command line as user root via sudo:
907 sudo-command-line() {
908 [[ -z $BUFFER ]] && zle up-history
909 [[ $BUFFER != sudo\ * ]] && BUFFER="sudo $BUFFER"
911 zle -N sudo-command-line
913 #k# Put the current command line into a \kbd{sudo} call
914 bindkey "^Os" sudo-command-line
916 ### jump behind the first word on the cmdline.
917 ### useful to add options.
918 function jump_after_first_word() {
922 if (( ${#words} <= 1 )) ; then
925 CURSOR=${#${words[1]}}
928 zle -N jump_after_first_word
930 bindkey '^x1' jump_after_first_word
939 HISTFILE=$HOME/.zsh_history
940 isgrmlcd && HISTSIZE=500 || HISTSIZE=5000
941 isgrmlcd && SAVEHIST=1000 || SAVEHIST=10000 # useful for setopt append_history
945 # dirstack handling {{{
947 DIRSTACKSIZE=${DIRSTACKSIZE:-20}
948 DIRSTACKFILE=${DIRSTACKFILE:-${HOME}/.zdirs}
950 if [[ -f ${DIRSTACKFILE} ]] && [[ ${#dirstack[*]} -eq 0 ]] ; then
951 dirstack=( ${(f)"$(< $DIRSTACKFILE)"} )
952 # "cd -" won't work after login by just setting $OLDPWD, so
953 [[ -d $dirstack[0] ]] && cd $dirstack[0] && cd $OLDPWD
958 my_stack=( ${PWD} ${dirstack} )
960 builtin print -l ${(u)my_stack} >! ${DIRSTACKFILE}
962 uprint my_stack >! ${DIRSTACKFILE}
968 # directory based profiles {{{
972 CHPWD_PROFILE='default'
973 function chpwd_profiles() {
974 # Say you want certain settings to be active in certain directories.
975 # This is what you want.
977 # zstyle ':chpwd:profiles:/usr/src/grml(|/|/*)' profile grml
978 # zstyle ':chpwd:profiles:/usr/src/debian(|/|/*)' profile debian
980 # When that's done and you enter a directory that matches the pattern
981 # in the third part of the context, a function called chpwd_profile_grml,
982 # for example, is called (if it exists).
984 # If no pattern matches (read: no profile is detected) the profile is
985 # set to 'default', which means chpwd_profile_default is attempted to
988 # A word about the context (the ':chpwd:profiles:*' stuff in the zstyle
989 # command) which is used: The third part in the context is matched against
990 # ${PWD}. That's why using a pattern such as /foo/bar(|/|/*) makes sense.
991 # Because that way the profile is detected for all these values of ${PWD}:
995 # So, if you want to make double damn sure a profile works in /foo/bar
996 # and everywhere deeper in that tree, just use (|/|/*) and be happy.
998 # The name of the detected profile will be available in a variable called
999 # 'profile' in your functions. You don't need to do anything, it'll just
1002 # Then there is the parameter $CHPWD_PROFILE is set to the profile, that
1003 # was is currently active. That way you can avoid running code for a
1004 # profile that is already active, by running code such as the following
1005 # at the start of your function:
1007 # function chpwd_profile_grml() {
1008 # [[ ${profile} == ${CHPWD_PROFILE} ]] && return 1
1012 # The initial value for $CHPWD_PROFILE is 'default'.
1014 # Version requirement:
1015 # This feature requires zsh 4.3.3 or newer.
1016 # If you use this feature and need to know whether it is active in your
1017 # current shell, there are several ways to do that. Here are two simple
1020 # a) If knowing if the profiles feature is active when zsh starts is
1021 # good enough for you, you can put the following snippet into your
1024 # (( ${+functions[chpwd_profiles]} )) && print "directory profiles active"
1026 # b) If that is not good enough, and you would prefer to be notified
1027 # whenever a profile changes, you can solve that by making sure you
1028 # start *every* profile function you create like this:
1030 # function chpwd_profile_myprofilename() {
1031 # [[ ${profile} == ${CHPWD_PROFILE} ]] && return 1
1032 # print "chpwd(): Switching to profile: $profile"
1036 # That makes sure you only get notified if a profile is *changed*,
1037 # not everytime you change directory, which would probably piss
1038 # you off fairly quickly. :-)
1040 # There you go. Now have fun with that.
1043 zstyle -s ":chpwd:profiles:${PWD}" profile profile || profile='default'
1044 if (( ${+functions[chpwd_profile_$profile]} )) ; then
1045 chpwd_profile_${profile}
1048 CHPWD_PROFILE="${profile}"
1051 chpwd_functions=( ${chpwd_functions} chpwd_profiles )
1057 # {{{ display battery status on right side of prompt via running 'BATTERY=1 zsh'
1058 if [[ $BATTERY -gt 0 ]] ; then
1059 if ! check_com -c acpi ; then
1065 if [[ $BATTERY -gt 0 ]] ; then
1066 PERCENT="${${"$(acpi 2>/dev/null)"}/(#b)[[:space:]]#Battery <->: [^0-9]##, (<->)%*/${match[1]}}"
1067 if [[ -z "$PERCENT" ]] ; then
1068 PERCENT='acpi not present'
1070 if [[ "$PERCENT" -lt 20 ]] ; then
1071 PERCENT="warning: ${PERCENT}%%"
1073 PERCENT="${PERCENT}%%"
1080 # set colors for use in prompts {{{
1081 if zrcautoload colors && colors 2>/dev/null ; then
1082 BLUE="%{${fg[blue]}%}"
1083 RED="%{${fg_bold[red]}%}"
1084 GREEN="%{${fg[green]}%}"
1085 CYAN="%{${fg[cyan]}%}"
1086 MAGENTA="%{${fg[magenta]}%}"
1087 YELLOW="%{${fg[yellow]}%}"
1088 WHITE="%{${fg[white]}%}"
1089 NO_COLOUR="%{${reset_color}%}"
1091 BLUE=$'%{\e[1;34m%}'
1093 GREEN=$'%{\e[1;32m%}'
1094 CYAN=$'%{\e[1;36m%}'
1095 WHITE=$'%{\e[1;37m%}'
1096 MAGENTA=$'%{\e[1;35m%}'
1097 YELLOW=$'%{\e[1;33m%}'
1098 NO_COLOUR=$'%{\e[0m%}'
1103 # gather version control information for inclusion in a prompt {{{
1106 # Be quiet about version problems in grml's zshrc as the user cannot disable
1107 # loading vcs_info() as it is *in* the zshrc - as you can see. :-)
1108 # Just unset most probable variables and disable vcs_info altogether.
1110 for i in {0..9} ; do
1111 unset VCS_INFO_message_${i}_
1113 zstyle ':vcs_info:*' enable false
1116 # The following code is imported from the file 'zsh/functions/vcs_info'
1117 # from <http://ft.bewatermyfriend.org/comp/zsh/zsh-dotfiles.tar.bz2>,
1118 # which distributed under the same terms as zsh itself.
1120 # we will be using two variables, so let the code know now.
1121 zstyle ':vcs_info:*' max-exports 2
1123 # vcs_info() documentation:
1127 # This functionality requires zsh version >= 4.1.*.
1132 # To load vcs_info(), copy this file to your $fpath[] and do:
1133 # % autoload -Uz vcs_info && vcs_info
1135 # To work, vcs_info() needs 'setopt prompt_subst' in your setup.
1140 # To get vcs_info() working quickly (including colors), you can do the
1141 # following (assuming, you loaded vcs_info() properly - see above):
1143 # % RED=$'%{\e[31m%}'
1144 # % GR=$'%{\e[32m%}'
1145 # % MA=$'%{\e[35m%}'
1146 # % YE=$'%{\e[33m%}'
1149 # % zstyle ':vcs_info:*' actionformats \
1150 # "${MA}(${NC}%s${MA})${YE}-${MA}[${GR}%b${YE}|${RED}%a${MA}]${NC} "
1152 # % zstyle ':vcs_info:*' formats \
1153 # "${MA}(${NC}%s${MA})${Y}-${MA}[${GR}%b${MA}]${NC}%} "
1155 # % zstyle ':vcs_info:(sv[nk]|bzr):*' branchformat "%b${RED}:${YE}%r"
1157 # % precmd () { vcs_info }
1158 # % PS1='${MA}[${GR}%n${MA}] ${MA}(${RED}%!${MA}) ${YE}%3~ ${VCS_INFO_message_0_}${NC}%# '
1160 # Obviously, the las two lines are there for demonstration: You need to
1161 # call vcs_info() from your precmd() function (see 'SPECIAL FUNCTIONS' in
1162 # 'man zshmisc'). Once that is done you need a *single* quoted
1163 # '${VCS_INFO_message_0_}' in your prompt.
1165 # Now call the 'vcs_info_printsys' utility from the command line:
1167 # % vcs_info_printsys
1168 # # list of supported version control backends:
1169 # # disabled systems are prefixed by a hash sign (#)
1180 # # flavours (cannot be used in the disable style; they
1181 # # are disabled with their master [git-svn -> git]):
1185 # Ten version control backends as you can see. You may not want all
1186 # of these. Because there is no point in running the code to detect
1187 # systems you do not use. ever. So, there is a way to disable some
1188 # backends altogether:
1190 # % zstyle ':vcs_info:*' disable bzr cdv darcs mtn svk tla
1192 # If you rerun 'vcs_info_printsys' now, you will see the backends listed
1193 # in the 'disable' style marked as diabled by a hash sign. That means the
1194 # detection of these systems is skipped *completely*. No wasted time there.
1196 # For more control, read the reference below.
1201 # The vcs_info() feature can be configured via zstyle.
1203 # First, the context in which we are working:
1204 # :vcs_info:<vcs-string>:<user-context>
1206 # ...where <vcs-string> is one of:
1207 # - git, git-svn, git-p4, hg, darcs, bzr, cdv, mtn, svn, cvs, svk or tla.
1209 # ...and <user-context> is a freely configurable string, assignable by the
1210 # user as the first argument to vcs_info() (see its description below).
1212 # There is are three special values for <vcs-string>: The first is named
1213 # 'init', that is in effect as long as there was no decision what vcs
1214 # backend to use. The second is 'preinit; it is used *before* vcs_info()
1215 # is run, when initializing the data exporting variables. The third
1216 # special value is 'formats' and is used by the 'vcs_info_lastmsg' for
1217 # looking up its styles.
1219 # There are two pre-defined values for <user-context>:
1220 # default - the one used if none is specified
1221 # command - used by vcs_info_lastmsg to lookup its styles.
1223 # You may *not* use 'print_systems_' as a user-context string, because it
1224 # is used internally.
1226 # You can of course use ':vcs_info:*' to match all VCSs in all
1227 # user-contexts at once.
1229 # Another special context is 'formats', which is used by the
1230 # vcs_info_lastmsg() utility function (see below).
1233 # This is a description of all styles, that are looked up:
1234 # formats - A list of formats, used when actionformats is not
1235 # used (which is most of the time).
1236 # actionformats - A list of formats, used if a there is a special
1237 # action going on in your current repository;
1238 # (like an interactive rebase or a merge conflict)
1239 # branchformat - Some backends replace %b in the formats and
1240 # actionformats styles above, not only by a branch
1241 # name but also by a revision number. This style
1242 # let's you modify how that string should look like.
1243 # nvcsformats - These "formats" are exported, when we didn't detect
1244 # a version control system for the current directory.
1245 # This is useful, if you want vcs_info() to completely
1246 # take over the generation of your prompt.
1247 # You would do something like
1248 # PS1='${VCS_INFO_message_0_}'
1249 # to accomplish that.
1250 # max-exports - Defines the maximum number if VCS_INFO_message_*_
1251 # variables vcs_info() will export.
1252 # enable - Checked in the 'init' context. If set to false,
1253 # vcs_info() will do nothing.
1254 # disable - Provide a list of systems, you don't want
1255 # the vcs_info() to check for repositories
1256 # (checked in the 'init' context, too).
1257 # disable-patterns - A list of patterns that are checked against $PWD.
1258 # If the pattern matches, vcs_info will be disabled.
1259 # Say, ~/.zsh is a directory under version control,
1260 # in which you do not want vcs_info to be active, do:
1261 # zstyle ':vcs_info:*' disable-patterns "$HOME/.zsh+(|/*)"
1262 # use-simple - If there are two different ways of gathering
1263 # information, you can select the simpler one
1264 # by setting this style to true; the default
1265 # is to use the not-that-simple code, which is
1266 # potentially a lot slower but might be more
1267 # accurate in all possible cases.
1268 # use-prompt-escapes - determines if we assume that the assembled
1269 # string from vcs_info() includes prompt escapes.
1270 # (Used by vcs_info_lastmsg().
1272 # The use-simple style is only available for the bzr backend.
1274 # The default values for these in all contexts are:
1275 # formats " (%s)-[%b|%a]-"
1276 # actionformats " (%s)-[%b]-"
1277 # branchformat "%b:%r" (for bzr, svn and svk)
1281 # disable (empty list)
1282 # disable-patterns (empty list)
1284 # use-prompt-escapes true
1287 # In normal formats and actionformats, the following replacements
1289 # %s - The vcs in use (git, hg, svn etc.)
1290 # %b - Information about the current branch.
1291 # %a - An identifier, that describes the action.
1292 # Only makes sense in actionformats.
1293 # %R - base directory of the repository.
1294 # %r - repository name
1295 # If %R is '/foo/bar/repoXY', %r is 'repoXY'.
1296 # %S - subdirectory within a repository. if $PWD is
1297 # '/foo/bar/reposXY/beer/tasty', %S is 'beer/tasty'.
1300 # In branchformat these replacements are done:
1301 # %b - the branch name
1302 # %r - the current revision number
1304 # Not all vcs backends have to support all replacements.
1305 # nvcsformat does not perform *any* replacements. It is just a string.
1310 # If you want to use the %b (bold off) prompt expansion in 'formats', which
1311 # expands %b itself, use %%b. That will cause the vcs_info() expansion to
1312 # replace %%b with %b. So zsh's prompt expansion mechanism can handle it.
1313 # Similarly, to hand down %b from branchformat, use %%%%b. Sorry for this
1314 # inconvenience, but it cannot be easily avoided. Luckily we do not clash
1315 # with a lot of prompt expansions and this only needs to be done for those.
1316 # See 'man zshmisc' for details about EXPANSION OF PROMPT SEQUENCES.
1319 # FUNCTION DESCRIPTIONS (public API):
1322 # The main function, that runs all backends and assembles
1323 # all data into ${VCS_INFO_message_*_}. This is the function
1324 # you want to call from precmd() if you want to include
1325 # up-to-date information in your prompt (see VARIABLE
1326 # DESCRIPTION below).
1328 # vcs_info_printsys()
1329 # Prints a list of all supported version control systems.
1330 # Useful to find out possible contexts (and which of them are enabled)
1331 # or values for the 'disable' style.
1333 # vcs_info_lastmsg()
1334 # Outputs the last ${VCS_INFO_message_*_} value. Takes into account
1335 # the value of the use-prompt-escapes style in ':vcs_info:formats'.
1336 # It also only prints max-exports values.
1338 # All functions named VCS_INFO_* are for internal use only.
1341 # VARIABLE DESCRIPTION:
1343 # ${VCS_INFO_message_N_} (Note the trailing underscore)
1344 # Where 'N' is an integer, eg: VCS_INFO_message_0_
1345 # These variables are the storage for the informational message the
1346 # last vcs_info() call has assembled. These are strongly connected
1347 # to the formats, actionformats and nvcsformats styles described
1348 # above. Those styles are lists. the first member of that list gets
1349 # expanded into ${VCS_INFO_message_0_}, the second into
1350 # ${VCS_INFO_message_1_} and the Nth into ${VCS_INFO_message_N-1_}.
1351 # These parameters are exported into the environment.
1352 # (See the max-exports style above.)
1357 # Don't use vcs_info at all (even though it's in your prompt):
1358 # % zstyle ':vcs_info:*' enable false
1360 # Disable the backends for bzr and svk:
1361 # % zstyle ':vcs_info:*' disable bzr svk
1363 # Provide a special formats for git:
1364 # % zstyle ':vcs_info:git:*' formats ' GIT, BABY! [%b]'
1365 # % zstyle ':vcs_info:git:*' actionformats ' GIT ACTION! [%b|%a]'
1367 # Use the quicker bzr backend (if you do, please report if it does
1368 # the-right-thing[tm] - thanks):
1369 # % zstyle ':vcs_info:bzr:*' use-simple true
1371 # Display the revision number in yellow for bzr and svn:
1372 # % zstyle ':vcs_info:(svn|bzr):*' branchformat '%b%{'${fg[yellow]}'%}:%r'
1374 # If you want colors, make sure you enclose the color codes in %{...%},
1375 # if you want to use the string provided by vcs_info() in prompts.
1377 # Here is how to print the vcs infomation as a command:
1378 # % alias vcsi='vcs_info command; vcs_info_lastmsg'
1380 # This way, you can even define different formats for output via
1381 # vcs_info_lastmsg() in the ':vcs_info:command:*' namespace.
1385 VCS_INFO_adjust () { #{{{
1386 [[ -n ${vcs_comm[overwrite_name]} ]] && vcs=${vcs_comm[overwrite_name]}
1390 VCS_INFO_check_com () { #{{{
1391 (( ${+commands[$1]} )) && [[ -x ${commands[$1]} ]] && return 0
1395 VCS_INFO_formats () { # {{{
1396 setopt localoptions noksharrays
1397 local action=$1 branch=$2 base=$3
1401 if [[ -n ${action} ]] ; then
1402 zstyle -a ":vcs_info:${vcs}:${usercontext}" actionformats msgs
1403 (( ${#msgs} < 1 )) && msgs[1]=' (%s)-[%b|%a]-'
1405 zstyle -a ":vcs_info:${vcs}:${usercontext}" formats msgs
1406 (( ${#msgs} < 1 )) && msgs[1]=' (%s)-[%b]-'
1409 (( ${#msgs} > maxexports )) && msgs[$(( maxexports + 1 )),-1]=()
1410 for i in {1..${#msgs}} ; do
1411 zformat -f msg ${msgs[$i]} \
1417 S:"$(VCS_INFO_reposub ${base})"
1423 VCS_INFO_maxexports () { #{{{
1424 zstyle -s ":vcs_info:${vcs}:${usercontext}" "max-exports" maxexports || maxexports=2
1425 if [[ ${maxexports} != <-> ]] || (( maxexports < 1 )); then
1426 printf 'vcs_info(): expecting numeric arg >= 1 for max-exports (got %s).\n' ${maxexports}
1427 printf 'Defaulting to 2.\n'
1432 VCS_INFO_nvcsformats () { #{{{
1433 setopt localoptions noksharrays
1436 if [[ $1 == 'preinit' ]] ; then
1440 zstyle -a ":vcs_info:${v:-$vcs}:${c:-$usercontext}" nvcsformats msgs
1441 (( ${#msgs} > maxexports )) && msgs[${maxexports},-1]=()
1444 VCS_INFO_realpath () { #{{{
1445 # a portable 'readlink -f'
1446 # forcing a subshell, to ensure chpwd() is not removed
1447 # from the calling shell (if VCS_INFO_realpath() is called
1450 (( ${+functions[chpwd]} )) && unfunction chpwd
1452 cd $1 2>/dev/null && pwd
1456 VCS_INFO_reposub () { #{{{
1457 setopt localoptions extendedglob
1458 local base=${1%%/##}
1460 [[ ${PWD} == ${base}/* ]] || {
1464 printf '%s' ${PWD#$base/}
1468 VCS_INFO_set () { #{{{
1469 setopt localoptions noksharrays
1472 if [[ $1 == '--clear' ]] ; then
1473 for i in {0..9} ; do
1474 unset VCS_INFO_message_${i}_
1477 if [[ $1 == '--nvcs' ]] ; then
1478 [[ $2 == 'preinit' ]] && (( maxexports == 0 )) && (( maxexports = 1 ))
1479 for i in {0..$((maxexports - 1))} ; do
1480 typeset -gx VCS_INFO_message_${i}_=
1482 VCS_INFO_nvcsformats $2
1485 (( ${#msgs} - 1 < 0 )) && return 0
1486 for i in {0..$(( ${#msgs} - 1 ))} ; do
1488 typeset -gx VCS_INFO_message_${i}_=${msgs[$j]}
1493 # information gathering
1494 VCS_INFO_bzr_get_data () { # {{{
1495 setopt localoptions noksharrays
1499 if zstyle -t ":vcs_info:${vcs}:${usercontext}" "use-simple" ; then
1500 bzrbase=${vcs_comm[basedir]}
1501 bzrinfo[2]=${bzrbase:t}
1502 if [[ -f ${bzrbase}/.bzr/branch/last-revision ]] ; then
1503 bzrinfo[1]=$(< ${bzrbase}/.bzr/branch/last-revision)
1504 bzrinfo[1]=${${bzrinfo[1]}%% *}
1507 bzrbase=${${(M)${(f)"$( bzr info )"}:# ##branch\ root:*}/*: ##/}
1508 bzrinfo=( ${${${(M)${(f)"$( bzr version-info )"}:#(#s)(revno|branch-nick)*}/*: /}/*\//} )
1509 bzrbase="$(VCS_INFO_realpath ${bzrbase})"
1512 zstyle -s ":vcs_info:${vcs}:${usercontext}" branchformat bzrbr || bzrbr="%b:%r"
1513 zformat -f bzrbr "${bzrbr}" "b:${bzrinfo[2]}" "r:${bzrinfo[1]}"
1514 VCS_INFO_formats '' "${bzrbr}" "${bzrbase}"
1518 VCS_INFO_cdv_get_data () { # {{{
1521 cdvbase=${vcs_comm[basedir]}
1522 VCS_INFO_formats '' "${cdvbase:t}" "${cdvbase}"
1526 VCS_INFO_cvs_get_data () { # {{{
1527 local cvsbranch cvsbase basename
1530 while [[ -d "${cvsbase}/../CVS" ]]; do
1531 cvsbase="${cvsbase}/.."
1533 cvsbase="$(VCS_INFO_realpath ${cvsbase})"
1534 cvsbranch=$(< ./CVS/Repository)
1535 basename=${cvsbase:t}
1536 cvsbranch=${cvsbranch##${basename}/}
1537 [[ -z ${cvsbranch} ]] && cvsbranch=${basename}
1538 VCS_INFO_formats '' "${cvsbranch}" "${cvsbase}"
1542 VCS_INFO_darcs_get_data () { # {{{
1545 darcsbase=${vcs_comm[basedir]}
1546 VCS_INFO_formats '' "${darcsbase:t}" "${darcsbase}"
1550 VCS_INFO_git_getaction () { #{{{
1551 local gitaction='' gitdir=$1
1554 for tmp in "${gitdir}/rebase-apply" \
1555 "${gitdir}/rebase" \
1556 "${gitdir}/../.dotest" ; do
1557 if [[ -d ${tmp} ]] ; then
1558 if [[ -f "${tmp}/rebasing" ]] ; then
1560 elif [[ -f "${tmp}/applying" ]] ; then
1563 gitaction="am/rebase"
1565 printf '%s' ${gitaction}
1570 for tmp in "${gitdir}/rebase-merge/interactive" \
1571 "${gitdir}/.dotest-merge/interactive" ; do
1572 if [[ -f "${tmp}" ]] ; then
1573 printf '%s' "rebase-i"
1578 for tmp in "${gitdir}/rebase-merge" \
1579 "${gitdir}/.dotest-merge" ; do
1580 if [[ -d "${tmp}" ]] ; then
1581 printf '%s' "rebase-m"
1586 if [[ -f "${gitdir}/MERGE_HEAD" ]] ; then
1591 if [[ -f "${gitdir}/BISECT_LOG" ]] ; then
1592 printf '%s' "bisect"
1598 VCS_INFO_git_getbranch () { #{{{
1599 local gitbranch gitdir=$1
1600 local gitsymref='git symbolic-ref HEAD'
1602 if [[ -d "${gitdir}/rebase-apply" ]] \
1603 || [[ -d "${gitdir}/rebase" ]] \
1604 || [[ -d "${gitdir}/../.dotest" ]] \
1605 || [[ -f "${gitdir}/MERGE_HEAD" ]] ; then
1606 gitbranch="$(${(z)gitsymref} 2> /dev/null)"
1607 [[ -z ${gitbranch} ]] && [[ -r ${gitdir}/rebase-apply/head-name ]] \
1608 && gitbranch="$(< ${gitdir}/rebase-apply/head-name)"
1610 elif [[ -f "${gitdir}/rebase-merge/interactive" ]] \
1611 || [[ -d "${gitdir}/rebase-merge" ]] ; then
1612 gitbranch="$(< ${gitdir}/rebase-merge/head-name)"
1614 elif [[ -f "${gitdir}/.dotest-merge/interactive" ]] \
1615 || [[ -d "${gitdir}/.dotest-merge" ]] ; then
1616 gitbranch="$(< ${gitdir}/.dotest-merge/head-name)"
1619 gitbranch="$(${(z)gitsymref} 2> /dev/null)"
1621 if [[ $? -ne 0 ]] ; then
1622 gitbranch="$(git describe --exact-match HEAD 2>/dev/null)"
1624 if [[ $? -ne 0 ]] ; then
1625 gitbranch="${${"$(< $gitdir/HEAD)"}[1,7]}..."
1630 printf '%s' "${gitbranch##refs/heads/}"
1634 VCS_INFO_git_get_data () { # {{{
1635 setopt localoptions extendedglob
1636 local gitdir gitbase gitbranch gitaction
1638 gitdir=${vcs_comm[gitdir]}
1639 gitbranch="$(VCS_INFO_git_getbranch ${gitdir})"
1641 if [[ -z ${gitdir} ]] || [[ -z ${gitbranch} ]] ; then
1646 gitaction="$(VCS_INFO_git_getaction ${gitdir})"
1647 gitbase=${PWD%/${$( git rev-parse --show-prefix )%/##}}
1648 VCS_INFO_formats "${gitaction}" "${gitbranch}" "${gitbase}"
1652 VCS_INFO_hg_get_data () { # {{{
1653 local hgbranch hgbase file
1655 hgbase=${vcs_comm[basedir]}
1657 file="${hgbase}/.hg/branch"
1658 if [[ -r ${file} ]] ; then
1659 hgbranch=$(< ${file})
1664 VCS_INFO_formats '' "${hgbranch}" "${hgbase}"
1668 VCS_INFO_mtn_get_data () { # {{{
1669 local mtnbranch mtnbase
1671 mtnbase=${vcs_comm[basedir]}
1672 mtnbranch=${${(M)${(f)"$( mtn status )"}:#(#s)Current branch:*}/*: /}
1673 VCS_INFO_formats '' "${mtnbranch}" "${mtnbase}"
1677 VCS_INFO_svk_get_data () { # {{{
1678 local svkbranch svkbase
1680 svkbase=${vcs_comm[basedir]}
1681 zstyle -s ":vcs_info:${vcs}:${usercontext}" branchformat svkbranch || svkbranch="%b:%r"
1682 zformat -f svkbranch "${svkbranch}" "b:${vcs_comm[branch]}" "r:${vcs_comm[revision]}"
1683 VCS_INFO_formats '' "${svkbranch}" "${svkbase}"
1687 VCS_INFO_svn_get_data () { # {{{
1688 setopt localoptions noksharrays
1689 local svnbase svnbranch
1693 while [[ -d "${svnbase}/../.svn" ]]; do
1694 svnbase="${svnbase}/.."
1696 svnbase="$(VCS_INFO_realpath ${svnbase})"
1697 svninfo=( ${${${(M)${(f)"$( svn info )"}:#(#s)(URL|Revision)*}/*: /}/*\//} )
1699 zstyle -s ":vcs_info:${vcs}:${usercontext}" branchformat svnbranch || svnbranch="%b:%r"
1700 zformat -f svnbranch "${svnbranch}" "b:${svninfo[1]}" "r:${svninfo[2]}"
1701 VCS_INFO_formats '' "${svnbranch}" "${svnbase}"
1705 VCS_INFO_tla_get_data () { # {{{
1706 local tlabase tlabranch
1708 tlabase="$(VCS_INFO_realpath ${vcs_comm[basedir]})"
1709 # tree-id gives us something like 'foo@example.com/demo--1.0--patch-4', so:
1710 tlabranch=${${"$( tla tree-id )"}/*\//}
1711 VCS_INFO_formats '' "${tlabranch}" "${tlabase}"
1716 VCS_INFO_detect_by_dir() { #{{{
1718 local basedir="." realbasedir
1720 realbasedir="$(VCS_INFO_realpath ${basedir})"
1721 while [[ ${realbasedir} != '/' ]]; do
1722 if [[ -n ${vcs_comm[detect_need_file]} ]] ; then
1723 [[ -d ${basedir}/${dirname} ]] && \
1724 [[ -e ${basedir}/${dirname}/${vcs_comm[detect_need_file]} ]] && \
1727 [[ -d ${basedir}/${dirname} ]] && break
1730 basedir=${basedir}/..
1731 realbasedir="$(VCS_INFO_realpath ${basedir})"
1734 [[ ${realbasedir} == "/" ]] && return 1
1735 vcs_comm[basedir]=${realbasedir}
1739 VCS_INFO_bzr_detect() { #{{{
1740 VCS_INFO_check_com bzr || return 1
1741 vcs_comm[detect_need_file]=branch/format
1742 VCS_INFO_detect_by_dir '.bzr'
1746 VCS_INFO_cdv_detect() { #{{{
1747 VCS_INFO_check_com cdv || return 1
1748 vcs_comm[detect_need_file]=format
1749 VCS_INFO_detect_by_dir '.cdv'
1753 VCS_INFO_cvs_detect() { #{{{
1754 VCS_INFO_check_com svn || return 1
1755 [[ -d "./CVS" ]] && [[ -r "./CVS/Repository" ]] && return 0
1759 VCS_INFO_darcs_detect() { #{{{
1760 VCS_INFO_check_com darcs || return 1
1761 vcs_comm[detect_need_file]=format
1762 VCS_INFO_detect_by_dir '_darcs'
1766 VCS_INFO_git_detect() { #{{{
1767 if VCS_INFO_check_com git && git rev-parse --is-inside-work-tree &> /dev/null ; then
1768 vcs_comm[gitdir]="$(git rev-parse --git-dir 2> /dev/null)" || return 1
1769 if [[ -d ${vcs_comm[gitdir]}/svn ]] ; then vcs_comm[overwrite_name]='git-svn'
1770 elif [[ -d ${vcs_comm[gitdir]}/refs/remotes/p4 ]] ; then vcs_comm[overwrite_name]='git-p4' ; fi
1776 VCS_INFO_hg_detect() { #{{{
1777 VCS_INFO_check_com hg || return 1
1778 vcs_comm[detect_need_file]=store
1779 VCS_INFO_detect_by_dir '.hg'
1783 VCS_INFO_mtn_detect() { #{{{
1784 VCS_INFO_check_com mtn || return 1
1785 vcs_comm[detect_need_file]=revision
1786 VCS_INFO_detect_by_dir '_MTN'
1790 VCS_INFO_svk_detect() { #{{{
1791 setopt localoptions noksharrays extendedglob
1796 VCS_INFO_check_com svk || return 1
1797 [[ -f ~/.svk/config ]] || return 1
1799 # This detection function is a bit different from the others.
1800 # We need to read svk's config file to detect a svk repository
1801 # in the first place. Therefore, we'll just proceed and read
1802 # the other information, too. This is more then any of the
1803 # other detections do but this takes only one file open for
1804 # svk at most. VCS_INFO_svk_get_data() get simpler, too. :-)
1805 while IFS= read -r line ; do
1806 if [[ -n ${vcs_comm[basedir]} ]] ; then
1808 [[ ${line} == depotpath:* ]] && vcs_comm[branch]=${line##*/}
1809 [[ ${line} == revision:* ]] && vcs_comm[revision]=${line##*[[:space:]]##}
1810 [[ -n ${vcs_comm[branch]} ]] && [[ -n ${vcs_comm[revision]} ]] && break
1813 (( fhash > 0 )) && [[ ${line} == ' '[^[:space:]]*:* ]] && break
1814 [[ ${line} == ' hash:'* ]] && fhash=1 && continue
1815 (( fhash == 0 )) && continue
1816 [[ ${PWD}/ == ${${line## ##}%:*}/* ]] && vcs_comm[basedir]=${${line## ##}%:*}
1817 done < ~/.svk/config
1819 [[ -n ${vcs_comm[basedir]} ]] && \
1820 [[ -n ${vcs_comm[branch]} ]] && \
1821 [[ -n ${vcs_comm[revision]} ]] && return 0
1825 VCS_INFO_svn_detect() { #{{{
1826 VCS_INFO_check_com svn || return 1
1827 [[ -d ".svn" ]] && return 0
1831 VCS_INFO_tla_detect() { #{{{
1832 VCS_INFO_check_com tla || return 1
1833 vcs_comm[basedir]="$(tla tree-root 2> /dev/null)" && return 0
1838 vcs_info_printsys () { # {{{
1839 vcs_info print_systems_
1842 vcs_info_lastmsg () { # {{{
1846 for i in {0..$((maxexports - 1))} ; do
1847 printf '$VCS_INFO_message_%d_: "' $i
1848 if zstyle -T ':vcs_info:formats:command' use-prompt-escapes ; then
1849 print -nP ${(P)${:-VCS_INFO_message_${i}_}}
1851 print -n ${(P)${:-VCS_INFO_message_${i}_}}
1860 local -a VCSs disabled dps
1861 local -x vcs usercontext
1862 local -ix maxexports
1867 VCSs=(git hg bzr darcs svk mtn svn cvs cdv tla)
1870 zstyle -a ":vcs_info:${vcs}:${usercontext}" "disable" disabled
1871 print -l '# list of supported version control backends:' \
1872 '# disabled systems are prefixed by a hash sign (#)'
1873 for vcs in ${VCSs} ; do
1874 [[ -n ${(M)disabled:#${vcs}} ]] && printf '#'
1875 printf '%s\n' ${vcs}
1877 print -l '# flavours (cannot be used in the disable style; they' \
1878 '# are disabled with their master [git-svn -> git]):' \
1883 [[ -z ${usercontext} ]] && usercontext=default
1885 (*) [[ -z ${usercontext} ]] && usercontext=$1
1889 zstyle -T ":vcs_info:${vcs}:${usercontext}" "enable" || {
1890 [[ -n ${VCS_INFO_message_0_} ]] && VCS_INFO_set --clear
1893 zstyle -a ":vcs_info:${vcs}:${usercontext}" "disable" disabled
1895 zstyle -a ":vcs_info:${vcs}:${usercontext}" "disable-patterns" dps
1896 for pat in ${dps} ; do
1897 if [[ ${PWD} == ${~pat} ]] ; then
1898 [[ -n ${vcs_info_msg_0_} ]] && VCS_INFO_set --clear
1906 for vcs in ${VCSs} ; do
1907 [[ -n ${(M)disabled:#${vcs}} ]] && continue
1909 VCS_INFO_${vcs}_detect && (( found = 1 )) && break
1912 (( found == 0 )) && {
1917 VCS_INFO_${vcs}_get_data || {
1926 VCS_INFO_set --nvcs preinit
1929 # Change vcs_info formats for the grml prompt. The 2nd format sets up
1930 # $vcs_info_msg_1_ to contain "zsh: repo-name" used to set our screen title.
1931 # TODO: The included vcs_info() version still uses $VCS_INFO_message_N_.
1932 # That needs to be the use of $VCS_INFO_message_N_ needs to be changed
1933 # to $vcs_info_msg_N_ as soon as we use the included version.
1934 if [[ "$TERM" == dumb ]] ; then
1935 zstyle ':vcs_info:*' actionformats "(%s%)-[%b|%a] " "zsh: %r"
1936 zstyle ':vcs_info:*' formats "(%s%)-[%b] " "zsh: %r"
1938 # these are the same, just with a lot of colours:
1939 zstyle ':vcs_info:*' actionformats "${MAGENTA}(${NO_COLOUR}%s${MAGENTA})${YELLOW}-${MAGENTA}[${GREEN}%b${YELLOW}|${RED}%a${MAGENTA}]${NO_COLOUR} " \
1941 zstyle ':vcs_info:*' formats "${MAGENTA}(${NO_COLOUR}%s${MAGENTA})${YELLOW}-${MAGENTA}[${GREEN}%b${MAGENTA}]${NO_COLOUR}%} " \
1943 zstyle ':vcs_info:(sv[nk]|bzr):*' branchformat "%b${RED}:${YELLOW}%r"
1948 # command not found handling {{{
1950 (( ${COMMAND_NOT_FOUND} == 1 )) &&
1951 function command_not_found_handler() {
1953 if [[ -x ${GRML_ZSH_CNF_HANDLER} ]] ; then
1954 ${GRML_ZSH_CNF_HANDLER} $1
1962 if zrcautoload promptinit && promptinit 2>/dev/null ; then
1963 promptinit # people should be able to use their favourite prompt
1965 print 'Notice: no promptinit available :('
1970 # make sure to use right prompt only when not running a command
1971 is41 && setopt transient_rprompt
1973 # TODO: revise all these NO* variables and especially their documentation
1974 # in zsh-help() below.
1975 is4 && [[ $NOPRECMD -eq 0 ]] && precmd () {
1976 [[ $NOPRECMD -gt 0 ]] && return 0
1977 # update VCS information
1980 if [[ $TERM == screen* ]] ; then
1981 if [[ -n ${VCS_INFO_message_1_} ]] ; then
1982 print -nP "\ek${VCS_INFO_message_1_}\e\\"
1984 print -nP "\ekzsh\e\\"
1987 # just use DONTSETRPROMPT=1 to be able to overwrite RPROMPT
1988 if [[ $DONTSETRPROMPT -eq 0 ]] ; then
1989 if [[ $BATTERY -gt 0 ]] ; then
1990 # update battery (dropped into $PERCENT) information
1992 RPROMPT="%(?..:() ${PERCENT}"
1997 # adjust title of xterm
1998 # see http://www.faqs.org/docs/Linux-mini/Xterm-Title.html
1999 [[ ${NOTITLE} -gt 0 ]] && return 0
2002 print -Pn "\e]0;%n@%m: %~\a"
2007 # preexec() => a function running before every command
2008 is4 && [[ $NOPRECMD -eq 0 ]] && \
2010 [[ $NOPRECMD -gt 0 ]] && return 0
2011 # set hostname if not running on host with name 'grml'
2012 if [[ -n "$HOSTNAME" ]] && [[ "$HOSTNAME" != $(hostname) ]] ; then
2015 # get the name of the program currently running and hostname of local machine
2016 # set screen window title if running in a screen
2017 if [[ "$TERM" == screen* ]] ; then
2018 # local CMD=${1[(wr)^(*=*|sudo|ssh|-*)]} # don't use hostname
2019 local CMD="${1[(wr)^(*=*|sudo|ssh|-*)]}$NAME" # use hostname
2020 echo -ne "\ek$CMD\e\\"
2022 # adjust title of xterm
2023 [[ ${NOTITLE} -gt 0 ]] && return 0
2026 print -Pn "\e]0;%n@%m: $1\a"
2031 EXITCODE="%(?..%?%1v )"
2032 PS2='\`%_> ' # secondary prompt, printed when the shell needs more information to complete a command.
2033 PS3='?# ' # selection prompt used within a select loop.
2034 PS4='+%N:%i:%_> ' # the execution trace prompt (setopt xtrace). default: '+%N:%i>'
2036 # set variable debian_chroot if running in a chroot with /etc/debian_chroot
2037 if [[ -z "$debian_chroot" ]] && [[ -r /etc/debian_chroot ]] ; then
2038 debian_chroot=$(cat /etc/debian_chroot)
2041 # don't use colors on dumb terminals (like emacs):
2042 if [[ "$TERM" == dumb ]] ; then
2043 PROMPT="${EXITCODE}${debian_chroot:+($debian_chroot)}%n@%m %40<...<%B%~%b%<< "'${VCS_INFO_message_0_}'"%# "
2045 # only if $GRMLPROMPT is set (e.g. via 'GRMLPROMPT=1 zsh') use the extended prompt
2046 # set variable identifying the chroot you work in (used in the prompt below)
2047 if [[ $GRMLPROMPT -gt 0 ]] ; then
2048 PROMPT="${RED}${EXITCODE}${CYAN}[%j running job(s)] ${GREEN}{history#%!} ${RED}%(3L.+.) ${BLUE}%* %D
2049 ${BLUE}%n${NO_COLOUR}@%m %40<...<%B%~%b%<< "'${VCS_INFO_message_0_}'"%# "
2051 # This assembles the primary prompt string
2052 if (( EUID != 0 )); then
2053 PROMPT="${RED}${EXITCODE}${WHITE}${debian_chroot:+($debian_chroot)}${BLUE}%n${NO_COLOUR}@%m %40<...<%B%~%b%<< "'${VCS_INFO_message_0_}'"%# "
2055 PROMPT="${BLUE}${EXITCODE}${WHITE}${debian_chroot:+($debian_chroot)}${RED}%n${NO_COLOUR}@%m %40<...<%B%~%b%<< "'${VCS_INFO_message_0_}'"%# "
2060 # if we are inside a grml-chroot set a specific prompt theme
2061 if [[ -n "$GRML_CHROOT" ]] ; then
2062 PROMPT="%{$fg[red]%}(CHROOT) %{$fg_bold[red]%}%n%{$fg_no_bold[white]%}@%m %40<...<%B%~%b%<< %\# "
2066 # {{{ 'hash' some often used directories
2068 hash -d deb=/var/cache/apt/archives
2069 hash -d doc=/usr/share/doc
2070 hash -d linux=/lib/modules/$(command uname -r)/build/
2071 hash -d log=/var/log
2072 hash -d slog=/var/log/syslog
2073 hash -d src=/usr/src
2074 hash -d templ=/usr/share/doc/grml-templates
2075 hash -d tt=/usr/share/doc/texttools-doc
2076 hash -d www=/var/www
2081 if check_com -c screen ; then
2082 if [[ $UID -eq 0 ]] ; then
2083 [[ -r /etc/grml/screenrc ]] && alias screen="${commands[screen]} -c /etc/grml/screenrc"
2084 elif [[ -r $HOME/.screenrc ]] ; then
2085 alias screen="${commands[screen]} -c $HOME/.screenrc"
2087 [[ -r /etc/grml/screenrc_grml ]] && alias screen="${commands[screen]} -c /etc/grml/screenrc_grml"
2091 # do we have GNU ls with color-support?
2092 if ls --help 2>/dev/null | grep -- --color= >/dev/null && [[ "$TERM" != dumb ]] ; then
2093 #a1# execute \kbd{@a@}:\quad ls with colors
2094 alias ls='ls -b -CF --color=auto'
2095 #a1# execute \kbd{@a@}:\quad list all files, with colors
2096 alias la='ls -la --color=auto'
2097 #a1# long colored list, without dotfiles (@a@)
2098 alias ll='ls -l --color=auto'
2099 #a1# long colored list, human readable sizes (@a@)
2100 alias lh='ls -hAl --color=auto'
2101 #a1# List files, append qualifier to filenames \\&\quad(\kbd{/} for directories, \kbd{@} for symlinks ...)
2102 alias l='ls -lF --color=auto'
2104 alias ls='ls -b -CF'
2111 alias mdstat='cat /proc/mdstat'
2112 alias ...='cd ../../'
2114 # generate alias named "$KERNELVERSION-reboot" so you can use boot with kexec:
2115 if [[ -x /sbin/kexec ]] && [[ -r /proc/cmdline ]] ; then
2116 alias "$(uname -r)-reboot"="kexec -l --initrd=/boot/initrd.img-"$(uname -r)" --command-line=\"$(cat /proc/cmdline)\" /boot/vmlinuz-"$(uname -r)""
2119 alias cp='nocorrect cp' # no spelling correction on cp
2120 alias mkdir='nocorrect mkdir' # no spelling correction on mkdir
2121 alias mv='nocorrect mv' # no spelling correction on mv
2122 alias rm='nocorrect rm' # no spelling correction on rm
2124 #a1# Execute \kbd{rmdir}
2126 #a1# Execute \kbd{rmdir}
2129 # see http://www.cl.cam.ac.uk/~mgk25/unicode.html#term for details
2130 alias term2iso="echo 'Setting terminal to iso mode' ; print -n '\e%@'"
2131 alias term2utf="echo 'Setting terminal to utf-8 mode'; print -n '\e%G'"
2133 # make sure it is not assigned yet
2134 [[ -n ${aliases[utf2iso]} ]] && unalias utf2iso
2137 for ENV in $(env | command grep -i '.utf') ; do
2138 eval export "$(echo $ENV | sed 's/UTF-8/iso885915/ ; s/utf8/iso885915/')"
2143 # make sure it is not assigned yet
2144 [[ -n ${aliases[iso2utf]} ]] && unalias iso2utf
2146 if ! isutfenv ; then
2147 for ENV in $(env | command grep -i '\.iso') ; do
2148 eval export "$(echo $ENV | sed 's/iso.*/UTF-8/ ; s/ISO.*/UTF-8/')"
2153 # set up software synthesizer via speakup
2155 if [ -x /usr/sbin/swspeak-setup ] ; then
2156 setopt singlelinezle
2159 /usr/sbin/swspeak-setup $@
2161 aumix -w 90 -v 90 -p 90 -m 90
2162 if ! [[ -r /dev/softsynth ]] ; then
2163 flite -o play -t "Sorry, software synthesizer not available. Did you boot with swspeak bootoption?"
2166 setopt singlelinezle
2169 nice -n -20 speechd-up
2171 flite -o play -t "Finished setting up software synthesizer"
2176 # I like clean prompt, so provide simple way to get that
2177 check_com 0 || alias 0='return 0'
2179 # for really lazy people like mika:
2180 check_com S &>/dev/null || alias S='screen'
2181 check_com s &>/dev/null || alias s='ssh'
2183 # get top 10 shell commands:
2184 alias top10='print -l ? ${(o)history%% *} | uniq -c | sort -nr | head -n 10'
2186 # truecrypt; use e.g. via 'truec /dev/ice /mnt/ice' or 'truec -i'
2187 if check_com -c truecrypt ; then
2189 alias truec='truecrypt --mount-options "rw,sync,dirsync,users,uid=1000,gid=users,umask=077,utf8" '
2191 alias truec='truecrypt --mount-options "rw,sync,dirsync,users,uid=1000,gid=users,umask=077" '
2195 #f1# Hints for the use of zsh on grml
2197 print "$bg[white]$fg[black]
2198 zsh-help - hints for use of zsh on grml
2199 =======================================$reset_color"
2202 Main configuration of zsh happens in /etc/zsh/zshrc.
2203 That file is part of the package grml-etc-core, if you want to
2204 use them on a non-grml-system just get the tar.gz from
2205 http://deb.grml.org/ or (preferably) get it from the git repository:
2207 http://git.grml.org/f/grml-etc-core/etc/zsh/zshrc
2209 This version of grml'\''s zsh setup does not use skel/.zshrc anymore.
2210 The file is still there, but it is empty for backwards compatibility.
2212 For your own changes use these two files:
2216 The former is sourced very early in our zshrc, the latter is sourced
2219 System wide configuration without touching configuration files of grml
2220 can take place in /etc/zsh/zshrc.local.
2222 Normally, the root user (EUID == 0) does not get the whole grml setup.
2223 If you want to force the whole setup for that user, too, set
2224 GRML_ALWAYS_LOAD_ALL=1 in .zshrc.pre in root'\''s home directory.
2226 For information regarding zsh start at http://grml.org/zsh/
2228 Take a look at grml'\''s zsh refcard:
2229 % xpdf =(zcat /usr/share/doc/grml-docs/zsh/grml-zsh-refcard.pdf.gz)
2231 Check out the main zsh refcard:
2232 % '$BROWSER' http://www.bash2zsh.com/zsh_refcard/refcard.pdf
2234 And of course visit the zsh-lovers:
2237 You can adjust some options through environment variables when
2238 invoking zsh without having to edit configuration files.
2239 Basically meant for bash users who are not used to the power of
2242 "NOCOR=1 zsh" => deactivate automatic correction
2243 "NOMENU=1 zsh" => do not use auto menu completion (note: use ctrl-d for completion instead!)
2244 "NOPRECMD=1 zsh" => disable the precmd + preexec commands (set GNU screen title)
2245 "NOTITLE=1 zsh" => disable setting the title of xterms without disabling
2246 preexec() and precmd() completely
2247 "BATTERY=1 zsh" => activate battery status (via acpi) on right side of prompt
2248 "COMMAND_NOT_FOUND=1 zsh"
2249 => Enable a handler if an external command was not found
2250 The command called in the handler can be altered by setting
2251 the GRML_ZSH_CNF_HANDLER variable, the default is:
2252 "/usr/share/command-not-found/command-not-found"
2254 A value greater than 0 is enables a feature; a value equal to zero
2255 disables it. If you like one or the other of these settings, you can
2256 add them to ~/.zshrc.pre to ensure they are set when sourcing grml'\''s
2260 $bg[white]$fg[black]
2261 Please report wishes + bugs to the grml-team: http://grml.org/bugs/
2262 Enjoy your grml system with the zsh!$reset_color"
2266 if [[ -r /etc/debian_version ]] ; then
2267 #a3# Execute \kbd{apt-cache search}
2268 alias acs='apt-cache search'
2269 #a3# Execute \kbd{apt-cache show}
2270 alias acsh='apt-cache show'
2271 #a3# Execute \kbd{apt-cache policy}
2272 alias acp='apt-cache policy'
2273 #a3# Execute \kbd{apt-get dist-upgrade}
2274 salias adg="apt-get dist-upgrade"
2275 #a3# Execute \kbd{apt-get install}
2276 salias agi="apt-get install"
2277 #a3# Execute \kbd{aptitude install}
2278 salias ati="aptitude install"
2279 #a3# Execute \kbd{apt-get upgrade}
2280 salias ag="apt-get upgrade"
2281 #a3# Execute \kbd{apt-get update}
2282 salias au="apt-get update"
2283 #a3# Execute \kbd{aptitude update ; aptitude safe-upgrade}
2284 salias -a up="aptitude update ; aptitude safe-upgrade"
2285 #a3# Execute \kbd{dpkg-buildpackage}
2286 alias dbp='dpkg-buildpackage'
2287 #a3# Execute \kbd{grep-excuses}
2288 alias ge='grep-excuses'
2291 #f3# Execute \kbd{apt-get update \&\& }\\&\quad \kbd{apt-get dist-upgrade}
2294 if [[ -z $1 ]] ; then
2295 $SUDO apt-get update
2296 $SUDO apt-get -u upgrade
2298 ssh $1 $SUDO apt-get update
2299 # ask before the upgrade
2301 ssh $1 $SUDO apt-get --no-act upgrade
2302 echo -n 'Process the upgrade?'
2304 if [[ $dummy == "y" ]] ; then
2305 ssh $1 $SUDO apt-get -u upgrade --yes
2310 # get a root shell as normal user in live-cd mode:
2311 if isgrmlcd && [[ $UID -ne 0 ]] ; then
2315 #a1# Take a look at the syslog: \kbd{\$PAGER /var/log/syslog}
2316 salias llog="$PAGER /var/log/syslog" # take a look at the syslog
2317 #a1# Take a look at the syslog: \kbd{tail -f /var/log/syslog}
2318 salias tlog="tail -f /var/log/syslog" # follow the syslog
2321 # sort installed Debian-packages by size
2322 if check_com -c grep-status ; then
2323 #a3# List installed Debian-packages sorted by size
2324 alias debs-by-size='grep-status -FStatus -sInstalled-Size,Package -n "install ok installed" | paste -sd " \n" | sort -rn'
2327 # if cdrecord is a symlink (to wodim) or isn't present at all warn:
2328 if [[ -L /usr/bin/cdrecord ]] || ! check_com -c cdrecord ; then
2329 if check_com -c wodim ; then
2330 alias cdrecord="echo 'cdrecord is not provided under its original name by Debian anymore.
2331 See #377109 in the BTS of Debian for more details.
2333 Please use the wodim binary instead' ; return 1"
2337 # get_tw_cli has been renamed into get_3ware
2338 if check_com -c get_3ware ; then
2340 echo 'Warning: get_tw_cli has been renamed into get_3ware. Invoking get_3ware for you.'>&2
2345 # I hate lacking backward compatibility, so provide an alternative therefore
2346 if ! check_com -c apache2-ssl-certificate ; then
2348 apache2-ssl-certificate() {
2350 print 'Debian does not ship apache2-ssl-certificate anymore (see #398520). :('
2351 print 'You might want to take a look at Debian the package ssl-cert as well.'
2352 print 'To generate a certificate for use with apache2 follow the instructions:'
2356 export RANDFILE=/dev/random
2357 mkdir /etc/apache2/ssl/
2358 openssl req $@ -new -x509 -days 365 -nodes -out /etc/apache2/ssl/apache.pem -keyout /etc/apache2/ssl/apache.pem
2359 chmod 600 /etc/apache2/ssl/apache.pem
2361 Run "grml-tips ssl-certificate" if you need further instructions.
2367 # {{{ Use hard limits, except for a smaller stack and no core dumps
2369 is425 && limit stack 8192
2370 isgrmlcd && limit core 0 # important for a live-cd-system
2374 # {{{ completion system
2376 # called later (via is4 && grmlcomp)
2377 # note: use 'zstyle' for getting current settings
2378 # press ^Xh (control-x h) for getting tags in context; ^X? (control-x ?) to run complete_debug with trace output
2380 # TODO: This could use some additional information
2382 # allow one error for every three characters typed in approximate completer
2383 zstyle ':completion:*:approximate:' max-errors 'reply=( $((($#PREFIX+$#SUFFIX)/3 )) numeric )'
2385 # don't complete backup files as executables
2386 zstyle ':completion:*:complete:-command-::commands' ignored-patterns '(aptitude-*|*\~)'
2388 # start menu completion only if it could find no unambiguous initial string
2389 zstyle ':completion:*:correct:*' insert-unambiguous true
2390 zstyle ':completion:*:corrections' format $'%{\e[0;31m%}%d (errors: %e)%{\e[0m%}'
2391 zstyle ':completion:*:correct:*' original true
2393 # activate color-completion
2394 zstyle ':completion:*:default' list-colors ${(s.:.)LS_COLORS}
2396 # format on completion
2397 zstyle ':completion:*:descriptions' format $'%{\e[0;31m%}completing %B%d%b%{\e[0m%}'
2399 # complete 'cd -<tab>' with menu
2400 zstyle ':completion:*:*:cd:*:directory-stack' menu yes select
2402 # insert all expansions for expand completer
2403 zstyle ':completion:*:expand:*' tag-order all-expansions
2404 zstyle ':completion:*:history-words' list false
2407 zstyle ':completion:*:history-words' menu yes
2409 # ignore duplicate entries
2410 zstyle ':completion:*:history-words' remove-all-dups yes
2411 zstyle ':completion:*:history-words' stop yes
2413 # match uppercase from lowercase
2414 zstyle ':completion:*' matcher-list 'm:{a-z}={A-Z}'
2416 # separate matches into groups
2417 zstyle ':completion:*:matches' group 'yes'
2418 zstyle ':completion:*' group-name ''
2420 if [[ "$NOMENU" -eq 0 ]] ; then
2421 # if there are more than 5 options allow selecting from a menu
2422 zstyle ':completion:*' menu select=5
2424 # don't use any menus at all
2428 zstyle ':completion:*:messages' format '%d'
2429 zstyle ':completion:*:options' auto-description '%d'
2431 # describe options in full
2432 zstyle ':completion:*:options' description 'yes'
2434 # on processes completion complete all user processes
2435 zstyle ':completion:*:processes' command 'ps -au$USER'
2437 # offer indexes before parameters in subscripts
2438 zstyle ':completion:*:*:-subscript-:*' tag-order indexes parameters
2440 # provide verbose completion information
2441 zstyle ':completion:*' verbose true
2443 # recent (as of Dec 2007) zsh versions are able to provide descriptions
2444 # for commands (read: 1st word in the line) that it will list for the user
2445 # to choose from. The following disables that, because it's not exactly fast.
2446 zstyle ':completion:*:-command-:*:' verbose false
2448 # set format for warnings
2449 zstyle ':completion:*:warnings' format $'%{\e[0;31m%}No matches for:%{\e[0m%} %d'
2451 # define files to ignore for zcompile
2452 zstyle ':completion:*:*:zcompile:*' ignored-patterns '(*~|*.zwc)'
2453 zstyle ':completion:correct:' prompt 'correct to: %e'
2455 # Ignore completion functions for commands you don't have:
2456 zstyle ':completion::(^approximate*):*:functions' ignored-patterns '_*'
2458 # Provide more processes in completion of programs like killall:
2459 zstyle ':completion:*:processes-names' command 'ps c -u ${USER} -o command | uniq'
2461 # complete manual by their section
2462 zstyle ':completion:*:manuals' separate-sections true
2463 zstyle ':completion:*:manuals.*' insert-sections true
2464 zstyle ':completion:*:man:*' menu yes select
2466 # provide .. as a completion
2467 zstyle ':completion:*' special-dirs ..
2469 # run rehash on completion so new installed program are found automatically:
2471 (( CURRENT == 1 )) && rehash
2476 # some people don't like the automatic correction - so run 'NOCOR=1 zsh' to deactivate it
2477 if [[ "$NOCOR" -gt 0 ]] ; then
2478 zstyle ':completion:*' completer _oldlist _expand _force_rehash _complete _files _ignored
2481 # try to be smart about when to use what completer...
2483 zstyle -e ':completion:*' completer '
2484 if [[ $_last_try != "$HISTNO$BUFFER$CURSOR" ]] ; then
2485 _last_try="$HISTNO$BUFFER$CURSOR"
2486 reply=(_complete _match _ignored _prefix _files)
2488 if [[ $words[1] == (rm|mv) ]] ; then
2489 reply=(_complete _files)
2491 reply=(_oldlist _expand _force_rehash _complete _ignored _correct _approximate _files)
2496 # command for process lists, the local web server details and host completion
2497 zstyle ':completion:*:urls' local 'www' '/var/www/' 'public_html'
2500 [[ -d $ZSHDIR/cache ]] && zstyle ':completion:*' use-cache yes && \
2501 zstyle ':completion::complete:*' cache-path $ZSHDIR/cache/
2503 # host completion /* add brackets as vim can't parse zsh's complex cmdlines 8-) {{{ */
2505 [[ -r ~/.ssh/known_hosts ]] && _ssh_hosts=(${${${${(f)"$(<$HOME/.ssh/known_hosts)"}:#[\|]*}%%\ *}%%,*}) || _ssh_hosts=()
2506 [[ -r /etc/hosts ]] && : ${(A)_etc_hosts:=${(s: :)${(ps:\t:)${${(f)~~"$(</etc/hosts)"}%%\#*}##[:blank:]#[^[:blank:]]#}}} || _etc_hosts=()
2518 zstyle ':completion:*:hosts' hosts $hosts
2519 # TODO: so, why is this here?
2520 # zstyle '*' hosts $hosts
2522 # use generic completion system for programs not yet defined; (_gnu_generic works
2523 # with commands that provide a --help option with "standard" gnu-like output.)
2524 for compcom in cp deborphan df feh fetchipac head hnb ipacsum mv \
2525 pal stow tail uname ; do
2526 [[ -z ${_comps[$compcom]} ]] && compdef _gnu_generic ${compcom}
2529 # see upgrade function in this file
2530 compdef _hosts upgrade
2536 # people should use 'grml-x'!
2538 if [[ -e /etc/X11/xorg.conf ]] ; then
2539 [[ -x /usr/bin/startx ]] && /usr/bin/startx "$@" || /usr/X11R6/bin/startx "$@"
2541 echo "Please use the script \"grml-x\" for starting the X Window System
2542 because there does not exist /etc/X11/xorg.conf yet.
2543 If you want to use startx anyway please call \"/usr/bin/startx\"."
2549 if [[ -e /etc/X11/xorg.conf ]] ; then
2550 [[ -x /usr/bin/xinit ]] && /usr/bin/xinit || /usr/X11R6/bin/xinit
2552 echo "Please use the script \"grml-x\" for starting the X Window System.
2553 because there does not exist /etc/X11/xorg.conf yet.
2554 If you want to use xinit anyway please call \"/usr/bin/xinit\"."
2559 if check_com -c 915resolution ; then
2560 alias 855resolution='echo -e "Please use 915resolution as resolution modify tool for Intel graphic chipset."; return -1'
2563 #a1# Output version of running grml
2564 alias grml-version='cat /etc/grml_version'
2566 if check_com -c rebuildfstab ; then
2567 #a1# Rebuild /etc/fstab
2568 alias grml-rebuildfstab='rebuildfstab -v -r -config'
2571 if check_com -c grml-debootstrap ; then
2572 alias debian2hd='print "Installing debian to harddisk is possible via using grml-debootstrap." ; return 1'
2577 # {{{ now run the functions
2579 is4 && isgrml && grmlstuff
2584 is4 && xsource "/etc/zsh/keephack"
2587 # {{{ wonderful idea of using "e" glob qualifier by Peter Stephenson
2588 # You use it as follows:
2589 # $ NTREF=/reference/file
2591 # This lists all the files in the current directory newer than the reference file.
2592 # You can also specify the reference file inline; note quotes:
2593 # $ ls -l *(e:'nt ~/.zshenv':)
2595 if [[ -n $1 ]] ; then
2598 [[ $REPLY -nt $NTREF ]]
2602 # shell functions {{{
2604 #f1# Provide csh compatibility
2605 setenv() { typeset -x "${1}${1:+=}${(@)argv[2,$#]}" } # csh compatibility
2607 #f1# Reload an autoloadable function
2608 freload() { while (( $# )); do; unfunction $1; autoload -U $1; shift; done }
2609 compdef _functions freload
2611 #f1# List symlinks in detail (more detailed version of 'readlink -f' and 'whence -s')
2613 [[ -z "$1" ]] && printf 'Usage: %s <file(s)>\n' "$0" && return 1
2614 for file in "$@" ; do
2615 while [[ -h "$file" ]] ; do
2617 file=$(readlink "$file")
2622 # fast manual access
2623 if check_com qma ; then
2624 #f1# View the zsh manual
2625 manzsh() { qma zshall "$1" }
2628 manzsh() { /usr/bin/man zshall | vim -c "se ft=man| se hlsearch" +/"$1" - ; }
2631 # TODO: Is it supported to use pager settings like this?
2632 # PAGER='less -Mr' - If so, the use of $PAGER here needs fixing
2633 # with respect to wordsplitting. (ie. ${=PAGER})
2634 if check_com -c $PAGER ; then
2635 #f1# View Debian's changelog of a given package
2638 if [[ -r /usr/share/doc/$1/changelog.Debian.gz ]] ; then
2639 $PAGER /usr/share/doc/$1/changelog.Debian.gz
2640 elif [[ -r /usr/share/doc/$1/changelog.gz ]] ; then
2641 $PAGER /usr/share/doc/$1/changelog.gz
2643 if check_com -c aptitude ; then
2644 echo "No changelog for package $1 found, using aptitude to retrieve it."
2646 aptitude -t unstable changelog $1
2648 aptitude changelog $1
2651 echo "No changelog for package $1 found, sorry."
2656 _dchange() { _files -W /usr/share/doc -/ }
2657 compdef _dchange dchange
2659 #f1# View Debian's NEWS of a given package
2662 if [[ -r /usr/share/doc/$1/NEWS.Debian.gz ]] ; then
2663 $PAGER /usr/share/doc/$1/NEWS.Debian.gz
2665 if [[ -r /usr/share/doc/$1/NEWS.gz ]] ; then
2666 $PAGER /usr/share/doc/$1/NEWS.gz
2668 echo "No NEWS file for package $1 found, sorry."
2673 _dnews() { _files -W /usr/share/doc -/ }
2674 compdef _dnews dnews
2676 #f1# View upstream's changelog of a given package
2679 if [[ -r /usr/share/doc/$1/changelog.gz ]] ; then
2680 $PAGER /usr/share/doc/$1/changelog.gz
2682 echo "No changelog for package $1 found, sorry."
2686 _uchange() { _files -W /usr/share/doc -/ }
2687 compdef _uchange uchange
2692 ZSH_PROFILE_RC=1 $SHELL "$@"
2695 #f1# Edit an alias via zle
2697 [[ -z "$1" ]] && { echo "Usage: edalias <alias_to_edit>" ; return 1 } || vared aliases'[$1]' ;
2699 compdef _aliases edalias
2701 #f1# Edit a function via zle
2703 [[ -z "$1" ]] && { echo "Usage: edfun <function_to_edit>" ; return 1 } || zed -f "$1" ;
2705 compdef _functions edfunc
2707 # use it e.g. via 'Restart apache2'
2708 #m# f6 Start() \kbd{/etc/init.d/\em{process}}\quad\kbd{start}
2709 #m# f6 Restart() \kbd{/etc/init.d/\em{process}}\quad\kbd{restart}
2710 #m# f6 Stop() \kbd{/etc/init.d/\em{process}}\quad\kbd{stop}
2711 #m# f6 Reload() \kbd{/etc/init.d/\em{process}}\quad\kbd{reload}
2712 #m# f6 Force-Reload() \kbd{/etc/init.d/\em{process}}\quad\kbd{force-reload}
2713 if [[ -d /etc/init.d || -d /etc/service ]] ; then
2715 local action_="${1:l}" # e.g Start/Stop/Restart
2719 local service_target_="$(readlink /etc/init.d/$service_)"
2720 if [[ $service_target_ == "/usr/bin/sv" ]]; then
2722 case "${action_}" in
2723 start) if [[ ! -e /etc/service/$service_ ]]; then
2724 $SUDO ln -s "/etc/sv/$service_" "/etc/service/"
2726 $SUDO "/etc/init.d/$service_" "${action_}" "$param_"
2728 # there is no reload in runits sysv emulation
2729 reload) $SUDO "/etc/init.d/$service_" "force-reload" "$param_" ;;
2730 *) $SUDO "/etc/init.d/$service_" "${action_}" "$param_" ;;
2734 $SUDO "/etc/init.d/$service_" "${action_}" "$param_"
2738 for i in Start Restart Stop Force-Reload Reload ; do
2739 eval "$i() { __start_stop $i \"\$1\" \"\$2\" ; }"
2743 #f1# Provides useful information on globbing
2750 p named pipes (FIFOs)
2751 * executable plain files (0100)
2752 % device files (character or block special)
2753 %b block special files
2754 %c character special files
2755 r owner-readable files (0400)
2756 w owner-writable files (0200)
2757 x owner-executable files (0100)
2758 A group-readable files (0040)
2759 I group-writable files (0020)
2760 E group-executable files (0010)
2761 R world-readable files (0004)
2762 W world-writable files (0002)
2763 X world-executable files (0001)
2764 s setuid files (04000)
2765 S setgid files (02000)
2766 t files with the sticky bit (01000)
2768 print *(m-1) # Files modified up to a day ago
2769 print *(a1) # Files accessed a day ago
2770 print *(@) # Just symlinks
2771 print *(Lk+50) # Files bigger than 50 kilobytes
2772 print *(Lk-50) # Files smaller than 50 kilobytes
2773 print **/*.c # All *.c files recursively starting in \$PWD
2774 print **/*.c~file.c # Same as above, but excluding 'file.c'
2775 print (foo|bar).* # Files starting with 'foo' or 'bar'
2776 print *~*.* # All Files that do not contain a dot
2777 chmod 644 *(.^x) # make all plain non-executable files publically readable
2778 print -l *(.c|.h) # Lists *.c and *.h
2779 print **/*(g:users:) # Recursively match all files that are owned by group 'users'
2780 echo /proc/*/cwd(:h:t:s/self//) # Analogous to >ps ax | awk '{print $1}'<"
2782 alias help-zshglob=H-Glob
2784 check_com -c qma && alias ?='qma zshall'
2786 # grep for running process, like: 'any vim'
2789 if [[ -z "$1" ]] ; then
2790 echo "any - grep for process(es) by keyword" >&2
2791 echo "Usage: any <keyword>" >&2 ; return 1
2794 local LENGTH=$(expr length $STRING)
2795 local FIRSCHAR=$(echo $(expr substr $STRING 1 1))
2796 local REST=$(echo $(expr substr $STRING 2 $LENGTH))
2797 ps xauwww| grep "[$FIRSCHAR]$REST"
2801 # After resuming from suspend, system is paging heavily, leading to very bad interactivity.
2802 # taken from $LINUX-KERNELSOURCE/Documentation/power/swsusp.txt
2803 [[ -r /proc/1/maps ]] && \
2805 print 'Reading /proc/[0-9]*/maps and sending output to /dev/null, this might take a while.'
2806 cat $(sed -ne 's:.* /:/:p' /proc/[0-9]*/maps | sort -u | grep -v '^/dev/') > /dev/null
2807 print 'Finished, running "swapoff -a; swapon -a" may also be useful.'
2810 # print hex value of a number
2813 [[ -n "$1" ]] && printf "%x\n" $1 || { print 'Usage: hex <number-to-convert>' ; return 1 }
2816 # calculate (or eval at all ;-)) with perl => p[erl-]eval
2817 # hint: also take a look at zcalc -> 'autoload zcalc' -> 'man zshmodules | less -p MATHFUNC'
2819 [[ -n "$1" ]] && CALC="$*" || print "Usage: calc [expression]"
2820 perl -e "print eval($CALC),\"\n\";"
2822 functions peval &>/dev/null && alias calc=peval
2824 # brltty seems to have problems with utf8 environment and/or font Uni3-Terminus16 under
2825 # certain circumstances, so work around it, no matter which environment we have
2827 if [[ -z "$DISPLAY" ]] ; then
2828 consolechars -f /usr/share/consolefonts/default8x16.psf.gz
2835 # just press 'asdf' keys to toggle between dvorak and us keyboard layout
2837 echo -n 'Switching to us keyboard layout: '
2838 [[ -z "$DISPLAY" ]] && $SUDO loadkeys us &>/dev/null || setxkbmap us &>/dev/null
2842 echo -n 'Switching to dvorak keyboard layout: '
2843 [[ -z "$DISPLAY" ]] && $SUDO loadkeys dvorak &>/dev/null || setxkbmap dvorak &>/dev/null
2846 # just press 'asdf' key to toggle from neon layout to us keyboard layout
2848 echo -n 'Switching to us keyboard layout: '
2849 setxkbmap us && echo 'Done' || echo 'Failed'
2852 # set up an ipv6 tunnel
2857 if ifconfig sit1 2>/dev/null | grep -q 'inet6 addr: 2002:.*:1::1' ; then
2858 print 'ipv6 tunnel already set up, nothing to be done.'
2859 print 'execute: "ifconfig sit1 down ; ifconfig sit0 down" to remove ipv6-tunnel.' ; return 1
2861 [[ -n "$PUBLIC_IP" ]] || \
2862 local PUBLIC_IP=$(ifconfig $(route -n | awk '/^0\.0\.0\.0/{print $8; exit}') | \
2863 awk '/inet addr:/ {print $2}' | tr -d 'addr:')
2865 [[ -n "$PUBLIC_IP" ]] || { print 'No $PUBLIC_IP set and could not determine default one.' ; return 1 }
2866 local IPV6ADDR=$(printf "2002:%02x%02x:%02x%02x:1::1" $(print ${PUBLIC_IP//./ }))
2867 print -n "Setting up ipv6 tunnel $IPV6ADDR via ${PUBLIC_IP}: "
2868 ifconfig sit0 tunnel ::192.88.99.1 up
2869 ifconfig sit1 add "$IPV6ADDR" && print done || print failed
2873 if ifconfig sit1 2>/dev/null | grep -q 'inet6 addr: 2002:.*:1::1' ; then
2874 print 'ipv6 tunnel available' ; return 0
2876 print 'ipv6 tunnel not available' ; return 1
2880 if ifconfig sit1 2>/dev/null | grep -q 'inet6 addr: 2002:.*:1::1' ; then
2881 print -n 'Stopping ipv6 tunnel (sit0 + sit1): '
2882 ifconfig sit1 down ; ifconfig sit0 down && print done || print failed
2884 print 'No ipv6 tunnel found, nothing to be done.' ; return 1
2888 print "Usage: ipv6-tunnel [start|stop|status]">&2 ; return 1
2893 # run dhclient for wireless device
2895 salias dhclient "$(wavemon -d | awk '/device/{print $2}')"
2898 # spawn a minimally set up ksh - useful if you want to umount /usr/.
2900 exec env -i ENV="/etc/minimal-shellrc" HOME="$HOME" TERM="$TERM" ksh
2903 # a wrapper for vim, that deals with title setting
2905 # set this array to a set of options to vim you always want
2906 # to have set when calling vim (in .zshrc.local), like:
2907 # VIM_OPTIONS=( -p )
2908 # This will cause vim to send every file given on the
2909 # commandline to be send to it's own tab (needs vim7).
2911 VIM_PLEASE_SET_TITLE='yes' command vim ${VIM_OPTIONS} "$@"
2914 # make a backup of a file
2916 cp -a "$1" "${1}_$(date --iso-8601=seconds)"
2919 #f1# grep for patterns in grml's zsh setup
2925 print "usage: zg -[anr] <pattern>\n";
2926 print " Search for patterns in grml'\''s zshrc.\n";
2927 print " zg takes no or exactly one option plus a non empty pattern.\n\n";
2928 print " options:\n";
2929 print " -- no options (use if your pattern starts in with a dash.\n";
2930 print " -a search for the pattern in all code regions\n";
2931 print " -n search for the pattern in non-root code only\n";
2932 print " -r search in code for everyone (also root) only\n\n";
2933 print " The default is -a for non-root users and -r for root.\n\n";
2934 print " If you installed the zshrc to a non-default locations (ie *NOT*\n";
2935 print " in /etc/zsh/zshrc) do: export GRML_ZSHRC=\$HOME/.zshrc\n";
2936 print " ...in case you copied the file to that location.\n\n";
2940 if ($ENV{GRML_ZSHRC} ne "") {
2941 $RC = $ENV{GRML_ZSHRC};
2943 $RC = "/etc/zsh/zshrc";
2946 usage if ($#ARGV < 0 || $#ARGV > 1);
2947 if ($> == 0) { $mode = "allonly"; }
2948 else { $mode = "all"; }
2951 if ($opt eq "--") { shift; }
2952 elsif ($opt eq "-a") { $mode = "all"; shift; }
2953 elsif ($opt eq "-n") { $mode = "nonroot"; shift; }
2954 elsif ($opt eq "-r" ) { $mode = "allonly"; shift; }
2955 elsif ($opt =~ m/^-/ || $#ARGV > 0) { usage(); }
2957 $pattern = $ARGV[0];
2958 usage() if ($pattern eq "");
2960 open FH, "<$RC" or die "zg: Could not open $RC: $!\n";
2961 while ($line = <FH>) {
2963 if ($line =~ m/^#:grep:marker:for:mika:/) { $markerfound = 1; next; }
2964 next if ($mode eq "nonroot" && markerfound == 0);
2965 break if ($mode eq "allonly" && markerfound == 1);
2966 print $line, "\n" if ($line =~ /$pattern/);
2978 # {{{ make sure our environment is clean regarding colors
2979 for color in BLUE RED GREEN CYAN YELLOW MAGENTA WHITE ; unset $color
2982 # "persistent history" {{{
2983 # just write important commands you always need to ~/.important_commands
2984 if [[ -r ~/.important_commands ]] ; then
2985 fc -R ~/.important_commands
2989 #:grep:marker:for:mika: :-)
2990 ### non-root (EUID != 0) code below
2993 if (( GRML_ALWAYS_LOAD_ALL == 0 )) && (( $EUID == 0 )) ; then
3001 # set terminal property (used e.g. by msgid-chooser)
3002 export COLORTERM="yes"
3004 # set default browser
3005 if [[ -z "$BROWSER" ]] ; then
3006 if [[ -n "$DISPLAY" ]] ; then
3007 #v# If X11 is running
3008 check_com -c firefox && export BROWSER=firefox
3010 #v# If no X11 is running
3011 check_com -c w3m && export BROWSER=w3m
3015 #m# v QTDIR \kbd{/usr/share/qt[34]}\quad [for non-root only]
3016 [[ -d /usr/share/qt3 ]] && export QTDIR=/usr/share/qt3
3017 [[ -d /usr/share/qt4 ]] && export QTDIR=/usr/share/qt4
3019 # support running 'jikes *.java && jamvm HelloWorld' OOTB:
3020 #v# [for non-root only]
3021 [[ -f /usr/share/classpath/glibj.zip ]] && export JIKESPATH=/usr/share/classpath/glibj.zip
3026 # Xterm resizing-fu.
3027 # Based on http://svn.kitenet.net/trunk/home-full/.zshrc?rev=11710&view=log (by Joey Hess)
3028 alias hide='echo -en "\033]50;nil2\007"'
3029 alias tiny='echo -en "\033]50;-misc-fixed-medium-r-normal-*-*-80-*-*-c-*-iso8859-15\007"'
3030 alias small='echo -en "\033]50;6x10\007"'
3031 alias medium='echo -en "\033]50;-misc-fixed-medium-r-normal--13-120-75-75-c-80-iso8859-15\007"'
3032 alias default='echo -e "\033]50;-misc-fixed-medium-r-normal-*-*-140-*-*-c-*-iso8859-15\007"'
3033 alias large='echo -en "\033]50;-misc-fixed-medium-r-normal-*-*-150-*-*-c-*-iso8859-15\007"'
3034 alias huge='echo -en "\033]50;-misc-fixed-medium-r-normal-*-*-210-*-*-c-*-iso8859-15\007"'
3035 alias smartfont='echo -en "\033]50;-artwiz-smoothansi-*-*-*-*-*-*-*-*-*-*-*-*\007"'
3036 alias semifont='echo -en "\033]50;-misc-fixed-medium-r-semicondensed-*-*-120-*-*-*-*-iso8859-15\007"'
3039 #a2# Execute \kbd{du -sch}
3041 #a2# Execute \kbd{jobs -l}
3045 #a2# Execute \kbd{./configure}
3046 alias CO="./configure"
3047 #a2# Execute \kbd{./configure --help}
3048 alias CH="./configure --help"
3051 #a2# Execute \kbd{ls -lSrah}
3052 alias dir="ls -lSrah"
3053 #a2# Only show dot-directories
3054 alias lad='ls -d .*(/)' # only show dot-directories
3055 #a2# Only show dot-files
3056 alias lsa='ls -a .*(.)' # only show dot-files
3057 #a2# Only files with setgid/setuid/sticky flag
3058 alias lss='ls -l *(s,S,t)' # only files with setgid/setuid/sticky flag
3059 #a2# Only show 1st ten symlinks
3060 alias lsl='ls -l *(@)' # only symlinks
3061 #a2# Display only executables
3062 alias lsx='ls -l *(*)' # only executables
3063 #a2# Display world-{readable,writable,executable} files
3064 alias lsw='ls -ld *(R,W,X.^ND/)' # world-{readable,writable,executable} files
3065 #a2# Display the ten biggest files
3066 alias lsbig="ls -flh *(.OL[1,10])" # display the biggest files
3067 #a2# Only show directories
3068 alias lsd='ls -d *(/)' # only show directories
3069 #a2# Only show empty directories
3070 alias lse='ls -d *(/^F)' # only show empty directories
3071 #a2# Display the ten newest files
3072 alias lsnew="ls -rl *(D.om[1,10])" # display the newest files
3073 #a2# Display the ten oldest files
3074 alias lsold="ls -rtlh *(D.om[1,10])" # display the oldest files
3075 #a2# Display the ten smallest files
3076 alias lssmall="ls -Srl *(.oL[1,10])" # display the smallest files
3079 #a2# Execute \kbd{chmod 600}
3080 alias rw-='chmod 600'
3081 #a2# Execute \kbd{chmod 700}
3082 alias rwx='chmod 700'
3083 #m# a2 r-{}- Execute \kbd{chmod 644}
3084 alias r--='chmod 644'
3085 #a2# Execute \kbd{chmod 755}
3086 alias r-x='chmod 755'
3088 # some useful aliases
3089 #a2# Execute \kbd{mkdir -o}
3093 #a2# Execute \kbd{mplayer -vo fbdev}
3094 alias cmplayer='mplayer -vo fbdev'
3095 #a2# Execute \kbd{mplayer -vo fbdev -fs -zoom}
3096 alias fbmplayer='mplayer -vo fbdev -fs -zoom'
3097 #a2# Execute \kbd{links2 -driver fb}
3098 alias fblinks='links2 -driver fb'
3100 #a2# ssh with StrictHostKeyChecking=no \\&\quad and UserKnownHostsFile unset
3101 alias insecssh='ssh -o "StrictHostKeyChecking=no" -o "UserKnownHostsFile=/dev/null"'
3102 alias insecscp='scp -o "StrictHostKeyChecking=no" -o "UserKnownHostsFile=/dev/null"'
3105 check_com -c python && alias http="python -m SimpleHTTPServer"
3107 # Use 'g' instead of 'git':
3108 check_com g || alias g='git'
3110 # work around non utf8 capable software in utf environment via $LANG and luit
3111 if check_com isutfenv && check_com luit ; then
3112 if check_com -c mrxvt ; then
3113 isutfenv && [[ -n "$LANG" ]] && \
3114 alias mrxvt="LANG=${LANG/(#b)(*)[.@]*/$match[1].iso885915} luit mrxvt"
3117 if check_com -c aterm ; then
3118 isutfenv && [[ -n "$LANG" ]] && \
3119 alias aterm="LANG=${LANG/(#b)(*)[.@]*/$match[1].iso885915} luit aterm"
3122 if check_com -c centericq ; then
3123 isutfenv && [[ -n "$LANG" ]] && \
3124 alias centericq="LANG=${LANG/(#b)(*)[.@]*/$match[1].iso885915} luit centericq"
3129 # useful functions {{{
3132 #f4# Search for newspostings from authors
3133 agoogle() { ${=BROWSER} "http://groups.google.com/groups?as_uauthors=$*" ; }
3134 #f4# Search Debian Bug Tracking System
3138 if [[ $# -eq 1 ]]; then
3141 ${=BROWSER} "http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=$1"
3144 ${=BROWSER} "http://bugs.debian.org/cgi-bin/pkgreport.cgi?submitter=$1"
3147 ${=BROWSER} "http://bugs.debian.org/$*"
3151 print "$0 needs one argument"
3155 #f4# Search Debian Bug Tracking System in mbox format
3163 ${=BROWSER} http://search.dmoz.org/cgi-bin/search\?search=${1// /_}
3165 #f4# Search German Wiktionary
3168 ${=BROWSER} http://de.wiktionary.org/wiki/${(C)1// /_}
3170 #f4# Search English Wiktionary
3173 ${=BROWSER} http://en.wiktionary.org/wiki/${(C)1// /_}
3175 #f4# Search Google Groups
3178 ${=BROWSER} "http://groups.google.com/groups?q=$*"
3183 ${=BROWSER} "http://www.google.com/search?&num=100&q=$*"
3185 #f4# Search Google Groups for MsgID
3188 ${=BROWSER} "http://groups.google.com/groups?selm=$*"
3190 #f4# Search Netcraft
3193 ${=BROWSER} "http://toolbar.netcraft.com/site_report?url=$1"
3195 #f4# Use German Wikipedia's full text search
3198 ${=BROWSER} http://de.wikipedia.org/wiki/Spezial:Search/${(C)1}
3200 #f4# search \kbd{dict.leo.org}
3203 ${=BROWSER} "http://dict.leo.org/?search=$*"
3205 #f4# Search German Wikipedia
3208 ${=BROWSER} http://de.wikipedia.org/wiki/"${(C)*}"
3210 #f4# Search English Wikipedia
3213 ${=BROWSER} http://en.wikipedia.org/wiki/"${(C)*}"
3215 #f4# Search official debs
3218 ${=BROWSER} "http://packages.debian.org/search?keywords=$1&searchon=contents&suite=${2:=unstable}§ion=all"
3221 #m# f4 gex() Exact search via Google
3222 check_com google && gex () {
3223 google "\"[ $1]\" $*"
3227 #f5# Backup \kbd{file {\rm to} file\_timestamp}
3230 cp -b $1 $1_`date --iso-8601=m`
3235 diff -crd "$*" | egrep -v "^Only in |^Binary files "
3237 #f5# cd to directoy and list files
3245 cvs add $* && cvs com -m 'initial checkin' $*
3250 cvs diff -N $* |& $PAGER
3255 cvs log $* |& $PAGER
3272 #f5# Disassemble source files using gcc and as
3275 gcc -pipe -S -o - -O -g $* | as -aldh -o /dev/null
3277 #f5# Firefox remote control - open given URL
3279 firefox -a firefox -remote "openURL($1)"
3281 #f5# Create Directoy and \kbd{cd} to it
3283 mkdir -p "$@" && cd "$@"
3285 #f5# Unified diff to timestamped outputfile
3287 diff -udrP "$1" "$2" > diff.`date "+%Y-%m-%d"`."$1"
3289 #f5# Memory overview
3291 ps aux | awk '{if (NR > 1) print $5; if (NR > 2) print "+"} END { print "p" }' | dc
3293 #f5# Show contents of gzipped tar file
3296 gunzip -c $1 | tar -tf - -- | $PAGER
3298 #f5# Show contents of zip file
3301 unzip -l $1 | $PAGER
3306 diff -urd $* | egrep -v "^Only in |^Binary files "
3308 #f5# (Mis)use \kbd{vim} as \kbd{less}
3311 vim --cmd 'let no_plugin_maps = 1' -c "so \$VIMRUNTIME/macros/less.vim" "${@:--}"
3314 # Function Usage: uopen $URL/$file
3315 #f5# Download a file and display it locally
3318 if ! [[ -n "$1" ]] ; then
3319 print "Usage: uopen \$URL/\$file">&2
3323 MIME=$(curl --head $FILE | grep Content-Type | cut -d ' ' -f 2 | cut -d\; -f 1)
3325 curl $FILE | see ${MIME}:-
3329 # Function Usage: doc packagename
3330 #f5# \kbd{cd} to /usr/share/doc/\textit{package}
3333 cd /usr/share/doc/$1 && ls
3335 _doc() { _files -W /usr/share/doc -/ }
3336 check_com compdef && compdef _doc doc
3338 #f5# Make screenshot
3340 [[ ! -d ~/shots ]] && mkdir ~/shots
3341 #cd ~/shots ; sleep 5 ; import -window root -depth 8 -quality 80 `date "+%Y-%m-%d--%H:%M:%S"`.png
3342 cd ~/shots ; sleep 5; import -window root shot_`date --iso-8601=m`.jpg
3348 images=( *.{jpg,gif,png}(.N) )
3350 if [[ $#images -eq 0 ]] ; then
3351 print "No image files found"
3357 #f5# Create PDF file from source code
3362 a2ps --medium A4dj -E -o $output $*
3366 # zsh with perl-regex - use it e.g. via:
3367 # regcheck '\s\d\.\d{3}\.\d{3} Euro' ' 1.000.000 Euro'
3368 #f5# Checks whether a regex matches or not.\\&\quad Example: \kbd{regcheck '.\{3\} EUR' '500 EUR'}
3371 zmodload -i zsh/pcre
3372 pcre_compile $1 && \
3373 pcre_match $2 && echo "regex matches" || echo "regex does not match"
3376 #f5# List files which have been modified within the last {\it n} days
3382 #f5# Grep in history
3387 # use colors when GNU grep with color-support
3388 #a2# Execute \kbd{grep -{}-color=auto}
3389 (grep --help 2>/dev/null |grep -- --color) >/dev/null && alias grep='grep --color=auto'
3390 #a2# Execute \kbd{grep -i -{}-color=auto}
3391 alias GREP='grep -i --color=auto'
3393 #f5# Watch manpages in a stretched style
3394 man2() { PAGER='dash -c "sed G | /usr/bin/less"' command man "$@" ; }
3396 # d():Copyright 2005 Nikolai Weibull <nikolai@bitwi.se>
3397 # note: option AUTO_PUSHD has to be set
3398 #f5# Jump between directories
3402 local color=$fg_bold[blue]
3404 dirs -p | while read dir; do
3405 local num="${$(printf "%-4d " $i)/ /.}"
3406 printf " %s $color%s$reset_color\n" $num $dir
3410 read -r 'dir?Jump to directory: ' || return
3411 (( dir == -1 )) && return
3412 if (( dir < 0 || dir >= i )); then
3413 echo d: no such directory stack entry: $dir
3419 # usage example: 'lcheck strcpy'
3420 #f5# Find out which libs define a symbol
3422 if [[ -n "$1" ]] ; then
3423 nm -go /usr/lib/lib*.a 2>/dev/null | grep ":[[:xdigit:]]\{8\} . .*$1"
3425 echo "Usage: lcheck <function>" >&2
3429 #f5# Clean up directory - remove well known tempfiles
3431 FILES=(*~(N) .*~(N) \#*\#(N) *.o(N) a.out(N) *.core(N) *.cmo(N) *.cmi(N) .*.swp(N))
3433 if [[ $NBFILES > 0 ]] ; then
3436 echo -n "Remove these files? [y/n] "
3438 if [[ $ans == "y" ]] ; then
3440 echo ">> $PWD purged, $NBFILES files removed"
3442 echo "Ok. .. then not.."
3448 # 'translate' looks up fot a word in a file with language-to-language
3449 # translations (field separator should be " : "). A typical wordlist looks
3451 # | english-word : german-transmission
3452 # It's also only possible to translate english to german but not reciprocal.
3453 # Use the following oneliner to turn back the sort order:
3454 # $ awk -F ':' '{ print $2" : "$1" "$3 }' \
3455 # /usr/local/lib/words/en-de.ISO-8859-1.vok > ~/.translate/de-en.ISO-8859-1.vok
3456 #f5# Translates a word
3461 translate -l de-en $2
3464 translate -l en-de $2
3467 echo "Usage: $0 { -D | -E }"
3468 echo " -D == German to English"
3469 echo " -E == English to German"
3473 #f5# List all occurrences of programm in current PATH
3476 if [[ $# = 0 ]] ; then
3477 echo "Usage: $0 program"
3478 echo "Example: $0 zsh"
3479 echo "Lists all occurrences of program in the current PATH."
3481 ls -l ${^path}/*$1*(*N)
3485 # Found in the mailinglistarchive from Zsh (IIRC ~1996)
3486 #f5# Select items for specific command(s) from history
3491 echo "Usage: $0 command"
3494 cmd=(${(f)"$(grep -w $1 $HISTFILE | sort | uniq | pr -tn)"})
3495 print -l $cmd | less -F
3496 echo -n "enter number of desired command [1 - $(( ${#cmd[@]} - 1 ))]: "
3499 print -z "${cmd[$answer]#*$TAB}"
3502 # Use vim to convert plaintext to HTML
3503 #f5# Transform files to html with highlighting
3506 vim -u NONE -n -c ':syntax on' -c ':so $VIMRUNTIME/syntax/2html.vim' -c ':wqa' $1 &>/dev/null
3509 # Usage: simple-extract <file>
3510 #f5# Smart archive extractor
3513 if [[ -f $1 ]] ; then
3515 *.tar.bz2) bzip2 -v -d $1 ;;
3516 *.tar.gz) tar -xvzf $1 ;;
3519 *.bz2) bzip2 -d $1 ;;
3521 *.gz) gunzip -d $1 ;;
3522 *.tar) tar -xvf $1 ;;
3523 *.tgz) gunzip -d $1 ;;
3524 *.tbz2) tar -jxvf $1 ;;
3526 *.Z) uncompress $1 ;;
3527 *) echo "'$1' Error. Please go away" ;;
3530 echo "'$1' is not a valid file"
3534 # Usage: smartcompress <file> (<type>)
3535 #f5# Smart archive creator
3538 if [[ -n $2 ]] ; then
3540 tgz | tar.gz) tar -zcvf$1.$2 $1 ;;
3541 tbz2 | tar.bz2) tar -jcvf$1.$2 $1 ;;
3542 tar.Z) tar -Zcvf$1.$2 $1 ;;
3543 tar) tar -cvf$1.$2 $1 ;;
3544 gz | gzip) gzip $1 ;;
3545 bz2 | bzip2) bzip2 $1 ;;
3547 echo "Error: $2 is not a valid compression type"
3551 smartcompress $1 tar.gz
3555 # Usage: show-archive <archive>
3556 #f5# List an archive's content
3559 if [[ -f $1 ]] ; then
3561 *.tar.gz) gunzip -c $1 | tar -tf - -- ;;
3562 *.tar) tar -tf $1 ;;
3563 *.tgz) tar -ztf $1 ;;
3564 *.zip) unzip -l $1 ;;
3566 *.deb) dpkg-deb --fsys-tarfile $1 | tar -tf - -- ;;
3567 *) echo "'$1' Error. Please go away" ;;
3570 echo "'$1' is not a valid archive"
3574 # It's shameless stolen from <http://www.vim.org/tips/tip.php?tip_id=167>
3575 #f5# Use \kbd{vim} as your manpage reader
3578 man $* | col -b | view -c 'set ft=man nomod nolist' -
3581 # function readme() { $PAGER -- (#ia3)readme* }
3582 #f5# View all README-like files in current directory in pager
3586 files=(./(#i)*(read*me|lue*m(in|)ut)*(ND))
3587 if (($#files)) ; then
3590 print 'No README files.'
3594 # function ansi-colors()
3595 #f5# Display ANSI colors
3597 typeset esc="\033[" line1 line2
3598 echo " _ _ _40 _ _ _41_ _ _ _42 _ _ 43_ _ _ 44_ _ _45 _ _ _ 46_ _ _ 47_ _ _ 49_ _"
3599 for fore in 30 31 32 33 34 35 36 37; do
3602 for back in 40 41 42 43 44 45 46 47 49; do
3603 line1="${line1}${esc}${back};${fore}m Normal ${esc}0m"
3604 line2="${line2}${esc}${back};${fore};1m Bold ${esc}0m"
3606 echo -e "$line1\n$line2"
3610 # suidfind() { ls -latg $path | grep '^...s' }
3611 #f5# Find all files in \$PATH with setuid bit set
3612 suidfind() { ls -latg $path/*(sN) }
3614 # See above but this is /better/ ... anywise ..
3616 print 'Output will be written to ~/suid_* ...'
3617 $SUDO find / -type f \( -perm -4000 -o -perm -2000 \) -ls > ~/suid_suidfiles.`date "+%Y-%m-%d"`.out 2>&1
3618 $SUDO find / -type d \( -perm -4000 -o -perm -2000 \) -ls > ~/suid_suiddirs.`date "+%Y-%m-%d"`.out 2>&1
3619 $SUDO find / -type f \( -perm -2 -o -perm -20 \) -ls > ~/suid_writefiles.`date "+%Y-%m-%d"`.out 2>&1
3620 $SUDO find / -type d \( -perm -2 -o -perm -20 \) -ls > ~/suid_writedirs.`date "+%Y-%m-%d"`.out 2>&1
3624 # TODO: So, this is the third incarnation of this function!?
3625 #f5# Reload given functions
3627 for func in $argv ; do
3633 # a small check to see which DIR is located on which server/partition.
3634 # stolen and modified from Sven's zshrc.forall
3635 #f5# Report diskusage of a directory
3638 if [[ -n "$1" ]] ; then
3639 for dir in "$@" ; do
3640 if [[ -d "$dir" ]] ; then
3641 ( cd $dir; echo "-<$dir>"; du -shx .; echo);
3643 echo "warning: $dir does not exist" >&2
3647 for dir in $path; do
3648 if [[ -d "$dir" ]] ; then
3649 ( cd $dir; echo "-<$dir>"; du -shx .; echo);
3651 echo "warning: $dir does not exist" >&2
3657 # % slow_print `cat /etc/passwd`
3658 #f5# Slowly print out parameters
3660 for argument in "$@" ; do
3661 for ((i = 1; i <= ${#1} ;i++)) ; do
3662 print -n "${argument[i]}"
3670 #f5# Show some status info
3673 print "Date..: "$(date "+%Y-%m-%d %H:%M:%S")
3674 print "Shell.: Zsh $ZSH_VERSION (PID = $$, $SHLVL nests)"
3675 print "Term..: $TTY ($TERM), ${BAUD:+$BAUD bauds, }$COLUMNS x $LINES chars"
3676 print "Login.: $LOGNAME (UID = $EUID) on $HOST"
3677 print "System: $(cat /etc/[A-Za-z]*[_-][rv]e[lr]*)"
3678 print "Uptime:$(uptime)"
3683 #f5# Rip an audio CD
3687 cdrdao read-cd --device $DEVICE --driver generic-mmc audiocd.toc
3688 cdrdao read-cddb --device $DEVICE --driver generic-mmc audiocd.toc
3689 echo " * Would you like to burn the cd now? (yes/no)"
3691 if [[ "$input" = "yes" ]] ; then
3692 echo " ! Burning Audio CD"
3696 echo " ! Invalid response."
3701 #f5# Burn an audio CD (in combination with audiorip)
3704 cdrdao write --device $DEVICE --driver generic-mmc audiocd.toc
3705 echo " * Should I remove the temporary files? (yes/no)"
3707 if [[ "$input" = "yes" ]] ; then
3708 echo " ! Removing Temporary Files."
3713 echo " ! Invalid response."
3717 #f5# Make an audio CD from all mp3 files
3719 # TODO: do the renaming more zshish, possibly with zmv()
3722 for i in *.[Mm][Pp]3; do mv "$i" `echo $i | tr '[A-Z]' '[a-z]'`; done
3723 for i in *.mp3; do mv "$i" `echo $i | tr ' ' '_'`; done
3724 for i in *.mp3; do mpg123 -w `basename $i .mp3`.wav $i; done
3726 for i in *.wav; do sox $i.wav -r 44100 $i.wav resample; done
3729 #f5# Create an ISO image. You are prompted for\\&\quad volume name, filename and directory
3732 echo " * Volume name "
3734 echo " * ISO Name (ie. tmp.iso)"
3736 echo " * Directory or File"
3738 mkisofs -o ~/$iso -A $volume -allow-multidot -J -R -iso-level 3 -V $volume -R $files
3741 #f5# Simple thumbnails generator
3743 rm -rf thumb-* index.html
3747 <title>Images</title>
3749 <body>" > index.html
3750 for f in *.(gif|jpeg|jpg|png) ; do
3751 convert -size 100x200 "$f" -resize 100x200 thumb-"$f"
3752 echo " <a href=\"$f\"><img src=\"thumb-$f\"></a>" >> index.html
3756 </html>" >> index.html
3759 #f5# Set all ulimit parameters to \kbd{unlimited}
3770 # ogg2mp3 with bitrate of 192
3773 oggdec -o - $1 | lame -b 192 - ${1:r}.mp3
3776 #f5# RFC 2396 URL encoding in Z-Shell
3781 print ${(j::)input/(#b)([^A-Za-z0-9_.!~*\'\(\)-])/%${(l:2::0:)$(([##16]#match))}}
3784 #f5# Install x-lite (VoIP software)
3788 [[ -d ~/tmp ]] || mkdir ~/tmp
3791 echo "Downloading http://www.counterpath.com/download/X-Lite_Install.tar.gz and storing it in ~/tmp:"
3792 if wget http://www.counterpath.com/download/X-Lite_Install.tar.gz ; then
3793 unp X-Lite_Install.tar.gz && echo done || echo failed
3795 echo "Error while downloading." ; return 1
3798 if [[ -x xten-xlite/xtensoftphone ]] ; then
3799 echo "Execute xten-xlite/xtensoftphone to start xlite."
3807 echo "Downloading debian package of skype."
3808 echo "Notice: If you want to use a more recent skype version run 'getskypebeta'."
3809 wget http://www.skype.com/go/getskype-linux-deb
3810 $SUDO dpkg -i skype*.deb && echo "skype installed."
3813 #f5# Install beta-version of skype
3817 echo "Downloading debian package of skype (beta version)."
3818 wget http://www.skype.com/go/getskype-linux-beta-deb
3819 $SUDO dpkg -i skype-beta*.deb && echo "skype installed."
3822 #f5# Install gizmo (VoIP software)
3826 echo "libgtk2.0-0, gconf2, libstdc++6, libasound2 and zlib1g have to be available. Installing."
3827 $SUDO apt-get update
3828 $SUDO apt-get install libgtk2.0-0 gconf2 libstdc++6 libasound2 zlib1g
3829 wget "$(lynx --dump http://gizmo5.com/pc/download/linux/ | awk '/libstdc\+\+6.*\.deb/ {print $2}')"
3830 $SUDO dpkg -i gizmo-project*.deb && echo "gizmo installed."
3833 #f5# Get and run AIR (Automated Image and Restore)
3837 [[ -w . ]] || { echo 'Error: you do not have write permissions in this directory. Exiting.' ; return 1 }
3839 wget http://puzzle.dl.sourceforge.net/sourceforge/air-imager/air-$VER.tar.gz
3840 tar zxf air-$VER.tar.gz
3842 INTERACTIVE=no $SUDO ./install-air-1.2.8
3843 [[ -x /usr/local/bin/air ]] && [[ -n "$DISPLAY" ]] && $SUDO air
3846 #f5# Get specific git commitdiff
3849 if [[ -z $GITTREE ]] ; then
3850 GITTREE='linux/kernel/git/torvalds/linux-2.6.git'
3852 if ! [[ -z $1 ]] ; then
3853 ${=BROWSER} "http://kernel.org/git/?p=$GITTREE;a=commitdiff;h=$1"
3855 echo "Usage: git-get-diff <commit>"
3859 #f5# Get specific git commit
3862 if [[ -z $GITTREE ]] ; then
3863 GITTREE='linux/kernel/git/torvalds/linux-2.6.git'
3865 if ! [[ -z $1 ]] ; then
3866 ${=BROWSER} "http://kernel.org/git/?p=$GITTREE;a=commit;h=$1"
3868 echo "Usage: git-get-commit <commit>"
3872 #f5# Get specific git diff
3873 git-get-plaindiff () {
3875 if [[ -z $GITTREE ]] ; then
3876 GITTREE='linux/kernel/git/torvalds/linux-2.6.git'
3878 if [[ -z $1 ]] ; then
3879 echo 'Usage: git-get-plaindiff '
3881 echo -n "Downloading $1.diff ... "
3882 # avoid "generating ..." stuff from kernel.org server:
3883 wget --quiet "http://kernel.org/git/?p=$GITTREE;a=commitdiff_plain;h=$1" -O /dev/null
3884 wget --quiet "http://kernel.org/git/?p=$GITTREE;a=commitdiff_plain;h=$1" -O $1.diff \
3885 && echo done || echo failed
3890 # http://strcat.de/blog/index.php?/archives/335-Software-sauber-deinstallieren...html
3891 #f5# Log 'make install' output
3894 [[ ! -d ~/.errorlogs ]] && mkdir ~/.errorlogs
3895 make -n install > ~/.errorlogs/${PWD##*/}-makelog
3898 #f5# Indent source code
3900 indent -npro -kr -i8 -ts8 -sob -l80 -ss -ncs "$@"
3903 # highlight important stuff in diff output, usage example: hg diff | hidiff
3904 #m# a2 hidiff \kbd{histring} oneliner for diffs
3905 check_com -c histring && \
3906 alias hidiff="histring -fE '^Comparing files .*|^diff .*' | histring -c yellow -fE '^\-.*' | histring -c green -fE '^\+.*'"
3908 # rename pictures based on information found in exif headers
3909 #f5# Rename pictures based on information found in exif headers
3912 if [[ $# -lt 1 ]] ; then
3913 echo 'Usage: jpgrename $FILES' >& 2
3916 echo -n 'Checking for jhead with version newer than 1.9: '
3917 jhead_version=`jhead -h | grep 'used by most Digital Cameras. v.*' | awk '{print $6}' | tr -d v`
3918 if [[ $jhead_version > '1.9' ]]; then
3919 echo 'success - now running jhead.'
3920 jhead -n%Y-%m-%d_%Hh%M_%f $*
3922 echo 'failed - exiting.'
3927 # open file in vim and jump to line
3928 # http://www.downgra.de/archives/2007/05/08/T19_21_11/
3932 params=(${*//(#m):[0-9]*:/\\n+${MATCH//:/}}) # replace ':23:' to '\n+23'
3933 params=(${(s|\n|)${(j|\n|)params}}) # join array using '\n', then split on all '\n'
3937 # get_ic() - queries imap servers for capabilities; real simple. no imaps
3941 if [[ ! -z $1 ]] ; then
3943 print "querying imap server on $1:${port}...\n";
3944 print "a1 capability\na2 logout\n" | nc $1 ${port}
3946 print "usage:\n $0 <imap-server> [port]"
3950 # creates a Maildir/ with its {new,cur,tmp} subdirs
3954 root=${MAILDIR_ROOT:-${HOME}/Mail}
3955 if [[ -z ${1} ]] ; then print "Usage:\n $0 <dirname>" ; return 1 ; fi
3957 mkdir -p ${root}/${subdir}/{cur,new,tmp}
3960 #f5# Change the xterm title from within GNU-screen
3963 if [[ $1 != "-f" ]] ; then
3964 if [[ -z ${DISPLAY} ]] ; then
3965 printf 'xtrename only makes sense in X11.\n'
3971 if [[ -z $1 ]] ; then
3972 printf 'usage: xtrename [-f] "title for xterm"\n'
3973 printf ' renames the title of xterm from _within_ screen.\n'
3974 printf ' also works without screen.\n'
3975 printf ' will not work if DISPLAY is unset, use -f to override.\n'
3978 print -n "\eP\e]0;${1}\C-G\e\\"
3982 # hl() highlighted less
3983 # http://ft.bewatermyfriend.org/comp/data/zsh/zfunct.html
3984 if check_com -c highlight ; then
3988 theme=${HL_THEME:-""}
3991 ( printf 'available languages (syntax parameter):\n\n' ;
3992 highlight --list-langs ; ) | less -SMr
3995 ( printf 'available themes (style parameter):\n\n' ;
3996 highlight --list-themes ; ) | less -SMr
3999 printf 'usage: hl <syntax[:theme]> <file>\n'
4000 printf ' available options: --list (-l), --themes (-t), --help (-h)\n\n'
4001 printf ' Example: hl c main.c\n'
4004 if [[ -z ${2} ]] || (( ${#argv} > 2 )) ; then
4005 printf 'usage: hl <syntax[:theme]> <file>\n'
4006 printf ' available options: --list (-l), --themes (-t), --help (-h)\n'
4007 (( ${#argv} > 2 )) && printf ' Too many arguments.\n'
4011 [[ ${1} == *:* ]] && [[ -n ${1#*:} ]] && theme=${1#*:}
4012 if [[ -n ${theme} ]] ; then
4013 highlight --xterm256 --syntax ${lang} --style ${theme} ${2} | less -SMr
4015 highlight --ansi --syntax ${lang} ${2} | less -SMr
4021 # ... and a proper completion for hl()
4022 # needs 'highlight' as well, so it fits fine in here.
4023 function _hl_genarg() {
4025 if [[ -prefix 1 *: ]] ; then
4027 themes=(${${${(f)"$(LC_ALL=C highlight --list-themes)"}/ #/}:#*(Installed|Use name)*})
4029 _wanted -C list themes expl theme compadd ${themes}
4032 langs=(${${${(f)"$(LC_ALL=C highlight --list-langs)"}/ #/}:#*(Installed|Use name)*})
4033 _wanted -C list languages expl languages compadd -S ':' -q ${langs}
4036 function _hl_complete() {
4037 _arguments -s '1: :_hl_genarg' '2:files:_path_files'
4039 compdef _hl_complete hl
4042 # Create small urls via http://tinyurl.com using wget(1).
4045 [[ -z $1 ]] && { print "USAGE: zurl <URL>" ; return 1 }
4047 local PN url tiny grabber search result preview
4050 # Check existence of given URL with the help of ping(1).
4051 # N.B. ping(1) only works without an eventual given protocol.
4052 ping -c 1 ${${url#(ftp|http)://}%%/*} >& /dev/null || \
4053 read -q "?Given host ${${url#http://*/}%/*} is not reachable by pinging. Proceed anyway? [y|n] "
4055 if (( $? == 0 )) ; then
4056 # Prepend 'http://' to given URL where necessary for later output.
4057 [[ ${url} != http(s|)://* ]] && url='http://'${url}
4058 tiny='http://tinyurl.com/create.php?url='
4059 if check_com -c wget ; then
4060 grabber='wget -O- -o/dev/null'
4062 print "wget is not available, but mandatory for ${PN}. Aborting."
4064 # Looking for i.e.`copy('http://tinyurl.com/7efkze')' in TinyURL's HTML code.
4065 search='copy\(?http://tinyurl.com/[[:alnum:]]##*'
4066 result=${(M)${${${(f)"$(${=grabber} ${tiny}${url})"}[(fr)${search}*]}//[()\';]/}%%http:*}
4067 # TinyURL provides the rather new feature preview for more confidence. <http://tinyurl.com/preview.php>
4068 preview='http://preview.'${result#http://}
4070 printf '%s\n\n' "${PN} - Shrinking long URLs via webservice TinyURL <http://tinyurl.com>."
4071 printf '%s\t%s\n\n' 'Given URL:' ${url}
4072 printf '%s\t%s\n\t\t%s\n' 'TinyURL:' ${result} ${preview}
4078 #f2# Print a specific line of file(s).
4082 if [ $# -lt 2 ] ; then
4083 print "Usage: linenr <number>[,<number>] <file>" ; return 1
4084 elif [ $# -eq 2 ] ; then
4087 command ed -s $file <<< "${number}n"
4091 for file in "$@" ; do
4092 if [ ! -d $file ] ; then
4094 command ed -s $file <<< "${number}n" 2> /dev/null
4103 #f2# Find history events by search pattern and list them by date.
4107 local usage help ident format_l format_s first_char remain first last
4108 usage='USAGE: whatwhen [options] <searchstring> <search range>'
4109 help='Use' \`'whatwhen -h'\'' for further explanations.'
4110 ident=${(l,${#${:-Usage: }},, ,)}
4111 format_l="${ident}%s\t\t\t%s\n"
4112 format_s="${format_l//(\\t)##/\\t}"
4113 # Make the first char of the word to search for case
4114 # insensitive; e.g. [aA]
4115 first_char=[${(L)1[1]}${(U)1[1]}]
4117 # Default search range is `-100'.
4119 # Optional, just used for `<first> <last>' given.
4123 printf '%s\n\n' 'ERROR: No search string specified. Aborting.'
4124 printf '%s\n%s\n\n' ${usage} ${help} && return 1
4127 printf '%s\n\n' ${usage}
4129 printf $format_l '-h' 'show help text'
4131 print 'SEARCH RANGE:'
4132 printf $format_l "'0'" 'the whole history,'
4133 printf $format_l '-<n>' 'offset to the current history number; (default: -100)'
4134 printf $format_s '<[-]first> [<last>]' 'just searching within a give range'
4135 printf '\n%s\n' 'EXAMPLES:'
4136 printf ${format_l/(\\t)/} 'whatwhen grml' '# Range is set to -100 by default.'
4137 printf $format_l 'whatwhen zsh -250'
4138 printf $format_l 'whatwhen foo 1 99'
4141 printf '%s\n%s\n\n' ${usage} ${help} && return 1
4144 # -l list results on stout rather than invoking $EDITOR.
4145 # -i Print dates as in YYYY-MM-DD.
4146 # -m Search for a - quoted - pattern within the history.
4147 fc -li -m "*${first_char}${remain}*" $first $last
4153 # change fluxbox keys from 'Alt-#' to 'Alt-F#' and vice versa
4156 [[ -n "$FLUXKEYS" ]] || local FLUXKEYS="$HOME/.fluxbox/keys"
4157 if ! [[ -r "$FLUXKEYS" ]] ; then
4158 echo "Sorry, \$FLUXKEYS file $FLUXKEYS could not be read - nothing to be done."
4161 if grep -q 'Mod1 F[0-9] :Workspace [0-9]' $FLUXKEYS ; then
4162 echo -n 'Switching to Alt-# mode in ~/.fluxbox/keys: '
4163 sed -i -e 's|^\(Mod[0-9]\+[: space :]\+\)F\([0-9]\+[: space :]\+:Workspace.*\)|\1\2|' $FLUXKEYS && echo done || echo failed
4164 elif grep -q 'Mod1 [0-9] :Workspace [0-9]' $FLUXKEYS ; then
4165 echo -n 'Switching to Alt-F# mode in ~/.fluxbox/keys: '
4166 sed -i -e 's|^\(Mod[0-9]\+[: space :]\+\)\([0-9]\+[: space :]\+:Workspace.*\)|\1F\2|' $FLUXKEYS && echo done || echo failed
4168 echo 'Sorry, do not know what to do.'
4174 # retrieve weather information on the console
4175 # Usage example: 'weather LOWG'
4179 print 'Usage: weather <station_id>' >&2
4180 print 'List of stations: http://en.wikipedia.org/wiki/List_of_airports_by_ICAO_code'>&2
4184 local PLACE="${1:u}"
4185 local FILE="$HOME/.weather/$PLACE"
4186 local LOG="$HOME/.weather/log"
4188 [[ -d $HOME/.weather ]] || {
4189 print -n "Creating $HOME/.weather: "
4190 mkdir $HOME/.weather
4194 print "Retrieving information for ${PLACE}:"
4196 wget -T 10 --no-verbose --output-file=$LOG --output-document=$FILE --timestamping http://weather.noaa.gov/pub/data/observations/metar/decoded/$PLACE.TXT
4198 if [[ $? -eq 0 ]] ; then
4199 if [[ -n "$VERBOSE" ]] ; then
4202 DATE=$(grep 'UTC' $FILE | sed 's#.* /##')
4203 TEMPERATURE=$(awk '/Temperature/ { print $4" degree Celcius / " $2" degree Fahrenheit" }' $FILE| tr -d '(')
4205 echo "temp: $TEMPERATURE"
4208 print "There was an error retrieving the weather information for $PLACE" >&2
4215 # mercurial related stuff {{{
4216 if check_com -c hg ; then
4217 # gnu like diff for mercurial
4218 # http://www.selenic.com/mercurial/wiki/index.cgi/TipsAndTricks
4219 #f5# GNU like diff for mercurial
4222 for i in $(hg status -marn "$@") ; diff -ubwd <(hg cat "$i") "$i"
4225 # build debian package
4226 #a2# Alias for \kbd{hg-buildpackage}
4227 alias hbp='hg-buildpackage'
4229 # execute commands on the versioned patch-queue from the current repos
4230 alias mq='hg -R $(readlink -f $(hg root)/.hg/patches)'
4232 # diffstat for specific version of a mercurial repository
4233 # hgstat => display diffstat between last revision and tip
4234 # hgstat 1234 => display diffstat between revision 1234 and tip
4235 #f5# Diffstat for specific version of a mercurial repos
4238 [[ -n "$1" ]] && hg diff -r $1 -r tip | diffstat || hg export tip | diffstat
4241 #f5# Get current mercurial tip via hg itself
4245 if [[ -f mercurial-tree/.hg ]] ; then
4247 echo "Running hg pull for retreiving latest version..."
4249 echo "Finished update. Building mercurial"
4251 echo "Setting \$PATH to $PWD:\$PATH..."
4252 export PATH="$PWD:$PATH"
4254 echo "Downloading mercurial via hg"
4255 hg clone http://selenic.com/repo/hg mercurial-tree
4257 echo "Building mercurial"
4259 echo "Setting \$PATH to $PWD:\$PATH..."
4260 export PATH="$PWD:$PATH"
4261 echo "make sure you set it permanent via ~/.zshrc if you plan to use it permanently."
4262 # echo "Setting \$PYTHONPATH to PYTHONPATH=\${HOME}/lib/python,"
4263 # export PYTHONPATH=${HOME}/lib/python
4267 fi # end of check whether we have the 'hg'-executable
4269 # get current mercurial snapshot
4270 #f5# Get current mercurial snapshot
4274 if [[ -f mercurial-snapshot.tar.gz ]] ; then
4275 echo "mercurial-snapshot.tar.gz exists already, skipping download."
4277 echo "Downloading mercurial snapshot"
4278 wget http://www.selenic.com/mercurial/mercurial-snapshot.tar.gz
4280 echo "Unpacking mercurial-snapshot.tar.gz"
4281 tar zxf mercurial-snapshot.tar.gz
4282 cd mercurial-snapshot/
4283 echo "Installing required build-dependencies"
4284 $SUDO apt-get update
4285 $SUDO apt-get install python2.4-dev
4286 echo "Building mercurial"
4288 echo "Setting \$PATH to $PWD:\$PATH..."
4289 export PATH="$PWD:$PATH"
4290 echo "make sure you set it permanent via ~/.zshrc if you plan to use it permanently."
4294 # some useful commands often hard to remember - let's grep for them {{{
4295 # actually use our zg() function now. :)
4297 # Work around ion/xterm resize bug.
4298 #if [[ "$SHLVL" -eq 1 ]]; then
4299 # if check_com -c resize ; then
4300 # eval `resize </dev/null`
4305 # /usr/bin/jackd -dalsa -dhw:0 -r48000 -p1024 -n2
4306 # now play audio file:
4307 # alsaplayer -o jack foobar.mp3
4309 # send files via netcat
4311 # send() {j=$*; tar cpz ${j/%${!#}/}|nc -w 1 ${!#} 51330;}
4313 # alias receive='nc -vlp 51330 | tar xzvp'
4316 # dh_make -e foo@localhost -f $1
4317 # dpkg-buildpackage -rfakeroot
4319 # dpkg-scanpackages ./ /dev/null | gzip > Packages.gz
4320 # dpkg-scansources . | gzip > Sources.gz
4321 # grep-dctrl --field Maintainer $* /var/lib/apt/lists/*
4324 # convert -geometry 200x200 -interlace LINE -verbose
4325 # ldapsearch -x -b "OU=Bedienstete,O=tug" -h ldap.tugraz.at sn=$1
4326 # ps -ao user,pcpu,start,command
4327 # gpg --keyserver blackhole.pca.dfn.de --recv-keys
4328 # xterm -bg black -fg yellow -fn -misc-fixed-medium-r-normal--14-140-75-75-c-90-iso8859-15 -ah
4329 # nc -vz $1 1-1024 # portscan via netcat
4330 # wget --mirror --no-parent --convert-links
4332 # autoload -U tetris; zle -N tetris; bindkey '...' ; echo "press ... for playing tennis"
4334 # modify console cursor
4335 # see http://www.tldp.org/HOWTO/Framebuffer-HOWTO-5.html
4336 # print $'\e[?96;0;64c'
4339 # grml-small cleanups {{{
4341 # The following is used to remove zsh-config-items that do not work
4342 # in grml-small by default.
4343 # If you do not want these adjustments (for whatever reason), set
4344 # $GRMLSMALL_SPECIFIC to 0 in your .zshrc.pre file (which this configuration
4345 # sources if it is there).
4347 if (( GRMLSMALL_SPECIFIC > 0 )) && isgrmlsmall ; then
4350 unalias 'V' &> /dev/null
4351 unfunction vman &> /dev/null
4352 unfunction vimpm &> /dev/null
4353 unfunction vimhelp &> /dev/null
4354 unfunction viless &> /dev/null
4355 unfunction 2html &> /dev/null
4357 # manpages are not in grmlsmall
4358 unfunction manzsh &> /dev/null
4359 unalias man2 &> /dev/null
4360 unalias man &> /dev/null
4361 unfunction man2 &> /dev/null
4369 ## genrefcard.pl settings {{{
4371 ### doc strings for external functions from files
4372 #m# f5 grml-wallpaper() Sets a wallpaper (try completion for possible values)
4374 ### example: split functions-search 8,16,24,32
4375 #@# split functions-search 8
4379 ## END OF FILE #################################################################
4380 # vim:filetype=zsh foldmethod=marker autoindent expandtab shiftwidth=4