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{mkdir}
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
2332 cdrecord is not provided under its original name by Debian anymore.
2333 See #377109 in the BTS of Debian for more details.
2335 Please use the wodim binary instead
2342 # get_tw_cli has been renamed into get_3ware
2343 if check_com -c get_3ware ; then
2345 echo 'Warning: get_tw_cli has been renamed into get_3ware. Invoking get_3ware for you.'>&2
2350 # I hate lacking backward compatibility, so provide an alternative therefore
2351 if ! check_com -c apache2-ssl-certificate ; then
2353 apache2-ssl-certificate() {
2355 print 'Debian does not ship apache2-ssl-certificate anymore (see #398520). :('
2356 print 'You might want to take a look at Debian the package ssl-cert as well.'
2357 print 'To generate a certificate for use with apache2 follow the instructions:'
2361 export RANDFILE=/dev/random
2362 mkdir /etc/apache2/ssl/
2363 openssl req $@ -new -x509 -days 365 -nodes -out /etc/apache2/ssl/apache.pem -keyout /etc/apache2/ssl/apache.pem
2364 chmod 600 /etc/apache2/ssl/apache.pem
2366 Run "grml-tips ssl-certificate" if you need further instructions.
2372 # {{{ Use hard limits, except for a smaller stack and no core dumps
2374 is425 && limit stack 8192
2375 isgrmlcd && limit core 0 # important for a live-cd-system
2379 # {{{ completion system
2381 # called later (via is4 && grmlcomp)
2382 # note: use 'zstyle' for getting current settings
2383 # press ^Xh (control-x h) for getting tags in context; ^X? (control-x ?) to run complete_debug with trace output
2385 # TODO: This could use some additional information
2387 # allow one error for every three characters typed in approximate completer
2388 zstyle ':completion:*:approximate:' max-errors 'reply=( $((($#PREFIX+$#SUFFIX)/3 )) numeric )'
2390 # don't complete backup files as executables
2391 zstyle ':completion:*:complete:-command-::commands' ignored-patterns '(aptitude-*|*\~)'
2393 # start menu completion only if it could find no unambiguous initial string
2394 zstyle ':completion:*:correct:*' insert-unambiguous true
2395 zstyle ':completion:*:corrections' format $'%{\e[0;31m%}%d (errors: %e)%{\e[0m%}'
2396 zstyle ':completion:*:correct:*' original true
2398 # activate color-completion
2399 zstyle ':completion:*:default' list-colors ${(s.:.)LS_COLORS}
2401 # format on completion
2402 zstyle ':completion:*:descriptions' format $'%{\e[0;31m%}completing %B%d%b%{\e[0m%}'
2404 # complete 'cd -<tab>' with menu
2405 zstyle ':completion:*:*:cd:*:directory-stack' menu yes select
2407 # insert all expansions for expand completer
2408 zstyle ':completion:*:expand:*' tag-order all-expansions
2409 zstyle ':completion:*:history-words' list false
2412 zstyle ':completion:*:history-words' menu yes
2414 # ignore duplicate entries
2415 zstyle ':completion:*:history-words' remove-all-dups yes
2416 zstyle ':completion:*:history-words' stop yes
2418 # match uppercase from lowercase
2419 zstyle ':completion:*' matcher-list 'm:{a-z}={A-Z}'
2421 # separate matches into groups
2422 zstyle ':completion:*:matches' group 'yes'
2423 zstyle ':completion:*' group-name ''
2425 if [[ "$NOMENU" -eq 0 ]] ; then
2426 # if there are more than 5 options allow selecting from a menu
2427 zstyle ':completion:*' menu select=5
2429 # don't use any menus at all
2433 zstyle ':completion:*:messages' format '%d'
2434 zstyle ':completion:*:options' auto-description '%d'
2436 # describe options in full
2437 zstyle ':completion:*:options' description 'yes'
2439 # on processes completion complete all user processes
2440 zstyle ':completion:*:processes' command 'ps -au$USER'
2442 # offer indexes before parameters in subscripts
2443 zstyle ':completion:*:*:-subscript-:*' tag-order indexes parameters
2445 # provide verbose completion information
2446 zstyle ':completion:*' verbose true
2448 # recent (as of Dec 2007) zsh versions are able to provide descriptions
2449 # for commands (read: 1st word in the line) that it will list for the user
2450 # to choose from. The following disables that, because it's not exactly fast.
2451 zstyle ':completion:*:-command-:*:' verbose false
2453 # set format for warnings
2454 zstyle ':completion:*:warnings' format $'%{\e[0;31m%}No matches for:%{\e[0m%} %d'
2456 # define files to ignore for zcompile
2457 zstyle ':completion:*:*:zcompile:*' ignored-patterns '(*~|*.zwc)'
2458 zstyle ':completion:correct:' prompt 'correct to: %e'
2460 # Ignore completion functions for commands you don't have:
2461 zstyle ':completion::(^approximate*):*:functions' ignored-patterns '_*'
2463 # Provide more processes in completion of programs like killall:
2464 zstyle ':completion:*:processes-names' command 'ps c -u ${USER} -o command | uniq'
2466 # complete manual by their section
2467 zstyle ':completion:*:manuals' separate-sections true
2468 zstyle ':completion:*:manuals.*' insert-sections true
2469 zstyle ':completion:*:man:*' menu yes select
2471 # provide .. as a completion
2472 zstyle ':completion:*' special-dirs ..
2474 # run rehash on completion so new installed program are found automatically:
2476 (( CURRENT == 1 )) && rehash
2481 # some people don't like the automatic correction - so run 'NOCOR=1 zsh' to deactivate it
2482 if [[ "$NOCOR" -gt 0 ]] ; then
2483 zstyle ':completion:*' completer _oldlist _expand _force_rehash _complete _files _ignored
2486 # try to be smart about when to use what completer...
2488 zstyle -e ':completion:*' completer '
2489 if [[ $_last_try != "$HISTNO$BUFFER$CURSOR" ]] ; then
2490 _last_try="$HISTNO$BUFFER$CURSOR"
2491 reply=(_complete _match _ignored _prefix _files)
2493 if [[ $words[1] == (rm|mv) ]] ; then
2494 reply=(_complete _files)
2496 reply=(_oldlist _expand _force_rehash _complete _ignored _correct _approximate _files)
2501 # command for process lists, the local web server details and host completion
2502 zstyle ':completion:*:urls' local 'www' '/var/www/' 'public_html'
2505 [[ -d $ZSHDIR/cache ]] && zstyle ':completion:*' use-cache yes && \
2506 zstyle ':completion::complete:*' cache-path $ZSHDIR/cache/
2508 # host completion /* add brackets as vim can't parse zsh's complex cmdlines 8-) {{{ */
2510 [[ -r ~/.ssh/known_hosts ]] && _ssh_hosts=(${${${${(f)"$(<$HOME/.ssh/known_hosts)"}:#[\|]*}%%\ *}%%,*}) || _ssh_hosts=()
2511 [[ -r /etc/hosts ]] && : ${(A)_etc_hosts:=${(s: :)${(ps:\t:)${${(f)~~"$(</etc/hosts)"}%%\#*}##[:blank:]#[^[:blank:]]#}}} || _etc_hosts=()
2523 zstyle ':completion:*:hosts' hosts $hosts
2524 # TODO: so, why is this here?
2525 # zstyle '*' hosts $hosts
2527 # use generic completion system for programs not yet defined; (_gnu_generic works
2528 # with commands that provide a --help option with "standard" gnu-like output.)
2529 for compcom in cp deborphan df feh fetchipac head hnb ipacsum mv \
2530 pal stow tail uname ; do
2531 [[ -z ${_comps[$compcom]} ]] && compdef _gnu_generic ${compcom}
2534 # see upgrade function in this file
2535 compdef _hosts upgrade
2541 # people should use 'grml-x'!
2543 if [[ -e /etc/X11/xorg.conf ]] ; then
2544 [[ -x /usr/bin/startx ]] && /usr/bin/startx "$@" || /usr/X11R6/bin/startx "$@"
2546 echo "Please use the script \"grml-x\" for starting the X Window System
2547 because there does not exist /etc/X11/xorg.conf yet.
2548 If you want to use startx anyway please call \"/usr/bin/startx\"."
2554 if [[ -e /etc/X11/xorg.conf ]] ; then
2555 [[ -x /usr/bin/xinit ]] && /usr/bin/xinit || /usr/X11R6/bin/xinit
2557 echo "Please use the script \"grml-x\" for starting the X Window System.
2558 because there does not exist /etc/X11/xorg.conf yet.
2559 If you want to use xinit anyway please call \"/usr/bin/xinit\"."
2564 if check_com -c 915resolution; then
2566 echo "Please use 915resolution as resolution modifying tool for Intel \
2572 #a1# Output version of running grml
2573 alias grml-version='cat /etc/grml_version'
2575 if check_com -c rebuildfstab ; then
2576 #a1# Rebuild /etc/fstab
2577 alias grml-rebuildfstab='rebuildfstab -v -r -config'
2580 if check_com -c grml-debootstrap ; then
2582 echo "Installing debian to harddisk is possible by using grml-debootstrap."
2589 # {{{ now run the functions
2591 is4 && isgrml && grmlstuff
2596 is4 && xsource "/etc/zsh/keephack"
2599 # {{{ wonderful idea of using "e" glob qualifier by Peter Stephenson
2600 # You use it as follows:
2601 # $ NTREF=/reference/file
2603 # This lists all the files in the current directory newer than the reference file.
2604 # You can also specify the reference file inline; note quotes:
2605 # $ ls -l *(e:'nt ~/.zshenv':)
2607 if [[ -n $1 ]] ; then
2610 [[ $REPLY -nt $NTREF ]]
2614 # shell functions {{{
2616 #f1# Provide csh compatibility
2617 setenv() { typeset -x "${1}${1:+=}${(@)argv[2,$#]}" } # csh compatibility
2619 #f1# Reload an autoloadable function
2620 freload() { while (( $# )); do; unfunction $1; autoload -U $1; shift; done }
2621 compdef _functions freload
2623 #f1# List symlinks in detail (more detailed version of 'readlink -f' and 'whence -s')
2625 [[ -z "$1" ]] && printf 'Usage: %s <file(s)>\n' "$0" && return 1
2626 for file in "$@" ; do
2627 while [[ -h "$file" ]] ; do
2629 file=$(readlink "$file")
2634 # fast manual access
2635 if check_com qma ; then
2636 #f1# View the zsh manual
2637 manzsh() { qma zshall "$1" }
2640 manzsh() { /usr/bin/man zshall | vim -c "se ft=man| se hlsearch" +/"$1" - ; }
2643 # TODO: Is it supported to use pager settings like this?
2644 # PAGER='less -Mr' - If so, the use of $PAGER here needs fixing
2645 # with respect to wordsplitting. (ie. ${=PAGER})
2646 if check_com -c $PAGER ; then
2647 #f1# View Debian's changelog of a given package
2650 if [[ -r /usr/share/doc/$1/changelog.Debian.gz ]] ; then
2651 $PAGER /usr/share/doc/$1/changelog.Debian.gz
2652 elif [[ -r /usr/share/doc/$1/changelog.gz ]] ; then
2653 $PAGER /usr/share/doc/$1/changelog.gz
2655 if check_com -c aptitude ; then
2656 echo "No changelog for package $1 found, using aptitude to retrieve it."
2658 aptitude -t unstable changelog $1
2660 aptitude changelog $1
2663 echo "No changelog for package $1 found, sorry."
2668 _dchange() { _files -W /usr/share/doc -/ }
2669 compdef _dchange dchange
2671 #f1# View Debian's NEWS of a given package
2674 if [[ -r /usr/share/doc/$1/NEWS.Debian.gz ]] ; then
2675 $PAGER /usr/share/doc/$1/NEWS.Debian.gz
2677 if [[ -r /usr/share/doc/$1/NEWS.gz ]] ; then
2678 $PAGER /usr/share/doc/$1/NEWS.gz
2680 echo "No NEWS file for package $1 found, sorry."
2685 _dnews() { _files -W /usr/share/doc -/ }
2686 compdef _dnews dnews
2688 #f1# View upstream's changelog of a given package
2691 if [[ -r /usr/share/doc/$1/changelog.gz ]] ; then
2692 $PAGER /usr/share/doc/$1/changelog.gz
2694 echo "No changelog for package $1 found, sorry."
2698 _uchange() { _files -W /usr/share/doc -/ }
2699 compdef _uchange uchange
2704 ZSH_PROFILE_RC=1 $SHELL "$@"
2707 #f1# Edit an alias via zle
2709 [[ -z "$1" ]] && { echo "Usage: edalias <alias_to_edit>" ; return 1 } || vared aliases'[$1]' ;
2711 compdef _aliases edalias
2713 #f1# Edit a function via zle
2715 [[ -z "$1" ]] && { echo "Usage: edfun <function_to_edit>" ; return 1 } || zed -f "$1" ;
2717 compdef _functions edfunc
2719 # use it e.g. via 'Restart apache2'
2720 #m# f6 Start() \kbd{/etc/init.d/\em{process}}\quad\kbd{start}
2721 #m# f6 Restart() \kbd{/etc/init.d/\em{process}}\quad\kbd{restart}
2722 #m# f6 Stop() \kbd{/etc/init.d/\em{process}}\quad\kbd{stop}
2723 #m# f6 Reload() \kbd{/etc/init.d/\em{process}}\quad\kbd{reload}
2724 #m# f6 Force-Reload() \kbd{/etc/init.d/\em{process}}\quad\kbd{force-reload}
2725 if [[ -d /etc/init.d || -d /etc/service ]] ; then
2727 local action_="${1:l}" # e.g Start/Stop/Restart
2731 local service_target_="$(readlink /etc/init.d/$service_)"
2732 if [[ $service_target_ == "/usr/bin/sv" ]]; then
2734 case "${action_}" in
2735 start) if [[ ! -e /etc/service/$service_ ]]; then
2736 $SUDO ln -s "/etc/sv/$service_" "/etc/service/"
2738 $SUDO "/etc/init.d/$service_" "${action_}" "$param_"
2740 # there is no reload in runits sysv emulation
2741 reload) $SUDO "/etc/init.d/$service_" "force-reload" "$param_" ;;
2742 *) $SUDO "/etc/init.d/$service_" "${action_}" "$param_" ;;
2746 $SUDO "/etc/init.d/$service_" "${action_}" "$param_"
2750 for i in Start Restart Stop Force-Reload Reload ; do
2751 eval "$i() { __start_stop $i \"\$1\" \"\$2\" ; }"
2755 #f1# Provides useful information on globbing
2762 p named pipes (FIFOs)
2763 * executable plain files (0100)
2764 % device files (character or block special)
2765 %b block special files
2766 %c character special files
2767 r owner-readable files (0400)
2768 w owner-writable files (0200)
2769 x owner-executable files (0100)
2770 A group-readable files (0040)
2771 I group-writable files (0020)
2772 E group-executable files (0010)
2773 R world-readable files (0004)
2774 W world-writable files (0002)
2775 X world-executable files (0001)
2776 s setuid files (04000)
2777 S setgid files (02000)
2778 t files with the sticky bit (01000)
2780 print *(m-1) # Files modified up to a day ago
2781 print *(a1) # Files accessed a day ago
2782 print *(@) # Just symlinks
2783 print *(Lk+50) # Files bigger than 50 kilobytes
2784 print *(Lk-50) # Files smaller than 50 kilobytes
2785 print **/*.c # All *.c files recursively starting in \$PWD
2786 print **/*.c~file.c # Same as above, but excluding 'file.c'
2787 print (foo|bar).* # Files starting with 'foo' or 'bar'
2788 print *~*.* # All Files that do not contain a dot
2789 chmod 644 *(.^x) # make all plain non-executable files publically readable
2790 print -l *(.c|.h) # Lists *.c and *.h
2791 print **/*(g:users:) # Recursively match all files that are owned by group 'users'
2792 echo /proc/*/cwd(:h:t:s/self//) # Analogous to >ps ax | awk '{print $1}'<"
2794 alias help-zshglob=H-Glob
2796 check_com -c qma && alias ?='qma zshall'
2798 # grep for running process, like: 'any vim'
2801 if [[ -z "$1" ]] ; then
2802 echo "any - grep for process(es) by keyword" >&2
2803 echo "Usage: any <keyword>" >&2 ; return 1
2806 local LENGTH=$(expr length $STRING)
2807 local FIRSCHAR=$(echo $(expr substr $STRING 1 1))
2808 local REST=$(echo $(expr substr $STRING 2 $LENGTH))
2809 ps xauwww| grep "[$FIRSCHAR]$REST"
2813 # After resuming from suspend, system is paging heavily, leading to very bad interactivity.
2814 # taken from $LINUX-KERNELSOURCE/Documentation/power/swsusp.txt
2815 [[ -r /proc/1/maps ]] && \
2817 print 'Reading /proc/[0-9]*/maps and sending output to /dev/null, this might take a while.'
2818 cat $(sed -ne 's:.* /:/:p' /proc/[0-9]*/maps | sort -u | grep -v '^/dev/') > /dev/null
2819 print 'Finished, running "swapoff -a; swapon -a" may also be useful.'
2822 # print hex value of a number
2825 [[ -n "$1" ]] && printf "%x\n" $1 || { print 'Usage: hex <number-to-convert>' ; return 1 }
2828 # calculate (or eval at all ;-)) with perl => p[erl-]eval
2829 # hint: also take a look at zcalc -> 'autoload zcalc' -> 'man zshmodules | less -p MATHFUNC'
2831 [[ -n "$1" ]] && CALC="$*" || print "Usage: calc [expression]"
2832 perl -e "print eval($CALC),\"\n\";"
2834 functions peval &>/dev/null && alias calc=peval
2836 # brltty seems to have problems with utf8 environment and/or font Uni3-Terminus16 under
2837 # certain circumstances, so work around it, no matter which environment we have
2839 if [[ -z "$DISPLAY" ]] ; then
2840 consolechars -f /usr/share/consolefonts/default8x16.psf.gz
2847 # just press 'asdf' keys to toggle between dvorak and us keyboard layout
2849 echo -n 'Switching to us keyboard layout: '
2850 [[ -z "$DISPLAY" ]] && $SUDO loadkeys us &>/dev/null || setxkbmap us &>/dev/null
2854 echo -n 'Switching to dvorak keyboard layout: '
2855 [[ -z "$DISPLAY" ]] && $SUDO loadkeys dvorak &>/dev/null || setxkbmap dvorak &>/dev/null
2858 # just press 'asdf' key to toggle from neon layout to us keyboard layout
2860 echo -n 'Switching to us keyboard layout: '
2861 setxkbmap us && echo 'Done' || echo 'Failed'
2864 # set up an ipv6 tunnel
2869 if ifconfig sit1 2>/dev/null | grep -q 'inet6 addr: 2002:.*:1::1' ; then
2870 print 'ipv6 tunnel already set up, nothing to be done.'
2871 print 'execute: "ifconfig sit1 down ; ifconfig sit0 down" to remove ipv6-tunnel.' ; return 1
2873 [[ -n "$PUBLIC_IP" ]] || \
2874 local PUBLIC_IP=$(ifconfig $(route -n | awk '/^0\.0\.0\.0/{print $8; exit}') | \
2875 awk '/inet addr:/ {print $2}' | tr -d 'addr:')
2877 [[ -n "$PUBLIC_IP" ]] || { print 'No $PUBLIC_IP set and could not determine default one.' ; return 1 }
2878 local IPV6ADDR=$(printf "2002:%02x%02x:%02x%02x:1::1" $(print ${PUBLIC_IP//./ }))
2879 print -n "Setting up ipv6 tunnel $IPV6ADDR via ${PUBLIC_IP}: "
2880 ifconfig sit0 tunnel ::192.88.99.1 up
2881 ifconfig sit1 add "$IPV6ADDR" && print done || print failed
2885 if ifconfig sit1 2>/dev/null | grep -q 'inet6 addr: 2002:.*:1::1' ; then
2886 print 'ipv6 tunnel available' ; return 0
2888 print 'ipv6 tunnel not available' ; return 1
2892 if ifconfig sit1 2>/dev/null | grep -q 'inet6 addr: 2002:.*:1::1' ; then
2893 print -n 'Stopping ipv6 tunnel (sit0 + sit1): '
2894 ifconfig sit1 down ; ifconfig sit0 down && print done || print failed
2896 print 'No ipv6 tunnel found, nothing to be done.' ; return 1
2900 print "Usage: ipv6-tunnel [start|stop|status]">&2 ; return 1
2905 # run dhclient for wireless device
2907 salias dhclient "$(wavemon -d | awk '/device/{print $2}')"
2910 # spawn a minimally set up ksh - useful if you want to umount /usr/.
2912 exec env -i ENV="/etc/minimal-shellrc" HOME="$HOME" TERM="$TERM" ksh
2915 # a wrapper for vim, that deals with title setting
2917 # set this array to a set of options to vim you always want
2918 # to have set when calling vim (in .zshrc.local), like:
2919 # VIM_OPTIONS=( -p )
2920 # This will cause vim to send every file given on the
2921 # commandline to be send to it's own tab (needs vim7).
2923 VIM_PLEASE_SET_TITLE='yes' command vim ${VIM_OPTIONS} "$@"
2926 # make a backup of a file
2928 cp -a "$1" "${1}_$(date --iso-8601=seconds)"
2931 #f1# grep for patterns in grml's zsh setup
2937 print "usage: zg -[anr] <pattern>\n";
2938 print " Search for patterns in grml'\''s zshrc.\n";
2939 print " zg takes no or exactly one option plus a non empty pattern.\n\n";
2940 print " options:\n";
2941 print " -- no options (use if your pattern starts in with a dash.\n";
2942 print " -a search for the pattern in all code regions\n";
2943 print " -n search for the pattern in non-root code only\n";
2944 print " -r search in code for everyone (also root) only\n\n";
2945 print " The default is -a for non-root users and -r for root.\n\n";
2946 print " If you installed the zshrc to a non-default locations (ie *NOT*\n";
2947 print " in /etc/zsh/zshrc) do: export GRML_ZSHRC=\$HOME/.zshrc\n";
2948 print " ...in case you copied the file to that location.\n\n";
2952 if ($ENV{GRML_ZSHRC} ne "") {
2953 $RC = $ENV{GRML_ZSHRC};
2955 $RC = "/etc/zsh/zshrc";
2958 usage if ($#ARGV < 0 || $#ARGV > 1);
2959 if ($> == 0) { $mode = "allonly"; }
2960 else { $mode = "all"; }
2963 if ($opt eq "--") { shift; }
2964 elsif ($opt eq "-a") { $mode = "all"; shift; }
2965 elsif ($opt eq "-n") { $mode = "nonroot"; shift; }
2966 elsif ($opt eq "-r" ) { $mode = "allonly"; shift; }
2967 elsif ($opt =~ m/^-/ || $#ARGV > 0) { usage(); }
2969 $pattern = $ARGV[0];
2970 usage() if ($pattern eq "");
2972 open FH, "<$RC" or die "zg: Could not open $RC: $!\n";
2973 while ($line = <FH>) {
2975 if ($line =~ m/^#:grep:marker:for:mika:/) { $markerfound = 1; next; }
2976 next if ($mode eq "nonroot" && markerfound == 0);
2977 break if ($mode eq "allonly" && markerfound == 1);
2978 print $line, "\n" if ($line =~ /$pattern/);
2990 # {{{ make sure our environment is clean regarding colors
2991 for color in BLUE RED GREEN CYAN YELLOW MAGENTA WHITE ; unset $color
2994 # "persistent history" {{{
2995 # just write important commands you always need to ~/.important_commands
2996 if [[ -r ~/.important_commands ]] ; then
2997 fc -R ~/.important_commands
3001 #:grep:marker:for:mika: :-)
3002 ### non-root (EUID != 0) code below
3005 if (( GRML_ALWAYS_LOAD_ALL == 0 )) && (( $EUID == 0 )) ; then
3013 # set terminal property (used e.g. by msgid-chooser)
3014 export COLORTERM="yes"
3016 # set default browser
3017 if [[ -z "$BROWSER" ]] ; then
3018 if [[ -n "$DISPLAY" ]] ; then
3019 #v# If X11 is running
3020 check_com -c firefox && export BROWSER=firefox
3022 #v# If no X11 is running
3023 check_com -c w3m && export BROWSER=w3m
3027 #m# v QTDIR \kbd{/usr/share/qt[34]}\quad [for non-root only]
3028 [[ -d /usr/share/qt3 ]] && export QTDIR=/usr/share/qt3
3029 [[ -d /usr/share/qt4 ]] && export QTDIR=/usr/share/qt4
3031 # support running 'jikes *.java && jamvm HelloWorld' OOTB:
3032 #v# [for non-root only]
3033 [[ -f /usr/share/classpath/glibj.zip ]] && export JIKESPATH=/usr/share/classpath/glibj.zip
3038 # Xterm resizing-fu.
3039 # Based on http://svn.kitenet.net/trunk/home-full/.zshrc?rev=11710&view=log (by Joey Hess)
3040 alias hide='echo -en "\033]50;nil2\007"'
3041 alias tiny='echo -en "\033]50;-misc-fixed-medium-r-normal-*-*-80-*-*-c-*-iso8859-15\007"'
3042 alias small='echo -en "\033]50;6x10\007"'
3043 alias medium='echo -en "\033]50;-misc-fixed-medium-r-normal--13-120-75-75-c-80-iso8859-15\007"'
3044 alias default='echo -e "\033]50;-misc-fixed-medium-r-normal-*-*-140-*-*-c-*-iso8859-15\007"'
3045 alias large='echo -en "\033]50;-misc-fixed-medium-r-normal-*-*-150-*-*-c-*-iso8859-15\007"'
3046 alias huge='echo -en "\033]50;-misc-fixed-medium-r-normal-*-*-210-*-*-c-*-iso8859-15\007"'
3047 alias smartfont='echo -en "\033]50;-artwiz-smoothansi-*-*-*-*-*-*-*-*-*-*-*-*\007"'
3048 alias semifont='echo -en "\033]50;-misc-fixed-medium-r-semicondensed-*-*-120-*-*-*-*-iso8859-15\007"'
3051 #a2# Execute \kbd{du -sch}
3053 #a2# Execute \kbd{jobs -l}
3057 #a2# Execute \kbd{./configure}
3058 alias CO="./configure"
3059 #a2# Execute \kbd{./configure --help}
3060 alias CH="./configure --help"
3063 #a2# Execute \kbd{ls -lSrah}
3064 alias dir="ls -lSrah"
3065 #a2# Only show dot-directories
3066 alias lad='ls -d .*(/)' # only show dot-directories
3067 #a2# Only show dot-files
3068 alias lsa='ls -a .*(.)' # only show dot-files
3069 #a2# Only files with setgid/setuid/sticky flag
3070 alias lss='ls -l *(s,S,t)' # only files with setgid/setuid/sticky flag
3071 #a2# Only show 1st ten symlinks
3072 alias lsl='ls -l *(@)' # only symlinks
3073 #a2# Display only executables
3074 alias lsx='ls -l *(*)' # only executables
3075 #a2# Display world-{readable,writable,executable} files
3076 alias lsw='ls -ld *(R,W,X.^ND/)' # world-{readable,writable,executable} files
3077 #a2# Display the ten biggest files
3078 alias lsbig="ls -flh *(.OL[1,10])" # display the biggest files
3079 #a2# Only show directories
3080 alias lsd='ls -d *(/)' # only show directories
3081 #a2# Only show empty directories
3082 alias lse='ls -d *(/^F)' # only show empty directories
3083 #a2# Display the ten newest files
3084 alias lsnew="ls -rl *(D.om[1,10])" # display the newest files
3085 #a2# Display the ten oldest files
3086 alias lsold="ls -rtlh *(D.om[1,10])" # display the oldest files
3087 #a2# Display the ten smallest files
3088 alias lssmall="ls -Srl *(.oL[1,10])" # display the smallest files
3091 #a2# Execute \kbd{chmod 600}
3092 alias rw-='chmod 600'
3093 #a2# Execute \kbd{chmod 700}
3094 alias rwx='chmod 700'
3095 #m# a2 r-{}- Execute \kbd{chmod 644}
3096 alias r--='chmod 644'
3097 #a2# Execute \kbd{chmod 755}
3098 alias r-x='chmod 755'
3100 # some useful aliases
3101 #a2# Execute \kbd{mkdir -o}
3105 #a2# Execute \kbd{mplayer -vo fbdev}
3106 alias cmplayer='mplayer -vo fbdev'
3107 #a2# Execute \kbd{mplayer -vo fbdev -fs -zoom}
3108 alias fbmplayer='mplayer -vo fbdev -fs -zoom'
3109 #a2# Execute \kbd{links2 -driver fb}
3110 alias fblinks='links2 -driver fb'
3112 #a2# ssh with StrictHostKeyChecking=no \\&\quad and UserKnownHostsFile unset
3113 alias insecssh='ssh -o "StrictHostKeyChecking=no" -o "UserKnownHostsFile=/dev/null"'
3114 alias insecscp='scp -o "StrictHostKeyChecking=no" -o "UserKnownHostsFile=/dev/null"'
3117 check_com -c python && alias http="python -m SimpleHTTPServer"
3119 # Use 'g' instead of 'git':
3120 check_com g || alias g='git'
3122 # work around non utf8 capable software in utf environment via $LANG and luit
3123 if check_com isutfenv && check_com luit ; then
3124 if check_com -c mrxvt ; then
3125 isutfenv && [[ -n "$LANG" ]] && \
3126 alias mrxvt="LANG=${LANG/(#b)(*)[.@]*/$match[1].iso885915} luit mrxvt"
3129 if check_com -c aterm ; then
3130 isutfenv && [[ -n "$LANG" ]] && \
3131 alias aterm="LANG=${LANG/(#b)(*)[.@]*/$match[1].iso885915} luit aterm"
3134 if check_com -c centericq ; then
3135 isutfenv && [[ -n "$LANG" ]] && \
3136 alias centericq="LANG=${LANG/(#b)(*)[.@]*/$match[1].iso885915} luit centericq"
3141 # useful functions {{{
3144 #f4# Search for newspostings from authors
3145 agoogle() { ${=BROWSER} "http://groups.google.com/groups?as_uauthors=$*" ; }
3146 #f4# Search Debian Bug Tracking System
3150 if [[ $# -eq 1 ]]; then
3153 ${=BROWSER} "http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=$1"
3156 ${=BROWSER} "http://bugs.debian.org/cgi-bin/pkgreport.cgi?submitter=$1"
3159 ${=BROWSER} "http://bugs.debian.org/$*"
3163 print "$0 needs one argument"
3167 #f4# Search Debian Bug Tracking System in mbox format
3175 ${=BROWSER} http://search.dmoz.org/cgi-bin/search\?search=${1// /_}
3177 #f4# Search German Wiktionary
3180 ${=BROWSER} http://de.wiktionary.org/wiki/${(C)1// /_}
3182 #f4# Search English Wiktionary
3185 ${=BROWSER} http://en.wiktionary.org/wiki/${(C)1// /_}
3187 #f4# Search Google Groups
3190 ${=BROWSER} "http://groups.google.com/groups?q=$*"
3195 ${=BROWSER} "http://www.google.com/search?&num=100&q=$*"
3197 #f4# Search Google Groups for MsgID
3200 ${=BROWSER} "http://groups.google.com/groups?selm=$*"
3202 #f4# Search Netcraft
3205 ${=BROWSER} "http://toolbar.netcraft.com/site_report?url=$1"
3207 #f4# Use German Wikipedia's full text search
3210 ${=BROWSER} http://de.wikipedia.org/wiki/Spezial:Search/${(C)1}
3212 #f4# search \kbd{dict.leo.org}
3215 ${=BROWSER} "http://dict.leo.org/?search=$*"
3217 #f4# Search German Wikipedia
3220 ${=BROWSER} http://de.wikipedia.org/wiki/"${(C)*}"
3222 #f4# Search English Wikipedia
3225 ${=BROWSER} http://en.wikipedia.org/wiki/"${(C)*}"
3227 #f4# Search official debs
3230 ${=BROWSER} "http://packages.debian.org/search?keywords=$1&searchon=contents&suite=${2:=unstable}§ion=all"
3233 #m# f4 gex() Exact search via Google
3234 check_com google && gex () {
3235 google "\"[ $1]\" $*"
3239 #f5# Backup \kbd{file {\rm to} file\_timestamp}
3242 cp -b $1 $1_`date --iso-8601=m`
3247 diff -crd "$*" | egrep -v "^Only in |^Binary files "
3249 #f5# cd to directoy and list files
3257 cvs add $* && cvs com -m 'initial checkin' $*
3262 cvs diff -N $* |& $PAGER
3267 cvs log $* |& $PAGER
3284 #f5# Disassemble source files using gcc and as
3287 gcc -pipe -S -o - -O -g $* | as -aldh -o /dev/null
3289 #f5# Firefox remote control - open given URL
3291 if [ -e /etc/debian_version ]; then
3292 firefox -a iceweasel -remote "openURL($1)" || firefox ${1}&
3294 firefox -a firefox -remote "openURL($1)" || firefox ${1}&
3297 #f5# Create Directoy and \kbd{cd} to it
3299 mkdir -p "$@" && cd "$@"
3301 #f5# Unified diff to timestamped outputfile
3303 diff -udrP "$1" "$2" > diff.`date "+%Y-%m-%d"`."$1"
3305 #f5# Memory overview
3307 ps aux | awk '{if (NR > 1) print $5; if (NR > 2) print "+"} END { print "p" }' | dc
3309 #f5# Show contents of gzipped tar file
3312 gunzip -c $1 | tar -tf - -- | $PAGER
3314 #f5# Show contents of zip file
3317 unzip -l $1 | $PAGER
3322 diff -urd $* | egrep -v "^Only in |^Binary files "
3324 #f5# (Mis)use \kbd{vim} as \kbd{less}
3327 vim --cmd 'let no_plugin_maps = 1' -c "so \$VIMRUNTIME/macros/less.vim" "${@:--}"
3330 # Function Usage: uopen $URL/$file
3331 #f5# Download a file and display it locally
3334 if ! [[ -n "$1" ]] ; then
3335 print "Usage: uopen \$URL/\$file">&2
3339 MIME=$(curl --head $FILE | grep Content-Type | cut -d ' ' -f 2 | cut -d\; -f 1)
3341 curl $FILE | see ${MIME}:-
3345 # Function Usage: doc packagename
3346 #f5# \kbd{cd} to /usr/share/doc/\textit{package}
3349 cd /usr/share/doc/$1 && ls
3351 _doc() { _files -W /usr/share/doc -/ }
3352 check_com compdef && compdef _doc doc
3354 #f5# Make screenshot
3356 [[ ! -d ~/shots ]] && mkdir ~/shots
3357 #cd ~/shots ; sleep 5 ; import -window root -depth 8 -quality 80 `date "+%Y-%m-%d--%H:%M:%S"`.png
3358 cd ~/shots ; sleep 5; import -window root shot_`date --iso-8601=m`.jpg
3364 images=( *.{jpg,gif,png}(.N) )
3366 if [[ $#images -eq 0 ]] ; then
3367 print "No image files found"
3373 #f5# Create PDF file from source code
3378 a2ps --medium A4dj -E -o $output $*
3382 # zsh with perl-regex - use it e.g. via:
3383 # regcheck '\s\d\.\d{3}\.\d{3} Euro' ' 1.000.000 Euro'
3384 #f5# Checks whether a regex matches or not.\\&\quad Example: \kbd{regcheck '.\{3\} EUR' '500 EUR'}
3387 zmodload -i zsh/pcre
3388 pcre_compile $1 && \
3389 pcre_match $2 && echo "regex matches" || echo "regex does not match"
3392 #f5# List files which have been modified within the last {\it n} days
3398 #f5# Grep in history
3403 # use colors when GNU grep with color-support
3404 #a2# Execute \kbd{grep -{}-color=auto}
3405 (grep --help 2>/dev/null |grep -- --color) >/dev/null && alias grep='grep --color=auto'
3406 #a2# Execute \kbd{grep -i -{}-color=auto}
3407 alias GREP='grep -i --color=auto'
3409 #f5# Watch manpages in a stretched style
3410 man2() { PAGER='dash -c "sed G | /usr/bin/less"' command man "$@" ; }
3412 # d():Copyright 2005 Nikolai Weibull <nikolai@bitwi.se>
3413 # note: option AUTO_PUSHD has to be set
3414 #f5# Jump between directories
3418 local color=$fg_bold[blue]
3420 dirs -p | while read dir; do
3421 local num="${$(printf "%-4d " $i)/ /.}"
3422 printf " %s $color%s$reset_color\n" $num $dir
3426 read -r 'dir?Jump to directory: ' || return
3427 (( dir == -1 )) && return
3428 if (( dir < 0 || dir >= i )); then
3429 echo d: no such directory stack entry: $dir
3435 # usage example: 'lcheck strcpy'
3436 #f5# Find out which libs define a symbol
3438 if [[ -n "$1" ]] ; then
3439 nm -go /usr/lib/lib*.a 2>/dev/null | grep ":[[:xdigit:]]\{8\} . .*$1"
3441 echo "Usage: lcheck <function>" >&2
3445 #f5# Clean up directory - remove well known tempfiles
3447 FILES=(*~(N) .*~(N) \#*\#(N) *.o(N) a.out(N) *.core(N) *.cmo(N) *.cmi(N) .*.swp(N))
3449 if [[ $NBFILES > 0 ]] ; then
3452 echo -n "Remove these files? [y/n] "
3454 if [[ $ans == "y" ]] ; then
3456 echo ">> $PWD purged, $NBFILES files removed"
3458 echo "Ok. .. then not.."
3464 # 'translate' looks up fot a word in a file with language-to-language
3465 # translations (field separator should be " : "). A typical wordlist looks
3467 # | english-word : german-transmission
3468 # It's also only possible to translate english to german but not reciprocal.
3469 # Use the following oneliner to turn back the sort order:
3470 # $ awk -F ':' '{ print $2" : "$1" "$3 }' \
3471 # /usr/local/lib/words/en-de.ISO-8859-1.vok > ~/.translate/de-en.ISO-8859-1.vok
3472 #f5# Translates a word
3477 translate -l de-en $2
3480 translate -l en-de $2
3483 echo "Usage: $0 { -D | -E }"
3484 echo " -D == German to English"
3485 echo " -E == English to German"
3489 #f5# List all occurrences of programm in current PATH
3492 if [[ $# = 0 ]] ; then
3493 echo "Usage: $0 program"
3494 echo "Example: $0 zsh"
3495 echo "Lists all occurrences of program in the current PATH."
3497 ls -l ${^path}/*$1*(*N)
3501 # Found in the mailinglistarchive from Zsh (IIRC ~1996)
3502 #f5# Select items for specific command(s) from history
3507 echo "Usage: $0 command"
3510 cmd=(${(f)"$(grep -w $1 $HISTFILE | sort | uniq | pr -tn)"})
3511 print -l $cmd | less -F
3512 echo -n "enter number of desired command [1 - $(( ${#cmd[@]} - 1 ))]: "
3515 print -z "${cmd[$answer]#*$TAB}"
3518 # Use vim to convert plaintext to HTML
3519 #f5# Transform files to html with highlighting
3522 vim -u NONE -n -c ':syntax on' -c ':so $VIMRUNTIME/syntax/2html.vim' -c ':wqa' $1 &>/dev/null
3525 # Usage: simple-extract <file>
3526 #f5# Smart archive extractor
3529 if [[ -f $1 ]] ; then
3531 *.tar.bz2) bzip2 -v -d $1 ;;
3532 *.tar.gz) tar -xvzf $1 ;;
3535 *.bz2) bzip2 -d $1 ;;
3537 *.gz) gunzip -d $1 ;;
3538 *.tar) tar -xvf $1 ;;
3539 *.tgz) gunzip -d $1 ;;
3540 *.tbz2) tar -jxvf $1 ;;
3542 *.Z) uncompress $1 ;;
3543 *) echo "'$1' Error. Please go away" ;;
3546 echo "'$1' is not a valid file"
3550 # Usage: smartcompress <file> (<type>)
3551 #f5# Smart archive creator
3554 if [[ -n $2 ]] ; then
3556 tgz | tar.gz) tar -zcvf$1.$2 $1 ;;
3557 tbz2 | tar.bz2) tar -jcvf$1.$2 $1 ;;
3558 tar.Z) tar -Zcvf$1.$2 $1 ;;
3559 tar) tar -cvf$1.$2 $1 ;;
3560 gz | gzip) gzip $1 ;;
3561 bz2 | bzip2) bzip2 $1 ;;
3563 echo "Error: $2 is not a valid compression type"
3567 smartcompress $1 tar.gz
3571 # Usage: show-archive <archive>
3572 #f5# List an archive's content
3575 if [[ -f $1 ]] ; then
3577 *.tar.gz) gunzip -c $1 | tar -tf - -- ;;
3578 *.tar) tar -tf $1 ;;
3579 *.tgz) tar -ztf $1 ;;
3580 *.zip) unzip -l $1 ;;
3582 *.deb) dpkg-deb --fsys-tarfile $1 | tar -tf - -- ;;
3583 *) echo "'$1' Error. Please go away" ;;
3586 echo "'$1' is not a valid archive"
3590 # It's shameless stolen from <http://www.vim.org/tips/tip.php?tip_id=167>
3591 #f5# Use \kbd{vim} as your manpage reader
3594 man $* | col -b | view -c 'set ft=man nomod nolist' -
3597 # function readme() { $PAGER -- (#ia3)readme* }
3598 #f5# View all README-like files in current directory in pager
3602 files=(./(#i)*(read*me|lue*m(in|)ut)*(ND))
3603 if (($#files)) ; then
3606 print 'No README files.'
3610 # function ansi-colors()
3611 #f5# Display ANSI colors
3613 typeset esc="\033[" line1 line2
3614 echo " _ _ _40 _ _ _41_ _ _ _42 _ _ 43_ _ _ 44_ _ _45 _ _ _ 46_ _ _ 47_ _ _ 49_ _"
3615 for fore in 30 31 32 33 34 35 36 37; do
3618 for back in 40 41 42 43 44 45 46 47 49; do
3619 line1="${line1}${esc}${back};${fore}m Normal ${esc}0m"
3620 line2="${line2}${esc}${back};${fore};1m Bold ${esc}0m"
3622 echo -e "$line1\n$line2"
3626 #f5# Find all files in \$PATH with setuid bit set
3627 suidfind() { ls -latg $path | grep '^...s' }
3629 # TODO: So, this is the third incarnation of this function!?
3630 #f5# Reload given functions
3632 for func in $argv ; do
3638 # a small check to see which DIR is located on which server/partition.
3639 # stolen and modified from Sven's zshrc.forall
3640 #f5# Report diskusage of a directory
3643 if [[ -n "$1" ]] ; then
3644 for dir in "$@" ; do
3645 if [[ -d "$dir" ]] ; then
3646 ( cd $dir; echo "-<$dir>"; du -shx .; echo);
3648 echo "warning: $dir does not exist" >&2
3652 for dir in $path; do
3653 if [[ -d "$dir" ]] ; then
3654 ( cd $dir; echo "-<$dir>"; du -shx .; echo);
3656 echo "warning: $dir does not exist" >&2
3662 # % slow_print `cat /etc/passwd`
3663 #f5# Slowly print out parameters
3665 for argument in "$@" ; do
3666 for ((i = 1; i <= ${#1} ;i++)) ; do
3667 print -n "${argument[i]}"
3675 #f5# Show some status info
3678 print "Date..: "$(date "+%Y-%m-%d %H:%M:%S")
3679 print "Shell.: Zsh $ZSH_VERSION (PID = $$, $SHLVL nests)"
3680 print "Term..: $TTY ($TERM), ${BAUD:+$BAUD bauds, }$COLUMNS x $LINES chars"
3681 print "Login.: $LOGNAME (UID = $EUID) on $HOST"
3682 print "System: $(cat /etc/[A-Za-z]*[_-][rv]e[lr]*)"
3683 print "Uptime:$(uptime)"
3688 #f5# Rip an audio CD
3692 cdrdao read-cd --device $DEVICE --driver generic-mmc audiocd.toc
3693 cdrdao read-cddb --device $DEVICE --driver generic-mmc audiocd.toc
3694 echo " * Would you like to burn the cd now? (yes/no)"
3696 if [[ "$input" = "yes" ]] ; then
3697 echo " ! Burning Audio CD"
3701 echo " ! Invalid response."
3706 #f5# Burn an audio CD (in combination with audiorip)
3709 cdrdao write --device $DEVICE --driver generic-mmc audiocd.toc
3710 echo " * Should I remove the temporary files? (yes/no)"
3712 if [[ "$input" = "yes" ]] ; then
3713 echo " ! Removing Temporary Files."
3718 echo " ! Invalid response."
3722 #f5# Make an audio CD from all mp3 files
3724 # TODO: do the renaming more zshish, possibly with zmv()
3727 for i in *.[Mm][Pp]3; do mv "$i" `echo $i | tr '[A-Z]' '[a-z]'`; done
3728 for i in *.mp3; do mv "$i" `echo $i | tr ' ' '_'`; done
3729 for i in *.mp3; do mpg123 -w `basename $i .mp3`.wav $i; done
3731 for i in *.wav; do sox $i.wav -r 44100 $i.wav resample; done
3734 #f5# Create an ISO image. You are prompted for\\&\quad volume name, filename and directory
3737 echo " * Volume name "
3739 echo " * ISO Name (ie. tmp.iso)"
3741 echo " * Directory or File"
3743 mkisofs -o ~/$iso -A $volume -allow-multidot -J -R -iso-level 3 -V $volume -R $files
3746 #f5# Simple thumbnails generator
3748 rm -rf thumb-* index.html
3752 <title>Images</title>
3754 <body>" > index.html
3755 for f in *.(gif|jpeg|jpg|png) ; do
3756 convert -size 100x200 "$f" -resize 100x200 thumb-"$f"
3757 echo " <a href=\"$f\"><img src=\"thumb-$f\"></a>" >> index.html
3761 </html>" >> index.html
3764 #f5# Set all ulimit parameters to \kbd{unlimited}
3775 # ogg2mp3 with bitrate of 192
3778 oggdec -o - $1 | lame -b 192 - ${1:r}.mp3
3781 #f5# RFC 2396 URL encoding in Z-Shell
3786 print ${(j::)input/(#b)([^A-Za-z0-9_.!~*\'\(\)-])/%${(l:2::0:)$(([##16]#match))}}
3789 #f5# Install x-lite (VoIP software)
3793 [[ -d ~/tmp ]] || mkdir ~/tmp
3796 echo "Downloading http://www.counterpath.com/download/X-Lite_Install.tar.gz and storing it in ~/tmp:"
3797 if wget http://www.counterpath.com/download/X-Lite_Install.tar.gz ; then
3798 unp X-Lite_Install.tar.gz && echo done || echo failed
3800 echo "Error while downloading." ; return 1
3803 if [[ -x xten-xlite/xtensoftphone ]] ; then
3804 echo "Execute xten-xlite/xtensoftphone to start xlite."
3812 echo "Downloading debian package of skype."
3813 echo "Notice: If you want to use a more recent skype version run 'getskypebeta'."
3814 wget http://www.skype.com/go/getskype-linux-deb
3815 $SUDO dpkg -i skype*.deb && echo "skype installed."
3818 #f5# Install beta-version of skype
3822 echo "Downloading debian package of skype (beta version)."
3823 wget http://www.skype.com/go/getskype-linux-beta-deb
3824 $SUDO dpkg -i skype-beta*.deb && echo "skype installed."
3827 #f5# Install gizmo (VoIP software)
3831 echo "libgtk2.0-0, gconf2, libstdc++6, libasound2 and zlib1g have to be available. Installing."
3832 $SUDO apt-get update
3833 $SUDO apt-get install libgtk2.0-0 gconf2 libstdc++6 libasound2 zlib1g
3834 wget "$(lynx --dump http://gizmo5.com/pc/download/linux/ | awk '/libstdc\+\+6.*\.deb/ {print $2}')"
3835 $SUDO dpkg -i gizmo-project*.deb && echo "gizmo installed."
3838 #f5# Get and run AIR (Automated Image and Restore)
3842 [[ -w . ]] || { echo 'Error: you do not have write permissions in this directory. Exiting.' ; return 1 }
3844 wget http://puzzle.dl.sourceforge.net/sourceforge/air-imager/air-$VER.tar.gz
3845 tar zxf air-$VER.tar.gz
3847 INTERACTIVE=no $SUDO ./install-air-1.2.8
3848 [[ -x /usr/local/bin/air ]] && [[ -n "$DISPLAY" ]] && $SUDO air
3851 #f5# Get specific git commitdiff
3854 if [[ -z $GITTREE ]] ; then
3855 GITTREE='linux/kernel/git/torvalds/linux-2.6.git'
3857 if ! [[ -z $1 ]] ; then
3858 ${=BROWSER} "http://kernel.org/git/?p=$GITTREE;a=commitdiff;h=$1"
3860 echo "Usage: git-get-diff <commit>"
3864 #f5# Get specific git commit
3867 if [[ -z $GITTREE ]] ; then
3868 GITTREE='linux/kernel/git/torvalds/linux-2.6.git'
3870 if ! [[ -z $1 ]] ; then
3871 ${=BROWSER} "http://kernel.org/git/?p=$GITTREE;a=commit;h=$1"
3873 echo "Usage: git-get-commit <commit>"
3877 #f5# Get specific git diff
3878 git-get-plaindiff () {
3880 if [[ -z $GITTREE ]] ; then
3881 GITTREE='linux/kernel/git/torvalds/linux-2.6.git'
3883 if [[ -z $1 ]] ; then
3884 echo 'Usage: git-get-plaindiff '
3886 echo -n "Downloading $1.diff ... "
3887 # avoid "generating ..." stuff from kernel.org server:
3888 wget --quiet "http://kernel.org/git/?p=$GITTREE;a=commitdiff_plain;h=$1" -O /dev/null
3889 wget --quiet "http://kernel.org/git/?p=$GITTREE;a=commitdiff_plain;h=$1" -O $1.diff \
3890 && echo done || echo failed
3895 # http://strcat.de/blog/index.php?/archives/335-Software-sauber-deinstallieren...html
3896 #f5# Log 'make install' output
3899 [[ ! -d ~/.errorlogs ]] && mkdir ~/.errorlogs
3900 make -n install > ~/.errorlogs/${PWD##*/}-makelog
3903 #f5# Indent source code
3905 indent -npro -kr -i8 -ts8 -sob -l80 -ss -ncs "$@"
3908 # highlight important stuff in diff output, usage example: hg diff | hidiff
3909 #m# a2 hidiff \kbd{histring} oneliner for diffs
3910 check_com -c histring && \
3911 alias hidiff="histring -fE '^Comparing files .*|^diff .*' | histring -c yellow -fE '^\-.*' | histring -c green -fE '^\+.*'"
3913 # rename pictures based on information found in exif headers
3914 #f5# Rename pictures based on information found in exif headers
3917 if [[ $# -lt 1 ]] ; then
3918 echo 'Usage: jpgrename $FILES' >& 2
3921 echo -n 'Checking for jhead with version newer than 1.9: '
3922 jhead_version=`jhead -h | grep 'used by most Digital Cameras. v.*' | awk '{print $6}' | tr -d v`
3923 if [[ $jhead_version > '1.9' ]]; then
3924 echo 'success - now running jhead.'
3925 jhead -n%Y-%m-%d_%Hh%M_%f $*
3927 echo 'failed - exiting.'
3932 # open file in vim and jump to line
3933 # http://www.downgra.de/archives/2007/05/08/T19_21_11/
3937 params=(${*//(#m):[0-9]*:/\\n+${MATCH//:/}}) # replace ':23:' to '\n+23'
3938 params=(${(s|\n|)${(j|\n|)params}}) # join array using '\n', then split on all '\n'
3942 # get_ic() - queries imap servers for capabilities; real simple. no imaps
3946 if [[ ! -z $1 ]] ; then
3948 print "querying imap server on $1:${port}...\n";
3949 print "a1 capability\na2 logout\n" | nc $1 ${port}
3951 print "usage:\n $0 <imap-server> [port]"
3955 # creates a Maildir/ with its {new,cur,tmp} subdirs
3959 root=${MAILDIR_ROOT:-${HOME}/Mail}
3960 if [[ -z ${1} ]] ; then print "Usage:\n $0 <dirname>" ; return 1 ; fi
3962 mkdir -p ${root}/${subdir}/{cur,new,tmp}
3965 #f5# Change the xterm title from within GNU-screen
3968 if [[ $1 != "-f" ]] ; then
3969 if [[ -z ${DISPLAY} ]] ; then
3970 printf 'xtrename only makes sense in X11.\n'
3976 if [[ -z $1 ]] ; then
3977 printf 'usage: xtrename [-f] "title for xterm"\n'
3978 printf ' renames the title of xterm from _within_ screen.\n'
3979 printf ' also works without screen.\n'
3980 printf ' will not work if DISPLAY is unset, use -f to override.\n'
3983 print -n "\eP\e]0;${1}\C-G\e\\"
3987 # hl() highlighted less
3988 # http://ft.bewatermyfriend.org/comp/data/zsh/zfunct.html
3989 if check_com -c highlight ; then
3993 theme=${HL_THEME:-""}
3996 ( printf 'available languages (syntax parameter):\n\n' ;
3997 highlight --list-langs ; ) | less -SMr
4000 ( printf 'available themes (style parameter):\n\n' ;
4001 highlight --list-themes ; ) | less -SMr
4004 printf 'usage: hl <syntax[:theme]> <file>\n'
4005 printf ' available options: --list (-l), --themes (-t), --help (-h)\n\n'
4006 printf ' Example: hl c main.c\n'
4009 if [[ -z ${2} ]] || (( ${#argv} > 2 )) ; then
4010 printf 'usage: hl <syntax[:theme]> <file>\n'
4011 printf ' available options: --list (-l), --themes (-t), --help (-h)\n'
4012 (( ${#argv} > 2 )) && printf ' Too many arguments.\n'
4016 [[ ${1} == *:* ]] && [[ -n ${1#*:} ]] && theme=${1#*:}
4017 if [[ -n ${theme} ]] ; then
4018 highlight --xterm256 --syntax ${lang} --style ${theme} ${2} | less -SMr
4020 highlight --ansi --syntax ${lang} ${2} | less -SMr
4026 # ... and a proper completion for hl()
4027 # needs 'highlight' as well, so it fits fine in here.
4028 function _hl_genarg() {
4030 if [[ -prefix 1 *: ]] ; then
4032 themes=(${${${(f)"$(LC_ALL=C highlight --list-themes)"}/ #/}:#*(Installed|Use name)*})
4034 _wanted -C list themes expl theme compadd ${themes}
4037 langs=(${${${(f)"$(LC_ALL=C highlight --list-langs)"}/ #/}:#*(Installed|Use name)*})
4038 _wanted -C list languages expl languages compadd -S ':' -q ${langs}
4041 function _hl_complete() {
4042 _arguments -s '1: :_hl_genarg' '2:files:_path_files'
4044 compdef _hl_complete hl
4047 # Create small urls via http://tinyurl.com using wget(1).
4050 [[ -z $1 ]] && { print "USAGE: zurl <URL>" ; return 1 }
4052 local PN url tiny grabber search result preview
4055 # Check existence of given URL with the help of ping(1).
4056 # N.B. ping(1) only works without an eventual given protocol.
4057 ping -c 1 ${${url#(ftp|http)://}%%/*} >& /dev/null || \
4058 read -q "?Given host ${${url#http://*/}%/*} is not reachable by pinging. Proceed anyway? [y|n] "
4060 if (( $? == 0 )) ; then
4061 # Prepend 'http://' to given URL where necessary for later output.
4062 [[ ${url} != http(s|)://* ]] && url='http://'${url}
4063 tiny='http://tinyurl.com/create.php?url='
4064 if check_com -c wget ; then
4065 grabber='wget -O- -o/dev/null'
4067 print "wget is not available, but mandatory for ${PN}. Aborting."
4069 # Looking for i.e.`copy('http://tinyurl.com/7efkze')' in TinyURL's HTML code.
4070 search='copy\(?http://tinyurl.com/[[:alnum:]]##*'
4071 result=${(M)${${${(f)"$(${=grabber} ${tiny}${url})"}[(fr)${search}*]}//[()\';]/}%%http:*}
4072 # TinyURL provides the rather new feature preview for more confidence. <http://tinyurl.com/preview.php>
4073 preview='http://preview.'${result#http://}
4075 printf '%s\n\n' "${PN} - Shrinking long URLs via webservice TinyURL <http://tinyurl.com>."
4076 printf '%s\t%s\n\n' 'Given URL:' ${url}
4077 printf '%s\t%s\n\t\t%s\n' 'TinyURL:' ${result} ${preview}
4083 #f2# Print a specific line of file(s).
4087 if [ $# -lt 2 ] ; then
4088 print "Usage: linenr <number>[,<number>] <file>" ; return 1
4089 elif [ $# -eq 2 ] ; then
4092 command ed -s $file <<< "${number}n"
4096 for file in "$@" ; do
4097 if [ ! -d $file ] ; then
4099 command ed -s $file <<< "${number}n" 2> /dev/null
4108 #f2# Find history events by search pattern and list them by date.
4112 local usage help ident format_l format_s first_char remain first last
4113 usage='USAGE: whatwhen [options] <searchstring> <search range>'
4114 help='Use' \`'whatwhen -h'\'' for further explanations.'
4115 ident=${(l,${#${:-Usage: }},, ,)}
4116 format_l="${ident}%s\t\t\t%s\n"
4117 format_s="${format_l//(\\t)##/\\t}"
4118 # Make the first char of the word to search for case
4119 # insensitive; e.g. [aA]
4120 first_char=[${(L)1[1]}${(U)1[1]}]
4122 # Default search range is `-100'.
4124 # Optional, just used for `<first> <last>' given.
4128 printf '%s\n\n' 'ERROR: No search string specified. Aborting.'
4129 printf '%s\n%s\n\n' ${usage} ${help} && return 1
4132 printf '%s\n\n' ${usage}
4134 printf $format_l '-h' 'show help text'
4136 print 'SEARCH RANGE:'
4137 printf $format_l "'0'" 'the whole history,'
4138 printf $format_l '-<n>' 'offset to the current history number; (default: -100)'
4139 printf $format_s '<[-]first> [<last>]' 'just searching within a give range'
4140 printf '\n%s\n' 'EXAMPLES:'
4141 printf ${format_l/(\\t)/} 'whatwhen grml' '# Range is set to -100 by default.'
4142 printf $format_l 'whatwhen zsh -250'
4143 printf $format_l 'whatwhen foo 1 99'
4146 printf '%s\n%s\n\n' ${usage} ${help} && return 1
4149 # -l list results on stout rather than invoking $EDITOR.
4150 # -i Print dates as in YYYY-MM-DD.
4151 # -m Search for a - quoted - pattern within the history.
4152 fc -li -m "*${first_char}${remain}*" $first $last
4158 # change fluxbox keys from 'Alt-#' to 'Alt-F#' and vice versa
4161 [[ -n "$FLUXKEYS" ]] || local FLUXKEYS="$HOME/.fluxbox/keys"
4162 if ! [[ -r "$FLUXKEYS" ]] ; then
4163 echo "Sorry, \$FLUXKEYS file $FLUXKEYS could not be read - nothing to be done."
4166 if grep -q 'Mod1 F[0-9] :Workspace [0-9]' $FLUXKEYS ; then
4167 echo -n 'Switching to Alt-# mode in ~/.fluxbox/keys: '
4168 sed -i -e 's|^\(Mod[0-9]\+[: space :]\+\)F\([0-9]\+[: space :]\+:Workspace.*\)|\1\2|' $FLUXKEYS && echo done || echo failed
4169 elif grep -q 'Mod1 [0-9] :Workspace [0-9]' $FLUXKEYS ; then
4170 echo -n 'Switching to Alt-F# mode in ~/.fluxbox/keys: '
4171 sed -i -e 's|^\(Mod[0-9]\+[: space :]\+\)\([0-9]\+[: space :]\+:Workspace.*\)|\1F\2|' $FLUXKEYS && echo done || echo failed
4173 echo 'Sorry, do not know what to do.'
4179 # retrieve weather information on the console
4180 # Usage example: 'weather LOWG'
4184 print 'Usage: weather <station_id>' >&2
4185 print 'List of stations: http://en.wikipedia.org/wiki/List_of_airports_by_ICAO_code'>&2
4189 local PLACE="${1:u}"
4190 local FILE="$HOME/.weather/$PLACE"
4191 local LOG="$HOME/.weather/log"
4193 [[ -d $HOME/.weather ]] || {
4194 print -n "Creating $HOME/.weather: "
4195 mkdir $HOME/.weather
4199 print "Retrieving information for ${PLACE}:"
4201 wget -T 10 --no-verbose --output-file=$LOG --output-document=$FILE --timestamping http://weather.noaa.gov/pub/data/observations/metar/decoded/$PLACE.TXT
4203 if [[ $? -eq 0 ]] ; then
4204 if [[ -n "$VERBOSE" ]] ; then
4207 DATE=$(grep 'UTC' $FILE | sed 's#.* /##')
4208 TEMPERATURE=$(awk '/Temperature/ { print $4" degree Celcius / " $2" degree Fahrenheit" }' $FILE| tr -d '(')
4210 echo "temp: $TEMPERATURE"
4213 print "There was an error retrieving the weather information for $PLACE" >&2
4220 # mercurial related stuff {{{
4221 if check_com -c hg ; then
4222 # gnu like diff for mercurial
4223 # http://www.selenic.com/mercurial/wiki/index.cgi/TipsAndTricks
4224 #f5# GNU like diff for mercurial
4227 for i in $(hg status -marn "$@") ; diff -ubwd <(hg cat "$i") "$i"
4230 # build debian package
4231 #a2# Alias for \kbd{hg-buildpackage}
4232 alias hbp='hg-buildpackage'
4234 # execute commands on the versioned patch-queue from the current repos
4235 alias mq='hg -R $(readlink -f $(hg root)/.hg/patches)'
4237 # diffstat for specific version of a mercurial repository
4238 # hgstat => display diffstat between last revision and tip
4239 # hgstat 1234 => display diffstat between revision 1234 and tip
4240 #f5# Diffstat for specific version of a mercurial repos
4243 [[ -n "$1" ]] && hg diff -r $1 -r tip | diffstat || hg export tip | diffstat
4246 #f5# Get current mercurial tip via hg itself
4250 if [[ -f mercurial-tree/.hg ]] ; then
4252 echo "Running hg pull for retreiving latest version..."
4254 echo "Finished update. Building mercurial"
4256 echo "Setting \$PATH to $PWD:\$PATH..."
4257 export PATH="$PWD:$PATH"
4259 echo "Downloading mercurial via hg"
4260 hg clone http://selenic.com/repo/hg mercurial-tree
4262 echo "Building mercurial"
4264 echo "Setting \$PATH to $PWD:\$PATH..."
4265 export PATH="$PWD:$PATH"
4266 echo "make sure you set it permanent via ~/.zshrc if you plan to use it permanently."
4267 # echo "Setting \$PYTHONPATH to PYTHONPATH=\${HOME}/lib/python,"
4268 # export PYTHONPATH=${HOME}/lib/python
4272 fi # end of check whether we have the 'hg'-executable
4274 # get current mercurial snapshot
4275 #f5# Get current mercurial snapshot
4279 if [[ -f mercurial-snapshot.tar.gz ]] ; then
4280 echo "mercurial-snapshot.tar.gz exists already, skipping download."
4282 echo "Downloading mercurial snapshot"
4283 wget http://www.selenic.com/mercurial/mercurial-snapshot.tar.gz
4285 echo "Unpacking mercurial-snapshot.tar.gz"
4286 tar zxf mercurial-snapshot.tar.gz
4287 cd mercurial-snapshot/
4288 echo "Installing required build-dependencies"
4289 $SUDO apt-get update
4290 $SUDO apt-get install python2.4-dev
4291 echo "Building mercurial"
4293 echo "Setting \$PATH to $PWD:\$PATH..."
4294 export PATH="$PWD:$PATH"
4295 echo "make sure you set it permanent via ~/.zshrc if you plan to use it permanently."
4299 # some useful commands often hard to remember - let's grep for them {{{
4300 # actually use our zg() function now. :)
4302 # Work around ion/xterm resize bug.
4303 #if [[ "$SHLVL" -eq 1 ]]; then
4304 # if check_com -c resize ; then
4305 # eval `resize </dev/null`
4310 # /usr/bin/jackd -dalsa -dhw:0 -r48000 -p1024 -n2
4311 # now play audio file:
4312 # alsaplayer -o jack foobar.mp3
4314 # send files via netcat
4316 # send() {j=$*; tar cpz ${j/%${!#}/}|nc -w 1 ${!#} 51330;}
4318 # alias receive='nc -vlp 51330 | tar xzvp'
4321 # dh_make -e foo@localhost -f $1
4322 # dpkg-buildpackage -rfakeroot
4324 # dpkg-scanpackages ./ /dev/null | gzip > Packages.gz
4325 # dpkg-scansources . | gzip > Sources.gz
4326 # grep-dctrl --field Maintainer $* /var/lib/apt/lists/*
4329 # convert -geometry 200x200 -interlace LINE -verbose
4330 # ldapsearch -x -b "OU=Bedienstete,O=tug" -h ldap.tugraz.at sn=$1
4331 # ps -ao user,pcpu,start,command
4332 # gpg --keyserver blackhole.pca.dfn.de --recv-keys
4333 # xterm -bg black -fg yellow -fn -misc-fixed-medium-r-normal--14-140-75-75-c-90-iso8859-15 -ah
4334 # nc -vz $1 1-1024 # portscan via netcat
4335 # wget --mirror --no-parent --convert-links
4337 # autoload -U tetris; zle -N tetris; bindkey '...' ; echo "press ... for playing tennis"
4339 # modify console cursor
4340 # see http://www.tldp.org/HOWTO/Framebuffer-HOWTO-5.html
4341 # print $'\e[?96;0;64c'
4344 # grml-small cleanups {{{
4346 # The following is used to remove zsh-config-items that do not work
4347 # in grml-small by default.
4348 # If you do not want these adjustments (for whatever reason), set
4349 # $GRMLSMALL_SPECIFIC to 0 in your .zshrc.pre file (which this configuration
4350 # sources if it is there).
4352 if (( GRMLSMALL_SPECIFIC > 0 )) && isgrmlsmall ; then
4355 unalias 'V' &> /dev/null
4356 unfunction vman &> /dev/null
4357 unfunction viless &> /dev/null
4358 unfunction 2html &> /dev/null
4360 # manpages are not in grmlsmall
4361 unfunction manzsh &> /dev/null
4362 unfunction man2 &> /dev/null
4370 ## genrefcard.pl settings {{{
4372 ### doc strings for external functions from files
4373 #m# f5 grml-wallpaper() Sets a wallpaper (try completion for possible values)
4375 ### example: split functions-search 8,16,24,32
4376 #@# split functions-search 8
4380 ## END OF FILE #################################################################
4381 # vim:filetype=zsh foldmethod=marker autoindent expandtab shiftwidth=4