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 are using this file as your ~/.zshrc file, please use ~/.zshrc.pre
16 # and ~/.zshrc.local for your own customisations. The former file is read
17 # before ~/.zshrc, the latter is read after it. Also, consider reading the
18 # refcard and the reference manual for this setup, both available from:
19 # <http://grml.org/zsh/>
22 # If you want to help to improve grml's zsh setup, clone the grml-etc-core
23 # repository from git.grml.org:
24 # git clone git://git.grml.org/grml-etc-core.git
26 # Make your changes, commit them; use 'git format-patch' to create a series
27 # of patches and send those to the following address via 'git send-email':
28 # grml-etc-core@grml.org
30 # Doing so makes sure the right people get your patches for review and
33 # zsh-refcard-tag documentation: {{{
34 # You may notice strange looking comments in this file.
35 # These are there for a purpose. grml's zsh-refcard can now be
36 # automatically generated from the contents of the actual configuration
37 # file. However, we need a little extra information on which comments
38 # and what lines of code to take into account (and for what purpose).
40 # Here is what they mean:
42 # List of tags (comment types) used:
43 # #a# Next line contains an important alias, that should
44 # be included in the grml-zsh-refcard.
45 # (placement tag: @@INSERT-aliases@@)
46 # #f# Next line contains the beginning of an important function.
47 # (placement tag: @@INSERT-functions@@)
48 # #v# Next line contains an important variable.
49 # (placement tag: @@INSERT-variables@@)
50 # #k# Next line contains an important keybinding.
51 # (placement tag: @@INSERT-keybindings@@)
52 # #d# Hashed directories list generation:
53 # start denotes the start of a list of 'hash -d'
55 # end denotes its end.
56 # (placement tag: @@INSERT-hasheddirs@@)
57 # #A# Abbreviation expansion list generation:
58 # start denotes the beginning of abbreviations.
59 # end denotes their end.
60 # Lines within this section that end in '#d .*' provide
61 # extra documentation to be included in the refcard.
62 # (placement tag: @@INSERT-abbrev@@)
63 # #m# This tag allows you to manually generate refcard entries
64 # for code lines that are hard/impossible to parse.
66 # #m# k ESC-h Call the run-help function
67 # That would add a refcard entry in the keybindings table
68 # for 'ESC-h' with the given comment.
69 # So the syntax is: #m# <section> <argument> <comment>
70 # #o# This tag lets you insert entries to the 'other' hash.
71 # Generally, this should not be used. It is there for
72 # things that cannot be done easily in another way.
73 # (placement tag: @@INSERT-other-foobar@@)
75 # All of these tags (except for m and o) take two arguments, the first
76 # within the tag, the other after the tag:
78 # #<tag><section># <comment>
80 # Where <section> is really just a number, which are defined by the
81 # @secmap array on top of 'genrefcard.pl'. The reason for numbers
82 # instead of names is, that for the reader, the tag should not differ
83 # much from a regular comment. For zsh, it is a regular comment indeed.
84 # The numbers have got the following meanings:
93 # So, the following will add an entry to the 'functions' table in the
94 # 'system' section, with a (hopefully) descriptive comment:
95 # #f1# Edit an alias via zle
98 # It will then show up in the @@INSERT-aliases-system@@ replacement tag
99 # that can be found in 'grml-zsh-refcard.tex.in'.
100 # If the section number is omitted, the 'default' section is assumed.
101 # Furthermore, in 'grml-zsh-refcard.tex.in' @@INSERT-aliases@@ is
102 # exactly the same as @@INSERT-aliases-default@@. If you want a list of
103 # *all* aliases, for example, use @@INSERT-aliases-all@@.
107 # just execute 'ZSH_PROFILE_RC=1 zsh' and run 'zprof' to get the details
108 if [[ $ZSH_PROFILE_RC -gt 0 ]] ; then
113 # load .zshrc.pre to give the user the chance to overwrite the defaults
114 [[ -r ${HOME}/.zshrc.pre ]] && source ${HOME}/.zshrc.pre
116 # {{{ check for version/system
117 # check for versions (compatibility reasons)
119 [[ $ZSH_VERSION == <4->* ]] && return 0
124 [[ $ZSH_VERSION == 4.<1->* || $ZSH_VERSION == <5->* ]] && return 0
129 [[ $ZSH_VERSION == 4.<2->* || $ZSH_VERSION == <5->* ]] && return 0
134 [[ $ZSH_VERSION == 4.2.<5->* || $ZSH_VERSION == 4.<3->* || $ZSH_VERSION == <5->* ]] && return 0
139 [[ $ZSH_VERSION == 4.<3->* || $ZSH_VERSION == <5->* ]] && return 0
144 [[ $ZSH_VERSION == 4.3.<3->* || $ZSH_VERSION == 4.<4->* || $ZSH_VERSION == <5->* ]] && return 0
149 [[ $ZSH_VERSION == 4.3.<9->* || $ZSH_VERSION == 4.<4->* || $ZSH_VERSION == <5->* ]] && return 0
153 #f1# Checks whether or not you're running grml
155 [[ -f /etc/grml_version ]] && return 0
159 #f1# Checks whether or not you're running a grml cd
161 [[ -f /etc/grml_cd ]] && return 0
166 #f1# Checks whether or not you're running grml-small
168 [[ ${${${(f)"$(</etc/grml_version)"}%% *}##*-} == 'small' ]] && return 0 ; return 1
171 isgrmlsmall() { return 1 }
175 [[ $OSTYPE == darwin* ]] && return 0
179 #f1# are we running within an utf environment?
181 case "$LANG $CHARSET $LANGUAGE" in
188 # check for user, if not running as root set $SUDO to sudo
189 (( EUID != 0 )) && SUDO='sudo' || SUDO=''
191 # change directory to home on first invocation of zsh
192 # important for rungetty -> autologin
193 # Thanks go to Bart Schaefer!
194 isgrml && checkhome() {
195 if [[ -z "$ALREADY_DID_CD_HOME" ]] ; then
196 export ALREADY_DID_CD_HOME=$HOME
201 # check for zsh v3.1.7+
203 if ! [[ ${ZSH_VERSION} == 3.1.<7->* \
204 || ${ZSH_VERSION} == 3.<2->.<->* \
205 || ${ZSH_VERSION} == <4->.<->* ]] ; then
208 printf '-!- In this configuration we try to make use of features, that only\n'
209 printf '-!- require version 3.1.7 of the shell; That way this setup can be\n'
210 printf '-!- used with a wide range of zsh versions, while using fairly\n'
211 printf '-!- advanced features in all supported versions.\n'
213 printf '-!- However, you are running zsh version %s.\n' "$ZSH_VERSION"
215 printf '-!- While this *may* work, it might as well fail.\n'
216 printf '-!- Please consider updating to at least version 3.1.7 of zsh.\n'
218 printf '-!- DO NOT EXPECT THIS TO WORK FLAWLESSLY!\n'
219 printf '-!- If it does today, you'\''ve been lucky.\n'
221 printf '-!- Ye been warned!\n'
224 function zstyle() { : }
227 # autoload wrapper - use this one instead of autoload directly
228 # We need to define this function as early as this, because autoloading
229 # 'is-at-least()' needs it.
230 function zrcautoload() {
238 for fdir in ${fpath} ; do
239 [[ -e ${fdir}/${ffile} ]] && (( ffound = 1 ))
242 (( ffound == 0 )) && return 1
243 if [[ $ZSH_VERSION == 3.1.<6-> || $ZSH_VERSION == <4->* ]] ; then
244 autoload -U ${ffile} || return 1
246 autoload ${ffile} || return 1
251 # Load is-at-least() for more precise version checks
252 # Note that this test will *always* fail, if the is-at-least
253 # function could not be marked for autoloading.
254 zrcautoload is-at-least || is-at-least() { return 1 }
258 # {{{ set some important options (as early as possible)
259 # Please update these tags, if you change the umask settings below.
261 #o# r_umaskstr rwxrwxr-x
263 #o# umaskstr rwxr-xr-x
264 if (( EUID == 0 )); then
270 setopt append_history # append history list to the history file (important for multiple parallel zsh sessions!)
271 is4 && setopt SHARE_HISTORY # import new commands from the history file also in other zsh-session
272 setopt extended_history # save each command's beginning timestamp and the duration to the history file
273 is4 && setopt histignorealldups # If a new command line being added to the history
274 # list duplicates an older one, the older command is removed from the list
275 setopt histignorespace # remove command lines from the history list when
276 # the first character on the line is a space
277 setopt auto_cd # if a command is issued that can't be executed as a normal command,
278 # and the command is the name of a directory, perform the cd command to that directory
279 setopt extended_glob # in order to use #, ~ and ^ for filename generation
280 # grep word *~(*.gz|*.bz|*.bz2|*.zip|*.Z) ->
281 # -> searches for word not in compressed files
282 # don't forget to quote '^', '~' and '#'!
283 setopt longlistjobs # display PID when suspending processes as well
284 setopt notify # report the status of backgrounds jobs immediately
285 setopt hash_list_all # Whenever a command completion is attempted, make sure \
286 # the entire command path is hashed first.
287 setopt completeinword # not just at the end
288 setopt nohup # and don't kill them, either
289 setopt auto_pushd # make cd push the old directory onto the directory stack.
290 setopt nonomatch # try to avoid the 'zsh: no matches found...'
291 setopt nobeep # avoid "beep"ing
292 setopt pushd_ignore_dups # don't push the same dir twice.
293 setopt noglobdots # * shouldn't match dotfiles. ever.
294 setopt noshwordsplit # use zsh style word splitting
295 setopt unset # don't error out when unset parameters are used
299 # setting some default values {{{
303 NOPRECMD=${NOPRECMD:-0}
304 COMMAND_NOT_FOUND=${COMMAND_NOT_FOUND:-0}
305 GRML_ZSH_CNF_HANDLER=${GRML_ZSH_CNF_HANDLER:-/usr/share/command-not-found/command-not-found}
306 BATTERY=${BATTERY:-0}
307 GRMLSMALL_SPECIFIC=${GRMLSMALL_SPECIFIC:-1}
308 GRML_ALWAYS_LOAD_ALL=${GRML_ALWAYS_LOAD_ALL:-0}
309 ZSH_NO_DEFAULT_LOCALE=${ZSH_NO_DEFAULT_LOCALE:-0}
313 # utility functions {{{
314 # this function checks if a command exists and returns either true
315 # or false. This avoids using 'which' and 'whence', which will
316 # avoid problems with aliases for which on certain weird systems. :-)
317 # Usage: check_com [-c|-g] word
318 # -c only checks for external commands
319 # -g does the usual tests and also checks for global aliases
322 local -i comonly gatoo
324 if [[ $1 == '-c' ]] ; then
327 elif [[ $1 == '-g' ]] ; then
334 if (( ${#argv} != 1 )) ; then
335 printf 'usage: check_com [-c] <command>\n' >&2
339 if (( comonly > 0 )) ; then
340 [[ -n ${commands[$1]} ]] && return 0
344 if [[ -n ${commands[$1]} ]] \
345 || [[ -n ${functions[$1]} ]] \
346 || [[ -n ${aliases[$1]} ]] \
347 || [[ -n ${reswords[(r)$1]} ]] ; then
352 if (( gatoo > 0 )) && [[ -n ${galiases[$1]} ]] ; then
359 # creates an alias and precedes the command with
360 # sudo if $EUID is not zero.
363 local only=0 ; local multi=0
364 while [[ $1 == -* ]] ; do
368 (--) shift ; break ;;
370 printf 'usage: salias [-h|-o|-a] <alias-expression>\n'
371 printf ' -h shows this help text.\n'
372 printf ' -a replace '\'' ; '\'' sequences with '\'' ; sudo '\''.\n'
373 printf ' be careful using this option.\n'
374 printf ' -o only sets an alias if a preceding sudo would be needed.\n'
377 (*) printf "unkown option: '%s'\n" "$1" ; return 1 ;;
382 if (( ${#argv} > 1 )) ; then
383 printf 'Too many arguments %s\n' "${#argv}"
387 key="${1%%\=*}" ; val="${1#*\=}"
388 if (( EUID == 0 )) && (( only == 0 )); then
389 alias -- "${key}=${val}"
390 elif (( EUID > 0 )) ; then
391 (( multi > 0 )) && val="${val// ; / ; sudo }"
392 alias -- "${key}=sudo ${val}"
398 # a "print -l ${(u)foo}"-workaround for pre-4.2.0 shells
400 # Where foo is the *name* of the parameter you want printed.
401 # Note that foo is no typo; $foo would be wrong here!
409 if [[ -z ${parameter} ]] ; then
410 printf 'usage: uprint <parameter>\n'
414 for w in ${(P)parameter} ; do
415 [[ -z ${(M)u:#$w} ]] && u=( $u $w )
422 # Check if we can read given files and source those we can.
424 if (( ${#argv} < 1 )) ; then
425 printf 'usage: xsource FILE(s)...\n' >&2
429 while (( ${#argv} > 0 )) ; do
430 [[ -r "$1" ]] && source "$1"
436 # Check if we can read a given file and 'cat(1)' it.
439 if (( ${#argv} != 1 )) ; then
440 printf 'usage: xcat FILE\n' >&2
444 [[ -r $1 ]] && cat $1
448 # Remove these functions again, they are of use only in these
449 # setup files. This should be called at the end of .zshrc.
453 funcs=(salias xcat xsource xunfunction zrcautoload)
455 for func in $funcs ; do
456 [[ -n ${functions[$func]} ]] \
462 # this allows us to stay in sync with grml's zshrc and put own
463 # modifications in ~/.zshrc.local
465 xsource "/etc/zsh/zshrc.local"
466 xsource "${HOME}/.zshrc.local"
473 if (( ZSH_NO_DEFAULT_LOCALE == 0 )); then
474 xsource "/etc/default/locale"
477 for var in LANG LC_ALL LC_MESSAGES ; do
478 [[ -n ${(P)var} ]] && export $var
481 xsource "/etc/sysconfig/keyboard"
483 TZ=$(xcat /etc/timezone)
486 # {{{ set some variables
487 if check_com -c vim ; then
489 export EDITOR=${EDITOR:-vim}
491 export EDITOR=${EDITOR:-vi}
495 export PAGER=${PAGER:-less}
498 export MAIL=${MAIL:-/var/mail/$USER}
500 # if we don't set $SHELL then aterm, rxvt,.. will use /bin/sh or /bin/bash :-/
501 export SHELL='/bin/zsh'
503 # color setup for ls:
504 check_com -c dircolors && eval $(dircolors -b)
505 # color setup for ls on OS X:
506 isdarwin && export CLICOLOR=1
508 # do MacPorts setup on darwin
509 if isdarwin && [[ -d /opt/local ]]; then
510 # Note: PATH gets set in /etc/zprofile on Darwin, so this can't go into
512 PATH="/opt/local/bin:/opt/local/sbin:$PATH"
513 MANPATH="/opt/local/share/man:$MANPATH"
515 # do Fink setup on darwin
516 isdarwin && xsource /sw/bin/init.sh
518 # load our function and completion directories
519 for fdir in /usr/share/grml/zsh/completion /usr/share/grml/zsh/functions; do
520 fpath=( ${fdir} ${fdir}/**/*(/N) ${fpath} )
521 if [[ ${fpath} == '/usr/share/grml/zsh/functions' ]] ; then
522 for func in ${fdir}/**/[^_]*[^~](N.) ; do
523 zrcautoload ${func:t}
529 # support colors in less
530 export LESS_TERMCAP_mb=$'\E[01;31m'
531 export LESS_TERMCAP_md=$'\E[01;31m'
532 export LESS_TERMCAP_me=$'\E[0m'
533 export LESS_TERMCAP_se=$'\E[0m'
534 export LESS_TERMCAP_so=$'\E[01;44;33m'
535 export LESS_TERMCAP_ue=$'\E[0m'
536 export LESS_TERMCAP_us=$'\E[01;32m'
538 MAILCHECK=30 # mailchecks
539 REPORTTIME=5 # report about cpu-/system-/user-time of command if running longer than 5 seconds
540 watch=(notme root) # watch for everyone but me and root
542 # automatically remove duplicates from these arrays
543 typeset -U path cdpath fpath manpath
547 if [[ "$TERM" != emacs ]] ; then
548 [[ -z "$terminfo[kdch1]" ]] || bindkey -M emacs "$terminfo[kdch1]" delete-char
549 [[ -z "$terminfo[khome]" ]] || bindkey -M emacs "$terminfo[khome]" beginning-of-line
550 [[ -z "$terminfo[kend]" ]] || bindkey -M emacs "$terminfo[kend]" end-of-line
551 [[ -z "$terminfo[kdch1]" ]] || bindkey -M vicmd "$terminfo[kdch1]" vi-delete-char
552 [[ -z "$terminfo[khome]" ]] || bindkey -M vicmd "$terminfo[khome]" vi-beginning-of-line
553 [[ -z "$terminfo[kend]" ]] || bindkey -M vicmd "$terminfo[kend]" vi-end-of-line
554 [[ -z "$terminfo[cuu1]" ]] || bindkey -M viins "$terminfo[cuu1]" vi-up-line-or-history
555 [[ -z "$terminfo[cuf1]" ]] || bindkey -M viins "$terminfo[cuf1]" vi-forward-char
556 [[ -z "$terminfo[kcuu1]" ]] || bindkey -M viins "$terminfo[kcuu1]" vi-up-line-or-history
557 [[ -z "$terminfo[kcud1]" ]] || bindkey -M viins "$terminfo[kcud1]" vi-down-line-or-history
558 [[ -z "$terminfo[kcuf1]" ]] || bindkey -M viins "$terminfo[kcuf1]" vi-forward-char
559 [[ -z "$terminfo[kcub1]" ]] || bindkey -M viins "$terminfo[kcub1]" vi-backward-char
561 [[ "$terminfo[kcuu1]" == $'\eO'* ]] && bindkey -M viins "${terminfo[kcuu1]/O/[}" vi-up-line-or-history
562 [[ "$terminfo[kcud1]" == $'\eO'* ]] && bindkey -M viins "${terminfo[kcud1]/O/[}" vi-down-line-or-history
563 [[ "$terminfo[kcuf1]" == $'\eO'* ]] && bindkey -M viins "${terminfo[kcuf1]/O/[}" vi-forward-char
564 [[ "$terminfo[kcub1]" == $'\eO'* ]] && bindkey -M viins "${terminfo[kcub1]/O/[}" vi-backward-char
565 [[ "$terminfo[khome]" == $'\eO'* ]] && bindkey -M viins "${terminfo[khome]/O/[}" beginning-of-line
566 [[ "$terminfo[kend]" == $'\eO'* ]] && bindkey -M viins "${terminfo[kend]/O/[}" end-of-line
567 [[ "$terminfo[khome]" == $'\eO'* ]] && bindkey -M emacs "${terminfo[khome]/O/[}" beginning-of-line
568 [[ "$terminfo[kend]" == $'\eO'* ]] && bindkey -M emacs "${terminfo[kend]/O/[}" end-of-line
571 ## keybindings (run 'bindkeys' for details, more details via man zshzle)
572 # use emacs style per default:
577 #if [[ "$TERM" == screen ]] ; then
578 bindkey '\e[1~' beginning-of-line # home
579 bindkey '\e[4~' end-of-line # end
580 bindkey '\e[A' up-line-or-search # cursor up
581 bindkey '\e[B' down-line-or-search # <ESC>-
583 bindkey '^xp' history-beginning-search-backward
584 bindkey '^xP' history-beginning-search-forward
585 # bindkey -s '^L' "|less\n" # ctrl-L pipes to less
586 # bindkey -s '^B' " &\n" # ctrl-B runs it in the background
587 # if terminal type is set to 'rxvt':
588 bindkey '\e[7~' beginning-of-line # home
589 bindkey '\e[8~' end-of-line # end
592 # insert unicode character
593 # usage example: 'ctrl-x i' 00A7 'ctrl-x i' will give you an §
594 # See for example http://unicode.org/charts/ for unicode characters code
595 zrcautoload insert-unicode-char
596 zle -N insert-unicode-char
597 #k# Insert Unicode character
598 bindkey '^Xi' insert-unicode-char
600 #m# k Shift-tab Perform backwards menu completion
601 if [[ -n "$terminfo[kcbt]" ]]; then
602 bindkey "$terminfo[kcbt]" reverse-menu-complete
603 elif [[ -n "$terminfo[cbt]" ]]; then # required for GNU screen
604 bindkey "$terminfo[cbt]" reverse-menu-complete
607 ## toggle the ,. abbreviation feature on/off
608 # NOABBREVIATION: default abbreviation-state
609 # 0 - enabled (default)
611 NOABBREVIATION=${NOABBREVIATION:-0}
613 grml_toggle_abbrev() {
614 if (( ${NOABBREVIATION} > 0 )) ; then
621 zle -N grml_toggle_abbrev
622 bindkey '^xA' grml_toggle_abbrev
624 # add a command line to the shells history without executing it
625 commit-to-history() {
626 print -s ${(z)BUFFER}
629 zle -N commit-to-history
630 bindkey "^x^h" commit-to-history
632 # only slash should be considered as a word separator:
633 slash-backward-kill-word() {
634 local WORDCHARS="${WORDCHARS:s@/@}"
636 zle backward-kill-word
638 zle -N slash-backward-kill-word
640 #k# Kill everything in a word up to its last \kbd{/}
641 bindkey '\ev' slash-backward-kill-word
642 #k# Kill everything in a word up to its last \kbd{/}
643 bindkey '\e^h' slash-backward-kill-word
644 #k# Kill everything in a word up to its last \kbd{/}
645 bindkey '\e^?' slash-backward-kill-word
647 # use the new *-pattern-* widgets for incremental history search
649 bindkey '^r' history-incremental-pattern-search-backward
650 bindkey '^s' history-incremental-pattern-search-forward
654 # a generic accept-line wrapper {{{
656 # This widget can prevent unwanted autocorrections from command-name
657 # to _command-name, rehash automatically on enter and call any number
658 # of builtin and user-defined widgets in different contexts.
660 # For a broader description, see:
661 # <http://bewatermyfriend.org/posts/2007/12-26.11-50-38-tooltime.html>
663 # The code is imported from the file 'zsh/functions/accept-line' from
664 # <http://ft.bewatermyfriend.org/comp/zsh/zsh-dotfiles.tar.bz2>, which
665 # distributed under the same terms as zsh itself.
667 # A newly added command will may not be found or will cause false
668 # correction attempts, if you got auto-correction set. By setting the
669 # following style, we force accept-line() to rehash, if it cannot
670 # find the first word on the command line in the $command[] hash.
671 zstyle ':acceptline:*' rehash true
673 function Accept-Line() {
679 zstyle -a ":acceptline:${alcontext}" actions subs
681 (( ${#subs} < 1 )) && return 0
684 for sub in ${subs} ; do
685 [[ ${sub} == 'accept-line' ]] && sub='.accept-line'
688 (( aldone > 0 )) && break
692 function Accept-Line-getdefault() {
696 zstyle -s ":acceptline:${alcontext}" default_action default_action
697 case ${default_action} in
699 printf ".accept-line"
702 printf ${default_action}
707 function accept-line() {
711 local buf com fname format msg default_action
715 cmdline=(${(z)BUFFER})
719 zstyle -t ":acceptline:${alcontext}" rehash \
720 && [[ -z ${commands[$com]} ]] \
723 if [[ -n ${reswords[(r)$com]} ]] \
724 || [[ -n ${aliases[$com]} ]] \
725 || [[ -n ${functions[$com]} ]] \
726 || [[ -n ${builtins[$com]} ]] \
727 || [[ -n ${commands[$com]} ]] ; then
729 # there is something sensible to execute, just do it.
733 default_action=$(Accept-Line-getdefault)
734 zstyle -T ":acceptline:${alcontext}" call_default \
735 && zle ${default_action}
739 if [[ -o correct ]] \
740 || [[ -o correctall ]] \
741 && [[ -n ${functions[$fname]} ]] ; then
743 # nothing there to execute but there is a function called
744 # _command_name; a completion widget. Makes no sense to
745 # call it on the commandline, but the correct{,all} options
746 # will ask for it nevertheless, so warn the user.
747 if [[ ${LASTWIDGET} == 'accept-line' ]] ; then
748 # Okay, we warned the user before, he called us again,
749 # so have it his way.
753 default_action=$(Accept-Line-getdefault)
754 zstyle -T ":acceptline:${alcontext}" call_default \
755 && zle ${default_action}
759 # prepare warning message for the user, configurable via zstyle.
760 zstyle -s ":acceptline:${alcontext}" compwarnfmt msg
762 if [[ -z ${msg} ]] ; then
763 msg="%c will not execute and completion %f exists."
766 zformat -f msg "${msg}" "c:${com}" "f:${fname}"
770 elif [[ -n ${buf//[$' \t\n']##/} ]] ; then
771 # If we are here, the commandline contains something that is not
772 # executable, which is neither subject to _command_name correction
773 # and is not empty. might be a variable assignment
777 default_action=$(Accept-Line-getdefault)
778 zstyle -T ":acceptline:${alcontext}" call_default \
779 && zle ${default_action}
783 # If we got this far, the commandline only contains whitespace, or is empty.
787 default_action=$(Accept-Line-getdefault)
788 zstyle -T ":acceptline:${alcontext}" call_default \
789 && zle ${default_action}
797 # power completion - abbreviation expansion {{{
798 # power completion / abbreviation expansion / buffer expansion
799 # see http://zshwiki.org/home/examples/zleiab for details
800 # less risky than the global aliases but powerful as well
801 # just type the abbreviation key and afterwards ',.' to expand it
804 setopt interactivecomments
806 # key # value (#d additional doc string)
812 'G' '|& grep --color=auto '
814 'Hl' ' --help |& less -r' #d (Display help in pager)
818 'N' '&>/dev/null' #d (No Output)
819 'R' '| tr A-z N-za-m' #d (ROT13)
825 'co' './configure && make && sudo make install'
833 if (( NOABBREVIATION > 0 )) ; then
834 LBUFFER="${LBUFFER},."
838 matched_chars='[.-|_a-zA-Z0-9]#'
839 LBUFFER=${LBUFFER%%(#m)[.-|_a-zA-Z0-9]#}
840 LBUFFER+=${abk[$MATCH]:-$MATCH}
844 bindkey ",." globalias
848 zrcautoload zmv # who needs mmv or rename?
849 zrcautoload history-search-end
851 # we don't want to quote/espace URLs on our own...
852 # if autoload -U url-quote-magic ; then
853 # zle -N self-insert url-quote-magic
854 # zstyle ':url-quote-magic:*' url-metas '*?[]^()~#{}='
856 # print 'Notice: no url-quote-magic available :('
858 alias url-quote='autoload -U url-quote-magic ; zle -N self-insert url-quote-magic'
860 #m# k ESC-h Call \kbd{run-help} for the 1st word on the command line
861 alias run-help >&/dev/null && unalias run-help
862 for rh in run-help{,-git,-svk,-svn}; do
867 if zrcautoload compinit ; then
868 compinit || print 'Notice: no compinit available :('
870 print 'Notice: no compinit available :('
875 is4 && zrcautoload zed # use ZLE editor to edit a file or function
878 for mod in complist deltochar mathfunc ; do
879 zmodload -i zsh/${mod} 2>/dev/null || print "Notice: no ${mod} available :("
882 # autoload zsh modules when they are referenced
884 zmodload -a zsh/stat zstat
885 zmodload -a zsh/zpty zpty
886 zmodload -ap zsh/mapfile mapfile
889 if is4 && zrcautoload insert-files && zle -N insert-files ; then
891 bindkey "^Xf" insert-files # C-x-f
894 bindkey ' ' magic-space # also do history expansion on space
895 #k# Trigger menu-complete
896 bindkey '\ei' menu-complete # menu completion via esc-i
898 # press esc-e for editing command line in $EDITOR or $VISUAL
899 if is4 && zrcautoload edit-command-line && zle -N edit-command-line ; then
900 #k# Edit the current line in \kbd{\$EDITOR}
901 bindkey '\ee' edit-command-line
904 if is4 && [[ -n ${(k)modules[zsh/complist]} ]] ; then
905 #k# menu selection: pick item but stay in the menu
906 bindkey -M menuselect '\e^M' accept-and-menu-complete
908 # accept a completion and try to complete again by using menu
909 # completion; very useful with completing directories
910 # by using 'undo' one's got a simple file browser
911 bindkey -M menuselect '^o' accept-and-infer-next-history
914 # press "ctrl-e d" to insert the actual date in the form yyyy-mm-dd
915 insert-datestamp() { LBUFFER+=${(%):-'%D{%Y-%m-%d}'}; }
916 zle -N insert-datestamp
918 #k# Insert a timestamp on the command line (yyyy-mm-dd)
919 bindkey '^Ed' insert-datestamp
921 # press esc-m for inserting last typed word again (thanks to caphuso!)
922 insert-last-typed-word() { zle insert-last-word -- 0 -1 };
923 zle -N insert-last-typed-word;
925 #k# Insert last typed word
926 bindkey "\em" insert-last-typed-word
928 function grml-zsh-fg() {
929 if (( ${#jobstates} )); then
931 [[ -o hist_ignore_space ]] && BUFFER=' ' || BUFFER=''
935 zle -M 'No background jobs. Doing nothing.'
939 #k# A smart shortcut for \kbd{fg<enter>}
940 bindkey '^z' grml-zsh-fg
942 # run command line as user root via sudo:
943 sudo-command-line() {
944 [[ -z $BUFFER ]] && zle up-history
945 if [[ $BUFFER != sudo\ * ]]; then
946 BUFFER="sudo $BUFFER"
947 CURSOR=$(( CURSOR+5 ))
950 zle -N sudo-command-line
952 #k# Put the current command line into a \kbd{sudo} call
953 bindkey "^Os" sudo-command-line
955 ### jump behind the first word on the cmdline.
956 ### useful to add options.
957 function jump_after_first_word() {
961 if (( ${#words} <= 1 )) ; then
964 CURSOR=${#${words[1]}}
967 zle -N jump_after_first_word
969 bindkey '^x1' jump_after_first_word
978 HISTFILE=$HOME/.zsh_history
979 isgrmlcd && HISTSIZE=500 || HISTSIZE=5000
980 isgrmlcd && SAVEHIST=1000 || SAVEHIST=10000 # useful for setopt append_history
984 # dirstack handling {{{
986 DIRSTACKSIZE=${DIRSTACKSIZE:-20}
987 DIRSTACKFILE=${DIRSTACKFILE:-${HOME}/.zdirs}
989 if [[ -f ${DIRSTACKFILE} ]] && [[ ${#dirstack[*]} -eq 0 ]] ; then
990 dirstack=( ${(f)"$(< $DIRSTACKFILE)"} )
991 # "cd -" won't work after login by just setting $OLDPWD, so
992 [[ -d $dirstack[0] ]] && cd $dirstack[0] && cd $OLDPWD
997 my_stack=( ${PWD} ${dirstack} )
999 builtin print -l ${(u)my_stack} >! ${DIRSTACKFILE}
1001 uprint my_stack >! ${DIRSTACKFILE}
1007 # directory based profiles {{{
1011 CHPWD_PROFILE='default'
1012 function chpwd_profiles() {
1013 # Say you want certain settings to be active in certain directories.
1014 # This is what you want.
1016 # zstyle ':chpwd:profiles:/usr/src/grml(|/|/*)' profile grml
1017 # zstyle ':chpwd:profiles:/usr/src/debian(|/|/*)' profile debian
1019 # When that's done and you enter a directory that matches the pattern
1020 # in the third part of the context, a function called chpwd_profile_grml,
1021 # for example, is called (if it exists).
1023 # If no pattern matches (read: no profile is detected) the profile is
1024 # set to 'default', which means chpwd_profile_default is attempted to
1027 # A word about the context (the ':chpwd:profiles:*' stuff in the zstyle
1028 # command) which is used: The third part in the context is matched against
1029 # ${PWD}. That's why using a pattern such as /foo/bar(|/|/*) makes sense.
1030 # Because that way the profile is detected for all these values of ${PWD}:
1034 # So, if you want to make double damn sure a profile works in /foo/bar
1035 # and everywhere deeper in that tree, just use (|/|/*) and be happy.
1037 # The name of the detected profile will be available in a variable called
1038 # 'profile' in your functions. You don't need to do anything, it'll just
1041 # Then there is the parameter $CHPWD_PROFILE is set to the profile, that
1042 # was is currently active. That way you can avoid running code for a
1043 # profile that is already active, by running code such as the following
1044 # at the start of your function:
1046 # function chpwd_profile_grml() {
1047 # [[ ${profile} == ${CHPWD_PROFILE} ]] && return 1
1051 # The initial value for $CHPWD_PROFILE is 'default'.
1053 # Version requirement:
1054 # This feature requires zsh 4.3.3 or newer.
1055 # If you use this feature and need to know whether it is active in your
1056 # current shell, there are several ways to do that. Here are two simple
1059 # a) If knowing if the profiles feature is active when zsh starts is
1060 # good enough for you, you can put the following snippet into your
1063 # (( ${+functions[chpwd_profiles]} )) && print "directory profiles active"
1065 # b) If that is not good enough, and you would prefer to be notified
1066 # whenever a profile changes, you can solve that by making sure you
1067 # start *every* profile function you create like this:
1069 # function chpwd_profile_myprofilename() {
1070 # [[ ${profile} == ${CHPWD_PROFILE} ]] && return 1
1071 # print "chpwd(): Switching to profile: $profile"
1075 # That makes sure you only get notified if a profile is *changed*,
1076 # not everytime you change directory, which would probably piss
1077 # you off fairly quickly. :-)
1079 # There you go. Now have fun with that.
1082 zstyle -s ":chpwd:profiles:${PWD}" profile profile || profile='default'
1083 if (( ${+functions[chpwd_profile_$profile]} )) ; then
1084 chpwd_profile_${profile}
1087 CHPWD_PROFILE="${profile}"
1090 chpwd_functions=( ${chpwd_functions} chpwd_profiles )
1096 # {{{ display battery status on right side of prompt via running 'BATTERY=1 zsh'
1097 if [[ $BATTERY -gt 0 ]] ; then
1098 if ! check_com -c acpi ; then
1104 if [[ $BATTERY -gt 0 ]] ; then
1105 PERCENT="${${"$(acpi 2>/dev/null)"}/(#b)[[:space:]]#Battery <->: [^0-9]##, (<->)%*/${match[1]}}"
1106 if [[ -z "$PERCENT" ]] ; then
1107 PERCENT='acpi not present'
1109 if [[ "$PERCENT" -lt 20 ]] ; then
1110 PERCENT="warning: ${PERCENT}%%"
1112 PERCENT="${PERCENT}%%"
1119 # set colors for use in prompts {{{
1120 if zrcautoload colors && colors 2>/dev/null ; then
1121 BLUE="%{${fg[blue]}%}"
1122 RED="%{${fg_bold[red]}%}"
1123 GREEN="%{${fg[green]}%}"
1124 CYAN="%{${fg[cyan]}%}"
1125 MAGENTA="%{${fg[magenta]}%}"
1126 YELLOW="%{${fg[yellow]}%}"
1127 WHITE="%{${fg[white]}%}"
1128 NO_COLOUR="%{${reset_color}%}"
1130 BLUE=$'%{\e[1;34m%}'
1132 GREEN=$'%{\e[1;32m%}'
1133 CYAN=$'%{\e[1;36m%}'
1134 WHITE=$'%{\e[1;37m%}'
1135 MAGENTA=$'%{\e[1;35m%}'
1136 YELLOW=$'%{\e[1;33m%}'
1137 NO_COLOUR=$'%{\e[0m%}'
1142 # gather version control information for inclusion in a prompt {{{
1145 # Be quiet about version problems in grml's zshrc as the user cannot disable
1146 # loading vcs_info() as it is *in* the zshrc - as you can see. :-)
1147 # Just unset most probable variables and disable vcs_info altogether.
1149 for i in {0..9} ; do
1150 unset VCS_INFO_message_${i}_
1152 zstyle ':vcs_info:*' enable false
1155 if zrcautoload vcs_info; then
1157 # `vcs_info' in zsh versions 4.3.10 and below have a broken `_realpath'
1158 # function, which can cause a lot of trouble with our directory-based
1160 if [[ ${ZSH_VERSION} == 4.3.<-10> ]] ; then
1161 function VCS_INFO_realpath () {
1162 setopt localoptions NO_shwordsplit chaselinks
1163 ( builtin cd -q $1 2> /dev/null && pwd; )
1167 # I'm not reindenting the whole code below.
1170 # The following code is imported from the file 'zsh/functions/vcs_info'
1171 # from <http://ft.bewatermyfriend.org/comp/zsh/zsh-dotfiles.tar.bz2>,
1172 # which distributed under the same terms as zsh itself.
1174 # we will be using two variables, so let the code know now.
1175 zstyle ':vcs_info:*' max-exports 2
1177 # vcs_info() documentation:
1181 # This functionality requires zsh version >= 4.1.*.
1186 # To load vcs_info(), copy this file to your $fpath[] and do:
1187 # % autoload -Uz vcs_info && vcs_info
1189 # To work, vcs_info() needs 'setopt prompt_subst' in your setup.
1194 # To get vcs_info() working quickly (including colors), you can do the
1195 # following (assuming, you loaded vcs_info() properly - see above):
1197 # % RED=$'%{\e[31m%}'
1198 # % GR=$'%{\e[32m%}'
1199 # % MA=$'%{\e[35m%}'
1200 # % YE=$'%{\e[33m%}'
1203 # % zstyle ':vcs_info:*' actionformats \
1204 # "${MA}(${NC}%s${MA})${YE}-${MA}[${GR}%b${YE}|${RED}%a${MA}]${NC} "
1206 # % zstyle ':vcs_info:*' formats \
1207 # "${MA}(${NC}%s${MA})${Y}-${MA}[${GR}%b${MA}]${NC}%} "
1209 # % zstyle ':vcs_info:(sv[nk]|bzr):*' branchformat "%b${RED}:${YE}%r"
1211 # % precmd () { vcs_info }
1212 # % PS1='${MA}[${GR}%n${MA}] ${MA}(${RED}%!${MA}) ${YE}%3~ ${VCS_INFO_message_0_}${NC}%# '
1214 # Obviously, the las two lines are there for demonstration: You need to
1215 # call vcs_info() from your precmd() function (see 'SPECIAL FUNCTIONS' in
1216 # 'man zshmisc'). Once that is done you need a *single* quoted
1217 # '${VCS_INFO_message_0_}' in your prompt.
1219 # Now call the 'vcs_info_printsys' utility from the command line:
1221 # % vcs_info_printsys
1222 # # list of supported version control backends:
1223 # # disabled systems are prefixed by a hash sign (#)
1234 # # flavours (cannot be used in the disable style; they
1235 # # are disabled with their master [git-svn -> git]):
1239 # Ten version control backends as you can see. You may not want all
1240 # of these. Because there is no point in running the code to detect
1241 # systems you do not use. ever. So, there is a way to disable some
1242 # backends altogether:
1244 # % zstyle ':vcs_info:*' disable bzr cdv darcs mtn svk tla
1246 # If you rerun 'vcs_info_printsys' now, you will see the backends listed
1247 # in the 'disable' style marked as diabled by a hash sign. That means the
1248 # detection of these systems is skipped *completely*. No wasted time there.
1250 # For more control, read the reference below.
1255 # The vcs_info() feature can be configured via zstyle.
1257 # First, the context in which we are working:
1258 # :vcs_info:<vcs-string>:<user-context>
1260 # ...where <vcs-string> is one of:
1261 # - git, git-svn, git-p4, hg, darcs, bzr, cdv, mtn, svn, cvs, svk or tla.
1263 # ...and <user-context> is a freely configurable string, assignable by the
1264 # user as the first argument to vcs_info() (see its description below).
1266 # There is are three special values for <vcs-string>: The first is named
1267 # 'init', that is in effect as long as there was no decision what vcs
1268 # backend to use. The second is 'preinit; it is used *before* vcs_info()
1269 # is run, when initializing the data exporting variables. The third
1270 # special value is 'formats' and is used by the 'vcs_info_lastmsg' for
1271 # looking up its styles.
1273 # There are two pre-defined values for <user-context>:
1274 # default - the one used if none is specified
1275 # command - used by vcs_info_lastmsg to lookup its styles.
1277 # You may *not* use 'print_systems_' as a user-context string, because it
1278 # is used internally.
1280 # You can of course use ':vcs_info:*' to match all VCSs in all
1281 # user-contexts at once.
1283 # Another special context is 'formats', which is used by the
1284 # vcs_info_lastmsg() utility function (see below).
1287 # This is a description of all styles, that are looked up:
1288 # formats - A list of formats, used when actionformats is not
1289 # used (which is most of the time).
1290 # actionformats - A list of formats, used if a there is a special
1291 # action going on in your current repository;
1292 # (like an interactive rebase or a merge conflict)
1293 # branchformat - Some backends replace %b in the formats and
1294 # actionformats styles above, not only by a branch
1295 # name but also by a revision number. This style
1296 # let's you modify how that string should look like.
1297 # nvcsformats - These "formats" are exported, when we didn't detect
1298 # a version control system for the current directory.
1299 # This is useful, if you want vcs_info() to completely
1300 # take over the generation of your prompt.
1301 # You would do something like
1302 # PS1='${VCS_INFO_message_0_}'
1303 # to accomplish that.
1304 # max-exports - Defines the maximum number if VCS_INFO_message_*_
1305 # variables vcs_info() will export.
1306 # enable - Checked in the 'init' context. If set to false,
1307 # vcs_info() will do nothing.
1308 # disable - Provide a list of systems, you don't want
1309 # the vcs_info() to check for repositories
1310 # (checked in the 'init' context, too).
1311 # disable-patterns - A list of patterns that are checked against $PWD.
1312 # If the pattern matches, vcs_info will be disabled.
1313 # Say, ~/.zsh is a directory under version control,
1314 # in which you do not want vcs_info to be active, do:
1315 # zstyle ':vcs_info:*' disable-patterns "$HOME/.zsh+(|/*)"
1316 # use-simple - If there are two different ways of gathering
1317 # information, you can select the simpler one
1318 # by setting this style to true; the default
1319 # is to use the not-that-simple code, which is
1320 # potentially a lot slower but might be more
1321 # accurate in all possible cases.
1322 # use-prompt-escapes - determines if we assume that the assembled
1323 # string from vcs_info() includes prompt escapes.
1324 # (Used by vcs_info_lastmsg().
1326 # The use-simple style is only available for the bzr backend.
1328 # The default values for these in all contexts are:
1329 # formats " (%s)-[%b|%a]-"
1330 # actionformats " (%s)-[%b]-"
1331 # branchformat "%b:%r" (for bzr, svn and svk)
1335 # disable (empty list)
1336 # disable-patterns (empty list)
1338 # use-prompt-escapes true
1341 # In normal formats and actionformats, the following replacements
1343 # %s - The vcs in use (git, hg, svn etc.)
1344 # %b - Information about the current branch.
1345 # %a - An identifier, that describes the action.
1346 # Only makes sense in actionformats.
1347 # %R - base directory of the repository.
1348 # %r - repository name
1349 # If %R is '/foo/bar/repoXY', %r is 'repoXY'.
1350 # %S - subdirectory within a repository. if $PWD is
1351 # '/foo/bar/reposXY/beer/tasty', %S is 'beer/tasty'.
1354 # In branchformat these replacements are done:
1355 # %b - the branch name
1356 # %r - the current revision number
1358 # Not all vcs backends have to support all replacements.
1359 # nvcsformat does not perform *any* replacements. It is just a string.
1364 # If you want to use the %b (bold off) prompt expansion in 'formats', which
1365 # expands %b itself, use %%b. That will cause the vcs_info() expansion to
1366 # replace %%b with %b. So zsh's prompt expansion mechanism can handle it.
1367 # Similarly, to hand down %b from branchformat, use %%%%b. Sorry for this
1368 # inconvenience, but it cannot be easily avoided. Luckily we do not clash
1369 # with a lot of prompt expansions and this only needs to be done for those.
1370 # See 'man zshmisc' for details about EXPANSION OF PROMPT SEQUENCES.
1373 # FUNCTION DESCRIPTIONS (public API):
1376 # The main function, that runs all backends and assembles
1377 # all data into ${VCS_INFO_message_*_}. This is the function
1378 # you want to call from precmd() if you want to include
1379 # up-to-date information in your prompt (see VARIABLE
1380 # DESCRIPTION below).
1382 # vcs_info_printsys()
1383 # Prints a list of all supported version control systems.
1384 # Useful to find out possible contexts (and which of them are enabled)
1385 # or values for the 'disable' style.
1387 # vcs_info_lastmsg()
1388 # Outputs the last ${VCS_INFO_message_*_} value. Takes into account
1389 # the value of the use-prompt-escapes style in ':vcs_info:formats'.
1390 # It also only prints max-exports values.
1392 # All functions named VCS_INFO_* are for internal use only.
1395 # VARIABLE DESCRIPTION:
1397 # ${VCS_INFO_message_N_} (Note the trailing underscore)
1398 # Where 'N' is an integer, eg: VCS_INFO_message_0_
1399 # These variables are the storage for the informational message the
1400 # last vcs_info() call has assembled. These are strongly connected
1401 # to the formats, actionformats and nvcsformats styles described
1402 # above. Those styles are lists. the first member of that list gets
1403 # expanded into ${VCS_INFO_message_0_}, the second into
1404 # ${VCS_INFO_message_1_} and the Nth into ${VCS_INFO_message_N-1_}.
1405 # These parameters are exported into the environment.
1406 # (See the max-exports style above.)
1411 # Don't use vcs_info at all (even though it's in your prompt):
1412 # % zstyle ':vcs_info:*' enable false
1414 # Disable the backends for bzr and svk:
1415 # % zstyle ':vcs_info:*' disable bzr svk
1417 # Provide a special formats for git:
1418 # % zstyle ':vcs_info:git:*' formats ' GIT, BABY! [%b]'
1419 # % zstyle ':vcs_info:git:*' actionformats ' GIT ACTION! [%b|%a]'
1421 # Use the quicker bzr backend (if you do, please report if it does
1422 # the-right-thing[tm] - thanks):
1423 # % zstyle ':vcs_info:bzr:*' use-simple true
1425 # Display the revision number in yellow for bzr and svn:
1426 # % zstyle ':vcs_info:(svn|bzr):*' branchformat '%b%{'${fg[yellow]}'%}:%r'
1428 # If you want colors, make sure you enclose the color codes in %{...%},
1429 # if you want to use the string provided by vcs_info() in prompts.
1431 # Here is how to print the vcs infomation as a command:
1432 # % alias vcsi='vcs_info command; vcs_info_lastmsg'
1434 # This way, you can even define different formats for output via
1435 # vcs_info_lastmsg() in the ':vcs_info:command:*' namespace.
1439 VCS_INFO_adjust () { #{{{
1440 [[ -n ${vcs_comm[overwrite_name]} ]] && vcs=${vcs_comm[overwrite_name]}
1444 VCS_INFO_check_com () { #{{{
1445 (( ${+commands[$1]} )) && [[ -x ${commands[$1]} ]] && return 0
1449 VCS_INFO_formats () { # {{{
1450 setopt localoptions noksharrays
1451 local action=$1 branch=$2 base=$3
1455 if [[ -n ${action} ]] ; then
1456 zstyle -a ":vcs_info:${vcs}:${usercontext}" actionformats msgs
1457 (( ${#msgs} < 1 )) && msgs[1]=' (%s)-[%b|%a]-'
1459 zstyle -a ":vcs_info:${vcs}:${usercontext}" formats msgs
1460 (( ${#msgs} < 1 )) && msgs[1]=' (%s)-[%b]-'
1463 (( ${#msgs} > maxexports )) && msgs[$(( maxexports + 1 )),-1]=()
1464 for i in {1..${#msgs}} ; do
1465 zformat -f msg ${msgs[$i]} \
1471 S:"$(VCS_INFO_reposub ${base})"
1477 VCS_INFO_maxexports () { #{{{
1478 zstyle -s ":vcs_info:${vcs}:${usercontext}" "max-exports" maxexports || maxexports=2
1479 if [[ ${maxexports} != <-> ]] || (( maxexports < 1 )); then
1480 printf 'vcs_info(): expecting numeric arg >= 1 for max-exports (got %s).\n' ${maxexports}
1481 printf 'Defaulting to 2.\n'
1486 VCS_INFO_nvcsformats () { #{{{
1487 setopt localoptions noksharrays
1490 if [[ $1 == 'preinit' ]] ; then
1494 zstyle -a ":vcs_info:${v:-$vcs}:${c:-$usercontext}" nvcsformats msgs
1495 (( ${#msgs} > maxexports )) && msgs[${maxexports},-1]=()
1498 VCS_INFO_realpath () { #{{{
1499 # a portable 'readlink -f'
1500 # forcing a subshell, to ensure chpwd() is not removed
1501 # from the calling shell (if VCS_INFO_realpath() is called
1504 (( ${+functions[chpwd]} )) && unfunction chpwd
1506 cd $1 2>/dev/null && pwd
1510 VCS_INFO_reposub () { #{{{
1511 setopt localoptions extendedglob
1512 local base=${1%%/##}
1514 [[ ${PWD} == ${base}/* ]] || {
1518 printf '%s' ${PWD#$base/}
1522 VCS_INFO_set () { #{{{
1523 setopt localoptions noksharrays
1526 if [[ $1 == '--clear' ]] ; then
1527 for i in {0..9} ; do
1528 unset VCS_INFO_message_${i}_
1531 if [[ $1 == '--nvcs' ]] ; then
1532 [[ $2 == 'preinit' ]] && (( maxexports == 0 )) && (( maxexports = 1 ))
1533 for i in {0..$((maxexports - 1))} ; do
1534 typeset -gx VCS_INFO_message_${i}_=
1536 VCS_INFO_nvcsformats $2
1539 (( ${#msgs} - 1 < 0 )) && return 0
1540 for i in {0..$(( ${#msgs} - 1 ))} ; do
1542 typeset -gx VCS_INFO_message_${i}_=${msgs[$j]}
1547 # information gathering
1548 VCS_INFO_bzr_get_data () { # {{{
1549 setopt localoptions noksharrays
1553 if zstyle -t ":vcs_info:${vcs}:${usercontext}" "use-simple" ; then
1554 bzrbase=${vcs_comm[basedir]}
1555 bzrinfo[2]=${bzrbase:t}
1556 if [[ -f ${bzrbase}/.bzr/branch/last-revision ]] ; then
1557 bzrinfo[1]=$(< ${bzrbase}/.bzr/branch/last-revision)
1558 bzrinfo[1]=${${bzrinfo[1]}%% *}
1561 bzrbase=${${(M)${(f)"$( bzr info )"}:# ##branch\ root:*}/*: ##/}
1562 bzrinfo=( ${${${(M)${(f)"$( bzr version-info )"}:#(#s)(revno|branch-nick)*}/*: /}/*\//} )
1563 bzrbase="$(VCS_INFO_realpath ${bzrbase})"
1566 zstyle -s ":vcs_info:${vcs}:${usercontext}" branchformat bzrbr || bzrbr="%b:%r"
1567 zformat -f bzrbr "${bzrbr}" "b:${bzrinfo[2]}" "r:${bzrinfo[1]}"
1568 VCS_INFO_formats '' "${bzrbr}" "${bzrbase}"
1572 VCS_INFO_cdv_get_data () { # {{{
1575 cdvbase=${vcs_comm[basedir]}
1576 VCS_INFO_formats '' "${cdvbase:t}" "${cdvbase}"
1580 VCS_INFO_cvs_get_data () { # {{{
1581 local cvsbranch cvsbase basename
1584 while [[ -d "${cvsbase}/../CVS" ]]; do
1585 cvsbase="${cvsbase}/.."
1587 cvsbase="$(VCS_INFO_realpath ${cvsbase})"
1588 cvsbranch=$(< ./CVS/Repository)
1589 basename=${cvsbase:t}
1590 cvsbranch=${cvsbranch##${basename}/}
1591 [[ -z ${cvsbranch} ]] && cvsbranch=${basename}
1592 VCS_INFO_formats '' "${cvsbranch}" "${cvsbase}"
1596 VCS_INFO_darcs_get_data () { # {{{
1599 darcsbase=${vcs_comm[basedir]}
1600 VCS_INFO_formats '' "${darcsbase:t}" "${darcsbase}"
1604 VCS_INFO_git_getaction () { #{{{
1605 local gitaction='' gitdir=$1
1608 for tmp in "${gitdir}/rebase-apply" \
1609 "${gitdir}/rebase" \
1610 "${gitdir}/../.dotest" ; do
1611 if [[ -d ${tmp} ]] ; then
1612 if [[ -f "${tmp}/rebasing" ]] ; then
1614 elif [[ -f "${tmp}/applying" ]] ; then
1617 gitaction="am/rebase"
1619 printf '%s' ${gitaction}
1624 for tmp in "${gitdir}/rebase-merge/interactive" \
1625 "${gitdir}/.dotest-merge/interactive" ; do
1626 if [[ -f "${tmp}" ]] ; then
1627 printf '%s' "rebase-i"
1632 for tmp in "${gitdir}/rebase-merge" \
1633 "${gitdir}/.dotest-merge" ; do
1634 if [[ -d "${tmp}" ]] ; then
1635 printf '%s' "rebase-m"
1640 if [[ -f "${gitdir}/MERGE_HEAD" ]] ; then
1645 if [[ -f "${gitdir}/BISECT_LOG" ]] ; then
1646 printf '%s' "bisect"
1652 VCS_INFO_git_getbranch () { #{{{
1653 local gitbranch gitdir=$1 tmp actiondir
1654 local gitsymref='git symbolic-ref HEAD'
1657 for tmp in "${gitdir}/rebase-apply" \
1658 "${gitdir}/rebase" \
1659 "${gitdir}/../.dotest"; do
1660 if [[ -d ${tmp} ]]; then
1665 if [[ -n ${actiondir} ]]; then
1666 gitbranch="$(${(z)gitsymref} 2> /dev/null)"
1667 [[ -z ${gitbranch} ]] && [[ -r ${actiondir}/head-name ]] \
1668 && gitbranch="$(< ${actiondir}/head-name)"
1670 elif [[ -f "${gitdir}/MERGE_HEAD" ]] ; then
1671 gitbranch="$(${(z)gitsymref} 2> /dev/null)"
1672 [[ -z ${gitbranch} ]] && gitbranch="$(< ${gitdir}/MERGE_HEAD)"
1674 elif [[ -d "${gitdir}/rebase-merge" ]] ; then
1675 gitbranch="$(< ${gitdir}/rebase-merge/head-name)"
1677 elif [[ -d "${gitdir}/.dotest-merge" ]] ; then
1678 gitbranch="$(< ${gitdir}/.dotest-merge/head-name)"
1681 gitbranch="$(${(z)gitsymref} 2> /dev/null)"
1683 if [[ $? -ne 0 ]] ; then
1684 gitbranch="refs/tags/$(git describe --exact-match HEAD 2>/dev/null)"
1686 if [[ $? -ne 0 ]] ; then
1687 gitbranch="${${"$(< $gitdir/HEAD)"}[1,7]}..."
1692 printf '%s' "${gitbranch##refs/[^/]##/}"
1696 VCS_INFO_git_get_data () { # {{{
1697 setopt localoptions extendedglob
1698 local gitdir gitbase gitbranch gitaction
1700 gitdir=${vcs_comm[gitdir]}
1701 gitbranch="$(VCS_INFO_git_getbranch ${gitdir})"
1703 if [[ -z ${gitdir} ]] || [[ -z ${gitbranch} ]] ; then
1708 gitaction="$(VCS_INFO_git_getaction ${gitdir})"
1709 gitbase=${PWD%/${$( git rev-parse --show-prefix )%/##}}
1710 VCS_INFO_formats "${gitaction}" "${gitbranch}" "${gitbase}"
1714 VCS_INFO_hg_get_data () { # {{{
1715 local hgbranch hgbase file
1717 hgbase=${vcs_comm[basedir]}
1719 file="${hgbase}/.hg/branch"
1720 if [[ -r ${file} ]] ; then
1721 hgbranch=$(< ${file})
1726 VCS_INFO_formats '' "${hgbranch}" "${hgbase}"
1730 VCS_INFO_mtn_get_data () { # {{{
1731 local mtnbranch mtnbase
1733 mtnbase=${vcs_comm[basedir]}
1734 mtnbranch=${${(M)${(f)"$( mtn status )"}:#(#s)Current branch:*}/*: /}
1735 VCS_INFO_formats '' "${mtnbranch}" "${mtnbase}"
1739 VCS_INFO_svk_get_data () { # {{{
1740 local svkbranch svkbase
1742 svkbase=${vcs_comm[basedir]}
1743 zstyle -s ":vcs_info:${vcs}:${usercontext}" branchformat svkbranch || svkbranch="%b:%r"
1744 zformat -f svkbranch "${svkbranch}" "b:${vcs_comm[branch]}" "r:${vcs_comm[revision]}"
1745 VCS_INFO_formats '' "${svkbranch}" "${svkbase}"
1749 VCS_INFO_svn_get_data () { # {{{
1750 setopt localoptions noksharrays
1751 local svnbase svnbranch
1755 while [[ -d "${svnbase}/../.svn" ]]; do
1756 svnbase="${svnbase}/.."
1758 svnbase="$(VCS_INFO_realpath ${svnbase})"
1759 svninfo=( ${${${(M)${(f)"$( svn info )"}:#(#s)(URL|Revision)*}/*: /}/*\//} )
1761 zstyle -s ":vcs_info:${vcs}:${usercontext}" branchformat svnbranch || svnbranch="%b:%r"
1762 zformat -f svnbranch "${svnbranch}" "b:${svninfo[1]}" "r:${svninfo[2]}"
1763 VCS_INFO_formats '' "${svnbranch}" "${svnbase}"
1767 VCS_INFO_tla_get_data () { # {{{
1768 local tlabase tlabranch
1770 tlabase="$(VCS_INFO_realpath ${vcs_comm[basedir]})"
1771 # tree-id gives us something like 'foo@example.com/demo--1.0--patch-4', so:
1772 tlabranch=${${"$( tla tree-id )"}/*\//}
1773 VCS_INFO_formats '' "${tlabranch}" "${tlabase}"
1778 VCS_INFO_detect_by_dir() { #{{{
1780 local basedir="." realbasedir
1782 realbasedir="$(VCS_INFO_realpath ${basedir})"
1783 while [[ ${realbasedir} != '/' ]]; do
1784 [[ -r ${realbasedir} ]] || return 1
1785 if [[ -n ${vcs_comm[detect_need_file]} ]] ; then
1786 [[ -d ${basedir}/${dirname} ]] && \
1787 [[ -e ${basedir}/${dirname}/${vcs_comm[detect_need_file]} ]] && \
1790 [[ -d ${basedir}/${dirname} ]] && break
1793 basedir=${basedir}/..
1794 realbasedir="$(VCS_INFO_realpath ${basedir})"
1797 [[ ${realbasedir} == "/" ]] && return 1
1798 vcs_comm[basedir]=${realbasedir}
1802 VCS_INFO_bzr_detect() { #{{{
1803 VCS_INFO_check_com bzr || return 1
1804 vcs_comm[detect_need_file]=branch/format
1805 VCS_INFO_detect_by_dir '.bzr'
1809 VCS_INFO_cdv_detect() { #{{{
1810 VCS_INFO_check_com cdv || return 1
1811 vcs_comm[detect_need_file]=format
1812 VCS_INFO_detect_by_dir '.cdv'
1816 VCS_INFO_cvs_detect() { #{{{
1817 VCS_INFO_check_com cvs || return 1
1818 [[ -d "./CVS" ]] && [[ -r "./CVS/Repository" ]] && return 0
1822 VCS_INFO_darcs_detect() { #{{{
1823 VCS_INFO_check_com darcs || return 1
1824 vcs_comm[detect_need_file]=format
1825 VCS_INFO_detect_by_dir '_darcs'
1829 VCS_INFO_git_detect() { #{{{
1830 if VCS_INFO_check_com git && git rev-parse --is-inside-work-tree &> /dev/null ; then
1831 vcs_comm[gitdir]="$(git rev-parse --git-dir 2> /dev/null)" || return 1
1832 if [[ -d ${vcs_comm[gitdir]}/svn ]] ; then vcs_comm[overwrite_name]='git-svn'
1833 elif [[ -d ${vcs_comm[gitdir]}/refs/remotes/p4 ]] ; then vcs_comm[overwrite_name]='git-p4' ; fi
1839 VCS_INFO_hg_detect() { #{{{
1840 VCS_INFO_check_com hg || return 1
1841 vcs_comm[detect_need_file]=store
1842 VCS_INFO_detect_by_dir '.hg'
1846 VCS_INFO_mtn_detect() { #{{{
1847 VCS_INFO_check_com mtn || return 1
1848 vcs_comm[detect_need_file]=revision
1849 VCS_INFO_detect_by_dir '_MTN'
1853 VCS_INFO_svk_detect() { #{{{
1854 setopt localoptions noksharrays extendedglob
1859 VCS_INFO_check_com svk || return 1
1860 [[ -f ~/.svk/config ]] || return 1
1862 # This detection function is a bit different from the others.
1863 # We need to read svk's config file to detect a svk repository
1864 # in the first place. Therefore, we'll just proceed and read
1865 # the other information, too. This is more then any of the
1866 # other detections do but this takes only one file open for
1867 # svk at most. VCS_INFO_svk_get_data() get simpler, too. :-)
1868 while IFS= read -r line ; do
1869 if [[ -n ${vcs_comm[basedir]} ]] ; then
1871 [[ ${line} == depotpath:* ]] && vcs_comm[branch]=${line##*/}
1872 [[ ${line} == revision:* ]] && vcs_comm[revision]=${line##*[[:space:]]##}
1873 [[ -n ${vcs_comm[branch]} ]] && [[ -n ${vcs_comm[revision]} ]] && break
1876 (( fhash > 0 )) && [[ ${line} == ' '[^[:space:]]*:* ]] && break
1877 [[ ${line} == ' hash:'* ]] && fhash=1 && continue
1878 (( fhash == 0 )) && continue
1879 [[ ${PWD}/ == ${${line## ##}%:*}/* ]] && vcs_comm[basedir]=${${line## ##}%:*}
1880 done < ~/.svk/config
1882 [[ -n ${vcs_comm[basedir]} ]] && \
1883 [[ -n ${vcs_comm[branch]} ]] && \
1884 [[ -n ${vcs_comm[revision]} ]] && return 0
1888 VCS_INFO_svn_detect() { #{{{
1889 VCS_INFO_check_com svn || return 1
1890 [[ -d ".svn" ]] && return 0
1894 VCS_INFO_tla_detect() { #{{{
1895 VCS_INFO_check_com tla || return 1
1896 vcs_comm[basedir]="$(tla tree-root 2> /dev/null)" && return 0
1901 vcs_info_printsys () { # {{{
1902 vcs_info print_systems_
1905 vcs_info_lastmsg () { # {{{
1910 for i in {0..$((maxexports - 1))} ; do
1911 printf '$VCS_INFO_message_%d_: "' $i
1912 if zstyle -T ':vcs_info:formats:command' use-prompt-escapes ; then
1913 print -nP ${(P)${:-VCS_INFO_message_${i}_}}
1915 print -n ${(P)${:-VCS_INFO_message_${i}_}}
1925 [[ -r . ]] || return 1
1929 local -a VCSs disabled dps
1930 local -x vcs usercontext
1931 local -ix maxexports
1936 VCSs=(git hg bzr darcs svk mtn svn cvs cdv tla)
1939 zstyle -a ":vcs_info:${vcs}:${usercontext}" "disable" disabled
1940 print -l '# list of supported version control backends:' \
1941 '# disabled systems are prefixed by a hash sign (#)'
1942 for vcs in ${VCSs} ; do
1943 [[ -n ${(M)disabled:#${vcs}} ]] && printf '#'
1944 printf '%s\n' ${vcs}
1946 print -l '# flavours (cannot be used in the disable style; they' \
1947 '# are disabled with their master [git-svn -> git]):' \
1952 [[ -z ${usercontext} ]] && usercontext=default
1954 (*) [[ -z ${usercontext} ]] && usercontext=$1
1958 zstyle -T ":vcs_info:${vcs}:${usercontext}" "enable" || {
1959 [[ -n ${VCS_INFO_message_0_} ]] && VCS_INFO_set --clear
1962 zstyle -a ":vcs_info:${vcs}:${usercontext}" "disable" disabled
1964 zstyle -a ":vcs_info:${vcs}:${usercontext}" "disable-patterns" dps
1965 for pat in ${dps} ; do
1966 if [[ ${PWD} == ${~pat} ]] ; then
1967 [[ -n ${vcs_info_msg_0_} ]] && VCS_INFO_set --clear
1975 for vcs in ${VCSs} ; do
1976 [[ -n ${(M)disabled:#${vcs}} ]] && continue
1978 VCS_INFO_${vcs}_detect && (( found = 1 )) && break
1981 (( found == 0 )) && {
1986 VCS_INFO_${vcs}_get_data || {
1995 VCS_INFO_set --nvcs preinit
2000 # Change vcs_info formats for the grml prompt. The 2nd format sets up
2001 # $vcs_info_msg_1_ to contain "zsh: repo-name" used to set our screen title.
2002 # TODO: The included vcs_info() version still uses $VCS_INFO_message_N_.
2003 # That needs to be the use of $VCS_INFO_message_N_ needs to be changed
2004 # to $vcs_info_msg_N_ as soon as we use the included version.
2005 if [[ "$TERM" == dumb ]] ; then
2006 zstyle ':vcs_info:*' actionformats "(%s%)-[%b|%a] " "zsh: %r"
2007 zstyle ':vcs_info:*' formats "(%s%)-[%b] " "zsh: %r"
2009 # these are the same, just with a lot of colours:
2010 zstyle ':vcs_info:*' actionformats "${MAGENTA}(${NO_COLOUR}%s${MAGENTA})${YELLOW}-${MAGENTA}[${GREEN}%b${YELLOW}|${RED}%a${MAGENTA}]${NO_COLOUR} " \
2012 zstyle ':vcs_info:*' formats "${MAGENTA}(${NO_COLOUR}%s${MAGENTA})${YELLOW}-${MAGENTA}[${GREEN}%b${MAGENTA}]${NO_COLOUR}%} " \
2014 zstyle ':vcs_info:(sv[nk]|bzr):*' branchformat "%b${RED}:${YELLOW}%r"
2017 if [[ -o restricted ]]; then
2018 zstyle ':vcs_info:*' enable false
2023 # command not found handling {{{
2025 (( ${COMMAND_NOT_FOUND} == 1 )) &&
2026 function command_not_found_handler() {
2028 if [[ -x ${GRML_ZSH_CNF_HANDLER} ]] ; then
2029 ${GRML_ZSH_CNF_HANDLER} $1
2037 if zrcautoload promptinit && promptinit 2>/dev/null ; then
2038 promptinit # people should be able to use their favourite prompt
2040 print 'Notice: no promptinit available :('
2045 # make sure to use right prompt only when not running a command
2046 is41 && setopt transient_rprompt
2049 function ESC_print () {
2050 info_print $'\ek' $'\e\\' "$@"
2052 function set_title () {
2053 info_print $'\e]0;' $'\a' "$@"
2056 function info_print () {
2057 local esc_begin esc_end
2061 printf '%s' ${esc_begin}
2063 printf '%s' "${esc_end}"
2066 # TODO: revise all these NO* variables and especially their documentation
2067 # in zsh-help() below.
2068 is4 && [[ $NOPRECMD -eq 0 ]] && precmd () {
2069 [[ $NOPRECMD -gt 0 ]] && return 0
2070 # update VCS information
2073 if [[ $TERM == screen* ]] ; then
2074 if [[ -n ${VCS_INFO_message_1_} ]] ; then
2075 ESC_print ${VCS_INFO_message_1_}
2076 elif [[ -n ${vcs_info_msg_1_} ]] ; then
2077 ESC_print ${vcs_info_msg_1_}
2082 # just use DONTSETRPROMPT=1 to be able to overwrite RPROMPT
2083 if [[ $DONTSETRPROMPT -eq 0 ]] ; then
2084 if [[ $BATTERY -gt 0 ]] ; then
2085 # update battery (dropped into $PERCENT) information
2087 RPROMPT="%(?..:() ${PERCENT}"
2092 # adjust title of xterm
2093 # see http://www.faqs.org/docs/Linux-mini/Xterm-Title.html
2094 [[ ${NOTITLE} -gt 0 ]] && return 0
2097 set_title ${(%):-"%n@%m: %~"}
2102 # preexec() => a function running before every command
2103 is4 && [[ $NOPRECMD -eq 0 ]] && \
2105 [[ $NOPRECMD -gt 0 ]] && return 0
2106 # set hostname if not running on host with name 'grml'
2107 if [[ -n "$HOSTNAME" ]] && [[ "$HOSTNAME" != $(hostname) ]] ; then
2110 # get the name of the program currently running and hostname of local machine
2111 # set screen window title if running in a screen
2112 if [[ "$TERM" == screen* ]] ; then
2113 # local CMD=${1[(wr)^(*=*|sudo|ssh|-*)]} # don't use hostname
2114 local CMD="${1[(wr)^(*=*|sudo|ssh|-*)]}$NAME" # use hostname
2117 # adjust title of xterm
2118 [[ ${NOTITLE} -gt 0 ]] && return 0
2121 set_title "${(%):-"%n@%m:"}" "$1"
2126 EXITCODE="%(?..%?%1v )"
2127 PS2='\`%_> ' # secondary prompt, printed when the shell needs more information to complete a command.
2128 PS3='?# ' # selection prompt used within a select loop.
2129 PS4='+%N:%i:%_> ' # the execution trace prompt (setopt xtrace). default: '+%N:%i>'
2131 # set variable debian_chroot if running in a chroot with /etc/debian_chroot
2132 if [[ -z "$debian_chroot" ]] && [[ -r /etc/debian_chroot ]] ; then
2133 debian_chroot=$(cat /etc/debian_chroot)
2136 # don't use colors on dumb terminals (like emacs):
2137 if [[ "$TERM" == dumb ]] ; then
2138 PROMPT="${EXITCODE}${debian_chroot:+($debian_chroot)}%n@%m %40<...<%B%~%b%<< "
2140 # only if $GRMLPROMPT is set (e.g. via 'GRMLPROMPT=1 zsh') use the extended prompt
2141 # set variable identifying the chroot you work in (used in the prompt below)
2142 if [[ $GRMLPROMPT -gt 0 ]] ; then
2143 PROMPT="${RED}${EXITCODE}${CYAN}[%j running job(s)] ${GREEN}{history#%!} ${RED}%(3L.+.) ${BLUE}%* %D
2144 ${BLUE}%n${NO_COLOUR}@%m %40<...<%B%~%b%<< "
2146 # This assembles the primary prompt string
2147 if (( EUID != 0 )); then
2148 PROMPT="${RED}${EXITCODE}${WHITE}${debian_chroot:+($debian_chroot)}${BLUE}%n${NO_COLOUR}@%m %40<...<%B%~%b%<< "
2150 PROMPT="${BLUE}${EXITCODE}${WHITE}${debian_chroot:+($debian_chroot)}${RED}%n${NO_COLOUR}@%m %40<...<%B%~%b%<< "
2155 if (( GRML_VCS_INFO )); then
2156 PROMPT="${PROMPT}"'${VCS_INFO_message_0_}'"%# "
2158 PROMPT="${PROMPT}"'${vcs_info_msg_0_}'"%# "
2161 # if we are inside a grml-chroot set a specific prompt theme
2162 if [[ -n "$GRML_CHROOT" ]] ; then
2163 PROMPT="%{$fg[red]%}(CHROOT) %{$fg_bold[red]%}%n%{$fg_no_bold[white]%}@%m %40<...<%B%~%b%<< %\# "
2167 # {{{ 'hash' some often used directories
2169 hash -d deb=/var/cache/apt/archives
2170 hash -d doc=/usr/share/doc
2171 hash -d linux=/lib/modules/$(command uname -r)/build/
2172 hash -d log=/var/log
2173 hash -d slog=/var/log/syslog
2174 hash -d src=/usr/src
2175 hash -d templ=/usr/share/doc/grml-templates
2176 hash -d tt=/usr/share/doc/texttools-doc
2177 hash -d www=/var/www
2182 if check_com -c screen ; then
2183 if [[ $UID -eq 0 ]] ; then
2184 [[ -r /etc/grml/screenrc ]] && alias screen="${commands[screen]} -c /etc/grml/screenrc"
2185 elif [[ -r $HOME/.screenrc ]] ; then
2186 alias screen="${commands[screen]} -c $HOME/.screenrc"
2188 if [[ -r /etc/grml/screenrc_grml ]]; then
2189 alias screen="${commands[screen]} -c /etc/grml/screenrc_grml"
2191 [[ -r /etc/grml/screenrc ]] && alias screen="${commands[screen]} -c /etc/grml/screenrc"
2196 # do we have GNU ls with color-support?
2197 if ls --help 2>/dev/null | grep -- --color= >/dev/null && [[ "$TERM" != dumb ]] ; then
2198 #a1# execute \kbd{@a@}:\quad ls with colors
2199 alias ls='ls -b -CF --color=auto'
2200 #a1# execute \kbd{@a@}:\quad list all files, with colors
2201 alias la='ls -la --color=auto'
2202 #a1# long colored list, without dotfiles (@a@)
2203 alias ll='ls -l --color=auto'
2204 #a1# long colored list, human readable sizes (@a@)
2205 alias lh='ls -hAl --color=auto'
2206 #a1# List files, append qualifier to filenames \\&\quad(\kbd{/} for directories, \kbd{@} for symlinks ...)
2207 alias l='ls -lF --color=auto'
2209 alias ls='ls -b -CF'
2216 alias mdstat='cat /proc/mdstat'
2217 alias ...='cd ../../'
2219 # generate alias named "$KERNELVERSION-reboot" so you can use boot with kexec:
2220 if [[ -x /sbin/kexec ]] && [[ -r /proc/cmdline ]] ; then
2221 alias "$(uname -r)-reboot"="kexec -l --initrd=/boot/initrd.img-"$(uname -r)" --command-line=\"$(cat /proc/cmdline)\" /boot/vmlinuz-"$(uname -r)""
2224 alias cp='nocorrect cp' # no spelling correction on cp
2225 alias mkdir='nocorrect mkdir' # no spelling correction on mkdir
2226 alias mv='nocorrect mv' # no spelling correction on mv
2227 alias rm='nocorrect rm' # no spelling correction on rm
2229 #a1# Execute \kbd{rmdir}
2231 #a1# Execute \kbd{mkdir}
2234 # see http://www.cl.cam.ac.uk/~mgk25/unicode.html#term for details
2235 alias term2iso="echo 'Setting terminal to iso mode' ; print -n '\e%@'"
2236 alias term2utf="echo 'Setting terminal to utf-8 mode'; print -n '\e%G'"
2238 # make sure it is not assigned yet
2239 [[ -n ${aliases[utf2iso]} ]] && unalias utf2iso
2242 for ENV in $(env | command grep -i '.utf') ; do
2243 eval export "$(echo $ENV | sed 's/UTF-8/iso885915/ ; s/utf8/iso885915/')"
2248 # make sure it is not assigned yet
2249 [[ -n ${aliases[iso2utf]} ]] && unalias iso2utf
2251 if ! isutfenv ; then
2252 for ENV in $(env | command grep -i '\.iso') ; do
2253 eval export "$(echo $ENV | sed 's/iso.*/UTF-8/ ; s/ISO.*/UTF-8/')"
2258 # set up software synthesizer via speakup
2260 if [ -x /usr/sbin/swspeak-setup ] ; then
2261 setopt singlelinezle
2264 /usr/sbin/swspeak-setup $@
2266 if ! [[ -r /dev/softsynth ]] ; then
2267 flite -o play -t "Sorry, software synthesizer not available. Did you boot with swspeak bootoption?"
2270 setopt singlelinezle
2273 nice -n -20 speechd-up
2275 flite -o play -t "Finished setting up software synthesizer"
2280 # I like clean prompt, so provide simple way to get that
2281 check_com 0 || alias 0='return 0'
2283 # for really lazy people like mika:
2284 check_com S &>/dev/null || alias S='screen'
2285 check_com s &>/dev/null || alias s='ssh'
2287 # especially for roadwarriors using GNU screen and ssh:
2288 if ! check_com asc &>/dev/null ; then
2289 asc() { autossh -t "$@" 'screen -RdU' }
2293 # get top 10 shell commands:
2294 alias top10='print -l ? ${(o)history%% *} | uniq -c | sort -nr | head -n 10'
2296 # truecrypt; use e.g. via 'truec /dev/ice /mnt/ice' or 'truec -i'
2297 if check_com -c truecrypt ; then
2299 alias truec='truecrypt --mount-options "rw,sync,dirsync,users,uid=1000,gid=users,umask=077,utf8" '
2301 alias truec='truecrypt --mount-options "rw,sync,dirsync,users,uid=1000,gid=users,umask=077" '
2305 #f1# Hints for the use of zsh on grml
2307 print "$bg[white]$fg[black]
2308 zsh-help - hints for use of zsh on grml
2309 =======================================$reset_color"
2312 Main configuration of zsh happens in /etc/zsh/zshrc.
2313 That file is part of the package grml-etc-core, if you want to
2314 use them on a non-grml-system just get the tar.gz from
2315 http://deb.grml.org/ or (preferably) get it from the git repository:
2317 http://git.grml.org/f/grml-etc-core/etc/zsh/zshrc
2319 This version of grml'\''s zsh setup does not use skel/.zshrc anymore.
2320 The file is still there, but it is empty for backwards compatibility.
2322 For your own changes use these two files:
2326 The former is sourced very early in our zshrc, the latter is sourced
2329 System wide configuration without touching configuration files of grml
2330 can take place in /etc/zsh/zshrc.local.
2332 Normally, the root user (EUID == 0) does not get the whole grml setup.
2333 If you want to force the whole setup for that user, too, set
2334 GRML_ALWAYS_LOAD_ALL=1 in .zshrc.pre in root'\''s home directory.
2336 For information regarding zsh start at http://grml.org/zsh/
2338 Take a look at grml'\''s zsh refcard:
2339 % xpdf =(zcat /usr/share/doc/grml-docs/zsh/grml-zsh-refcard.pdf.gz)
2341 Check out the main zsh refcard:
2342 % '$BROWSER' http://www.bash2zsh.com/zsh_refcard/refcard.pdf
2344 And of course visit the zsh-lovers:
2347 You can adjust some options through environment variables when
2348 invoking zsh without having to edit configuration files.
2349 Basically meant for bash users who are not used to the power of
2352 "NOCOR=1 zsh" => deactivate automatic correction
2353 "NOMENU=1 zsh" => do not use auto menu completion (note: use ctrl-d for completion instead!)
2354 "NOPRECMD=1 zsh" => disable the precmd + preexec commands (set GNU screen title)
2355 "NOTITLE=1 zsh" => disable setting the title of xterms without disabling
2356 preexec() and precmd() completely
2357 "BATTERY=1 zsh" => activate battery status (via acpi) on right side of prompt
2358 "COMMAND_NOT_FOUND=1 zsh"
2359 => Enable a handler if an external command was not found
2360 The command called in the handler can be altered by setting
2361 the GRML_ZSH_CNF_HANDLER variable, the default is:
2362 "/usr/share/command-not-found/command-not-found"
2364 A value greater than 0 is enables a feature; a value equal to zero
2365 disables it. If you like one or the other of these settings, you can
2366 add them to ~/.zshrc.pre to ensure they are set when sourcing grml'\''s
2370 $bg[white]$fg[black]
2371 Please report wishes + bugs to the grml-team: http://grml.org/bugs/
2372 Enjoy your grml system with the zsh!$reset_color"
2376 if [[ -r /etc/debian_version ]] ; then
2377 #a3# Execute \kbd{apt-cache search}
2378 alias acs='apt-cache search'
2379 #a3# Execute \kbd{apt-cache show}
2380 alias acsh='apt-cache show'
2381 #a3# Execute \kbd{apt-cache policy}
2382 alias acp='apt-cache policy'
2383 #a3# Execute \kbd{apt-get dist-upgrade}
2384 salias adg="apt-get dist-upgrade"
2385 #a3# Execute \kbd{apt-get install}
2386 salias agi="apt-get install"
2387 #a3# Execute \kbd{aptitude install}
2388 salias ati="aptitude install"
2389 #a3# Execute \kbd{apt-get upgrade}
2390 salias ag="apt-get upgrade"
2391 #a3# Execute \kbd{apt-get update}
2392 salias au="apt-get update"
2393 #a3# Execute \kbd{aptitude update ; aptitude safe-upgrade}
2394 salias -a up="aptitude update ; aptitude safe-upgrade"
2395 #a3# Execute \kbd{dpkg-buildpackage}
2396 alias dbp='dpkg-buildpackage'
2397 #a3# Execute \kbd{grep-excuses}
2398 alias ge='grep-excuses'
2401 #f3# Execute \kbd{apt-get update \&\& }\\&\quad \kbd{apt-get dist-upgrade}
2404 if [[ -z $1 ]] ; then
2405 $SUDO apt-get update
2406 $SUDO apt-get -u upgrade
2408 ssh $1 $SUDO apt-get update
2409 # ask before the upgrade
2411 ssh $1 $SUDO apt-get --no-act upgrade
2412 echo -n 'Process the upgrade?'
2414 if [[ $dummy == "y" ]] ; then
2415 ssh $1 $SUDO apt-get -u upgrade --yes
2420 # get a root shell as normal user in live-cd mode:
2421 if isgrmlcd && [[ $UID -ne 0 ]] ; then
2425 #a1# Take a look at the syslog: \kbd{\$PAGER /var/log/syslog}
2426 salias llog="$PAGER /var/log/syslog" # take a look at the syslog
2427 #a1# Take a look at the syslog: \kbd{tail -f /var/log/syslog}
2428 salias tlog="tail -f /var/log/syslog" # follow the syslog
2431 # sort installed Debian-packages by size
2432 if check_com -c grep-status ; then
2433 #a3# List installed Debian-packages sorted by size
2434 alias debs-by-size='grep-status -FStatus -sInstalled-Size,Package -n "install ok installed" | paste -sd " \n" | sort -rn'
2437 # if cdrecord is a symlink (to wodim) or isn't present at all warn:
2438 if [[ -L /usr/bin/cdrecord ]] || ! check_com -c cdrecord; then
2439 if check_com -c wodim; then
2442 cdrecord is not provided under its original name by Debian anymore.
2443 See #377109 in the BTS of Debian for more details.
2445 Please use the wodim binary instead
2452 # get_tw_cli has been renamed into get_3ware
2453 if check_com -c get_3ware ; then
2455 echo 'Warning: get_tw_cli has been renamed into get_3ware. Invoking get_3ware for you.'>&2
2460 # I hate lacking backward compatibility, so provide an alternative therefore
2461 if ! check_com -c apache2-ssl-certificate ; then
2463 apache2-ssl-certificate() {
2465 print 'Debian does not ship apache2-ssl-certificate anymore (see #398520). :('
2466 print 'You might want to take a look at Debian the package ssl-cert as well.'
2467 print 'To generate a certificate for use with apache2 follow the instructions:'
2471 export RANDFILE=/dev/random
2472 mkdir /etc/apache2/ssl/
2473 openssl req $@ -new -x509 -days 365 -nodes -out /etc/apache2/ssl/apache.pem -keyout /etc/apache2/ssl/apache.pem
2474 chmod 600 /etc/apache2/ssl/apache.pem
2476 Run "grml-tips ssl-certificate" if you need further instructions.
2482 # {{{ Use hard limits, except for a smaller stack and no core dumps
2484 is425 && limit stack 8192
2485 isgrmlcd && limit core 0 # important for a live-cd-system
2489 # {{{ completion system
2491 # called later (via is4 && grmlcomp)
2492 # note: use 'zstyle' for getting current settings
2493 # press ^Xh (control-x h) for getting tags in context; ^X? (control-x ?) to run complete_debug with trace output
2495 # TODO: This could use some additional information
2497 # allow one error for every three characters typed in approximate completer
2498 zstyle ':completion:*:approximate:' max-errors 'reply=( $((($#PREFIX+$#SUFFIX)/3 )) numeric )'
2500 # don't complete backup files as executables
2501 zstyle ':completion:*:complete:-command-::commands' ignored-patterns '(aptitude-*|*\~)'
2503 # start menu completion only if it could find no unambiguous initial string
2504 zstyle ':completion:*:correct:*' insert-unambiguous true
2505 zstyle ':completion:*:corrections' format $'%{\e[0;31m%}%d (errors: %e)%{\e[0m%}'
2506 zstyle ':completion:*:correct:*' original true
2508 # activate color-completion
2509 zstyle ':completion:*:default' list-colors ${(s.:.)LS_COLORS}
2511 # format on completion
2512 zstyle ':completion:*:descriptions' format $'%{\e[0;31m%}completing %B%d%b%{\e[0m%}'
2514 # automatically complete 'cd -<tab>' and 'cd -<ctrl-d>' with menu
2515 # zstyle ':completion:*:*:cd:*:directory-stack' menu yes select
2517 # insert all expansions for expand completer
2518 zstyle ':completion:*:expand:*' tag-order all-expansions
2519 zstyle ':completion:*:history-words' list false
2522 zstyle ':completion:*:history-words' menu yes
2524 # ignore duplicate entries
2525 zstyle ':completion:*:history-words' remove-all-dups yes
2526 zstyle ':completion:*:history-words' stop yes
2528 # match uppercase from lowercase
2529 zstyle ':completion:*' matcher-list 'm:{a-z}={A-Z}'
2531 # separate matches into groups
2532 zstyle ':completion:*:matches' group 'yes'
2533 zstyle ':completion:*' group-name ''
2535 if [[ "$NOMENU" -eq 0 ]] ; then
2536 # if there are more than 5 options allow selecting from a menu
2537 zstyle ':completion:*' menu select=5
2539 # don't use any menus at all
2543 zstyle ':completion:*:messages' format '%d'
2544 zstyle ':completion:*:options' auto-description '%d'
2546 # describe options in full
2547 zstyle ':completion:*:options' description 'yes'
2549 # on processes completion complete all user processes
2550 zstyle ':completion:*:processes' command 'ps -au$USER'
2552 # offer indexes before parameters in subscripts
2553 zstyle ':completion:*:*:-subscript-:*' tag-order indexes parameters
2555 # provide verbose completion information
2556 zstyle ':completion:*' verbose true
2558 # recent (as of Dec 2007) zsh versions are able to provide descriptions
2559 # for commands (read: 1st word in the line) that it will list for the user
2560 # to choose from. The following disables that, because it's not exactly fast.
2561 zstyle ':completion:*:-command-:*:' verbose false
2563 # set format for warnings
2564 zstyle ':completion:*:warnings' format $'%{\e[0;31m%}No matches for:%{\e[0m%} %d'
2566 # define files to ignore for zcompile
2567 zstyle ':completion:*:*:zcompile:*' ignored-patterns '(*~|*.zwc)'
2568 zstyle ':completion:correct:' prompt 'correct to: %e'
2570 # Ignore completion functions for commands you don't have:
2571 zstyle ':completion::(^approximate*):*:functions' ignored-patterns '_*'
2573 # Provide more processes in completion of programs like killall:
2574 zstyle ':completion:*:processes-names' command 'ps c -u ${USER} -o command | uniq'
2576 # complete manual by their section
2577 zstyle ':completion:*:manuals' separate-sections true
2578 zstyle ':completion:*:manuals.*' insert-sections true
2579 zstyle ':completion:*:man:*' menu yes select
2581 # provide .. as a completion
2582 zstyle ':completion:*' special-dirs ..
2584 # run rehash on completion so new installed program are found automatically:
2586 (( CURRENT == 1 )) && rehash
2591 # some people don't like the automatic correction - so run 'NOCOR=1 zsh' to deactivate it
2592 if [[ "$NOCOR" -gt 0 ]] ; then
2593 zstyle ':completion:*' completer _oldlist _expand _force_rehash _complete _files _ignored
2596 # try to be smart about when to use what completer...
2598 zstyle -e ':completion:*' completer '
2599 if [[ $_last_try != "$HISTNO$BUFFER$CURSOR" ]] ; then
2600 _last_try="$HISTNO$BUFFER$CURSOR"
2601 reply=(_complete _match _ignored _prefix _files)
2603 if [[ $words[1] == (rm|mv) ]] ; then
2604 reply=(_complete _files)
2606 reply=(_oldlist _expand _force_rehash _complete _ignored _correct _approximate _files)
2611 # command for process lists, the local web server details and host completion
2612 zstyle ':completion:*:urls' local 'www' '/var/www/' 'public_html'
2615 [[ -d $ZSHDIR/cache ]] && zstyle ':completion:*' use-cache yes && \
2616 zstyle ':completion::complete:*' cache-path $ZSHDIR/cache/
2618 # host completion /* add brackets as vim can't parse zsh's complex cmdlines 8-) {{{ */
2620 [[ -r ~/.ssh/known_hosts ]] && _ssh_hosts=(${${${${(f)"$(<$HOME/.ssh/known_hosts)"}:#[\|]*}%%\ *}%%,*}) || _ssh_hosts=()
2621 [[ -r /etc/hosts ]] && : ${(A)_etc_hosts:=${(s: :)${(ps:\t:)${${(f)~~"$(</etc/hosts)"}%%\#*}##[:blank:]#[^[:blank:]]#}}} || _etc_hosts=()
2633 zstyle ':completion:*:hosts' hosts $hosts
2634 # TODO: so, why is this here?
2635 # zstyle '*' hosts $hosts
2637 # use generic completion system for programs not yet defined; (_gnu_generic works
2638 # with commands that provide a --help option with "standard" gnu-like output.)
2639 for compcom in cp deborphan df feh fetchipac head hnb ipacsum mv \
2640 pal stow tail uname ; do
2641 [[ -z ${_comps[$compcom]} ]] && compdef _gnu_generic ${compcom}
2644 # see upgrade function in this file
2645 compdef _hosts upgrade
2651 # people should use 'grml-x'!
2652 if check_com -c 915resolution; then
2654 echo "Please use 915resolution as resolution modifying tool for Intel \
2660 #a1# Output version of running grml
2661 alias grml-version='cat /etc/grml_version'
2663 if check_com -c rebuildfstab ; then
2664 #a1# Rebuild /etc/fstab
2665 alias grml-rebuildfstab='rebuildfstab -v -r -config'
2668 if check_com -c grml-debootstrap ; then
2670 echo "Installing debian to harddisk is possible by using grml-debootstrap."
2677 # {{{ now run the functions
2679 is4 && isgrml && grmlstuff
2684 is4 && xsource "/etc/zsh/keephack"
2687 # {{{ wonderful idea of using "e" glob qualifier by Peter Stephenson
2688 # You use it as follows:
2689 # $ NTREF=/reference/file
2691 # This lists all the files in the current directory newer than the reference file.
2692 # You can also specify the reference file inline; note quotes:
2693 # $ ls -l *(e:'nt ~/.zshenv':)
2695 if [[ -n $1 ]] ; then
2698 [[ $REPLY -nt $NTREF ]]
2702 # shell functions {{{
2704 #f1# Provide csh compatibility
2705 setenv() { typeset -x "${1}${1:+=}${(@)argv[2,$#]}" } # csh compatibility
2707 #f1# Reload an autoloadable function
2708 freload() { while (( $# )); do; unfunction $1; autoload -U $1; shift; done }
2709 compdef _functions freload
2711 #f1# List symlinks in detail (more detailed version of 'readlink -f' and 'whence -s')
2713 [[ -z "$1" ]] && printf 'Usage: %s <file(s)>\n' "$0" && return 1
2714 for file in "$@" ; do
2715 while [[ -h "$file" ]] ; do
2717 file=$(readlink "$file")
2722 # fast manual access
2723 if check_com qma ; then
2724 #f1# View the zsh manual
2725 manzsh() { qma zshall "$1" }
2728 manzsh() { /usr/bin/man zshall | vim -c "se ft=man| se hlsearch" +/"$1" - ; }
2731 # TODO: Is it supported to use pager settings like this?
2732 # PAGER='less -Mr' - If so, the use of $PAGER here needs fixing
2733 # with respect to wordsplitting. (ie. ${=PAGER})
2734 if check_com -c $PAGER ; then
2735 #f1# View Debian's changelog of a given package
2738 if [[ -r /usr/share/doc/$1/changelog.Debian.gz ]] ; then
2739 $PAGER /usr/share/doc/$1/changelog.Debian.gz
2740 elif [[ -r /usr/share/doc/$1/changelog.gz ]] ; then
2741 $PAGER /usr/share/doc/$1/changelog.gz
2743 if check_com -c aptitude ; then
2744 echo "No changelog for package $1 found, using aptitude to retrieve it."
2746 aptitude -t unstable changelog $1
2748 aptitude changelog $1
2751 echo "No changelog for package $1 found, sorry."
2756 _dchange() { _files -W /usr/share/doc -/ }
2757 compdef _dchange dchange
2759 #f1# View Debian's NEWS of a given package
2762 if [[ -r /usr/share/doc/$1/NEWS.Debian.gz ]] ; then
2763 $PAGER /usr/share/doc/$1/NEWS.Debian.gz
2765 if [[ -r /usr/share/doc/$1/NEWS.gz ]] ; then
2766 $PAGER /usr/share/doc/$1/NEWS.gz
2768 echo "No NEWS file for package $1 found, sorry."
2773 _dnews() { _files -W /usr/share/doc -/ }
2774 compdef _dnews dnews
2776 #f1# View upstream's changelog of a given package
2779 if [[ -r /usr/share/doc/$1/changelog.gz ]] ; then
2780 $PAGER /usr/share/doc/$1/changelog.gz
2782 echo "No changelog for package $1 found, sorry."
2786 _uchange() { _files -W /usr/share/doc -/ }
2787 compdef _uchange uchange
2792 ZSH_PROFILE_RC=1 $SHELL "$@"
2795 #f1# Edit an alias via zle
2797 [[ -z "$1" ]] && { echo "Usage: edalias <alias_to_edit>" ; return 1 } || vared aliases'[$1]' ;
2799 compdef _aliases edalias
2801 #f1# Edit a function via zle
2803 [[ -z "$1" ]] && { echo "Usage: edfun <function_to_edit>" ; return 1 } || zed -f "$1" ;
2805 compdef _functions edfunc
2807 # use it e.g. via 'Restart apache2'
2808 #m# f6 Start() \kbd{/etc/init.d/\em{process}}\quad\kbd{start}
2809 #m# f6 Restart() \kbd{/etc/init.d/\em{process}}\quad\kbd{restart}
2810 #m# f6 Stop() \kbd{/etc/init.d/\em{process}}\quad\kbd{stop}
2811 #m# f6 Reload() \kbd{/etc/init.d/\em{process}}\quad\kbd{reload}
2812 #m# f6 Force-Reload() \kbd{/etc/init.d/\em{process}}\quad\kbd{force-reload}
2813 if [[ -d /etc/init.d || -d /etc/service ]] ; then
2815 local action_="${1:l}" # e.g Start/Stop/Restart
2819 local service_target_="$(readlink /etc/init.d/$service_)"
2820 if [[ $service_target_ == "/usr/bin/sv" ]]; then
2822 case "${action_}" in
2823 start) if [[ ! -e /etc/service/$service_ ]]; then
2824 $SUDO ln -s "/etc/sv/$service_" "/etc/service/"
2826 $SUDO "/etc/init.d/$service_" "${action_}" "$param_"
2828 # there is no reload in runits sysv emulation
2829 reload) $SUDO "/etc/init.d/$service_" "force-reload" "$param_" ;;
2830 *) $SUDO "/etc/init.d/$service_" "${action_}" "$param_" ;;
2834 $SUDO "/etc/init.d/$service_" "${action_}" "$param_"
2838 for i in Start Restart Stop Force-Reload Reload ; do
2839 eval "$i() { __start_stop $i \"\$1\" \"\$2\" ; }"
2843 #f1# Provides useful information on globbing
2850 p named pipes (FIFOs)
2851 * executable plain files (0100)
2852 % device files (character or block special)
2853 %b block special files
2854 %c character special files
2855 r owner-readable files (0400)
2856 w owner-writable files (0200)
2857 x owner-executable files (0100)
2858 A group-readable files (0040)
2859 I group-writable files (0020)
2860 E group-executable files (0010)
2861 R world-readable files (0004)
2862 W world-writable files (0002)
2863 X world-executable files (0001)
2864 s setuid files (04000)
2865 S setgid files (02000)
2866 t files with the sticky bit (01000)
2868 print *(m-1) # Files modified up to a day ago
2869 print *(a1) # Files accessed a day ago
2870 print *(@) # Just symlinks
2871 print *(Lk+50) # Files bigger than 50 kilobytes
2872 print *(Lk-50) # Files smaller than 50 kilobytes
2873 print **/*.c # All *.c files recursively starting in \$PWD
2874 print **/*.c~file.c # Same as above, but excluding 'file.c'
2875 print (foo|bar).* # Files starting with 'foo' or 'bar'
2876 print *~*.* # All Files that do not contain a dot
2877 chmod 644 *(.^x) # make all plain non-executable files publically readable
2878 print -l *(.c|.h) # Lists *.c and *.h
2879 print **/*(g:users:) # Recursively match all files that are owned by group 'users'
2880 echo /proc/*/cwd(:h:t:s/self//) # Analogous to >ps ax | awk '{print $1}'<"
2882 alias help-zshglob=H-Glob
2884 check_com -c qma && alias ?='qma zshall'
2886 # grep for running process, like: 'any vim'
2889 if [[ -z "$1" ]] ; then
2890 echo "any - grep for process(es) by keyword" >&2
2891 echo "Usage: any <keyword>" >&2 ; return 1
2894 local LENGTH=$(expr length $STRING)
2895 local FIRSCHAR=$(echo $(expr substr $STRING 1 1))
2896 local REST=$(echo $(expr substr $STRING 2 $LENGTH))
2897 ps xauwww| grep "[$FIRSCHAR]$REST"
2901 # After resuming from suspend, system is paging heavily, leading to very bad interactivity.
2902 # taken from $LINUX-KERNELSOURCE/Documentation/power/swsusp.txt
2903 [[ -r /proc/1/maps ]] && \
2905 print 'Reading /proc/[0-9]*/maps and sending output to /dev/null, this might take a while.'
2906 cat $(sed -ne 's:.* /:/:p' /proc/[0-9]*/maps | sort -u | grep -v '^/dev/') > /dev/null
2907 print 'Finished, running "swapoff -a; swapon -a" may also be useful.'
2910 # print hex value of a number
2913 [[ -n "$1" ]] && printf "%x\n" $1 || { print 'Usage: hex <number-to-convert>' ; return 1 }
2916 # calculate (or eval at all ;-)) with perl => p[erl-]eval
2917 # hint: also take a look at zcalc -> 'autoload zcalc' -> 'man zshmodules | less -p MATHFUNC'
2919 [[ -n "$1" ]] && CALC="$*" || print "Usage: calc [expression]"
2920 perl -e "print eval($CALC),\"\n\";"
2922 functions peval &>/dev/null && alias calc=peval
2924 # brltty seems to have problems with utf8 environment and/or font Uni3-Terminus16 under
2925 # certain circumstances, so work around it, no matter which environment we have
2927 if [[ -z "$DISPLAY" ]] ; then
2928 consolechars -f /usr/share/consolefonts/default8x16.psf.gz
2935 # just press 'asdf' keys to toggle between dvorak and us keyboard layout
2937 echo -n 'Switching to us keyboard layout: '
2938 [[ -z "$DISPLAY" ]] && $SUDO loadkeys us &>/dev/null || setxkbmap us &>/dev/null
2942 echo -n 'Switching to dvorak keyboard layout: '
2943 [[ -z "$DISPLAY" ]] && $SUDO loadkeys dvorak &>/dev/null || setxkbmap dvorak &>/dev/null
2946 # just press 'asdf' key to toggle from neon layout to us keyboard layout
2948 echo -n 'Switching to us keyboard layout: '
2949 setxkbmap us && echo 'Done' || echo 'Failed'
2952 # set up an ipv6 tunnel
2957 if ifconfig sit1 2>/dev/null | grep -q 'inet6 addr: 2002:.*:1::1' ; then
2958 print 'ipv6 tunnel already set up, nothing to be done.'
2959 print 'execute: "ifconfig sit1 down ; ifconfig sit0 down" to remove ipv6-tunnel.' ; return 1
2961 [[ -n "$PUBLIC_IP" ]] || \
2962 local PUBLIC_IP=$(ifconfig $(route -n | awk '/^0\.0\.0\.0/{print $8; exit}') | \
2963 awk '/inet addr:/ {print $2}' | tr -d 'addr:')
2965 [[ -n "$PUBLIC_IP" ]] || { print 'No $PUBLIC_IP set and could not determine default one.' ; return 1 }
2966 local IPV6ADDR=$(printf "2002:%02x%02x:%02x%02x:1::1" $(print ${PUBLIC_IP//./ }))
2967 print -n "Setting up ipv6 tunnel $IPV6ADDR via ${PUBLIC_IP}: "
2968 ifconfig sit0 tunnel ::192.88.99.1 up
2969 ifconfig sit1 add "$IPV6ADDR" && print done || print failed
2973 if ifconfig sit1 2>/dev/null | grep -q 'inet6 addr: 2002:.*:1::1' ; then
2974 print 'ipv6 tunnel available' ; return 0
2976 print 'ipv6 tunnel not available' ; return 1
2980 if ifconfig sit1 2>/dev/null | grep -q 'inet6 addr: 2002:.*:1::1' ; then
2981 print -n 'Stopping ipv6 tunnel (sit0 + sit1): '
2982 ifconfig sit1 down ; ifconfig sit0 down && print done || print failed
2984 print 'No ipv6 tunnel found, nothing to be done.' ; return 1
2988 print "Usage: ipv6-tunnel [start|stop|status]">&2 ; return 1
2993 # run dhclient for wireless device
2995 sudo dhclient "$(wavemon -d | awk '/device/{print $3}')"
2998 # spawn a minimally set up mksh - useful if you want to umount /usr/.
3001 local shell="/bin/mksh"
3003 if [[ ! -x ${shell} ]]; then
3004 printf '`%s'\'' not available, giving up.\n' ${shell} >&2
3008 exec env -i ENV="/etc/minimal-shellrc" HOME="$HOME" TERM="$TERM" ${shell}
3011 # a wrapper for vim, that deals with title setting
3013 # set this array to a set of options to vim you always want
3014 # to have set when calling vim (in .zshrc.local), like:
3015 # VIM_OPTIONS=( -p )
3016 # This will cause vim to send every file given on the
3017 # commandline to be send to it's own tab (needs vim7).
3019 VIM_PLEASE_SET_TITLE='yes' command vim ${VIM_OPTIONS} "$@"
3022 # make a backup of a file
3024 cp -a "$1" "${1}_$(date --iso-8601=seconds)"
3027 #f1# grep for patterns in grml's zsh setup
3033 print "usage: zg -[anr] <pattern>\n";
3034 print " Search for patterns in grml'\''s zshrc.\n";
3035 print " zg takes no or exactly one option plus a non empty pattern.\n\n";
3036 print " options:\n";
3037 print " -- no options (use if your pattern starts in with a dash.\n";
3038 print " -a search for the pattern in all code regions\n";
3039 print " -n search for the pattern in non-root code only\n";
3040 print " -r search in code for everyone (also root) only\n\n";
3041 print " The default is -a for non-root users and -r for root.\n\n";
3042 print " If you installed the zshrc to a non-default locations (ie *NOT*\n";
3043 print " in /etc/zsh/zshrc) do: export GRML_ZSHRC=\$HOME/.zshrc\n";
3044 print " ...in case you copied the file to that location.\n\n";
3048 if ($ENV{GRML_ZSHRC} ne "") {
3049 $RC = $ENV{GRML_ZSHRC};
3051 $RC = "/etc/zsh/zshrc";
3054 usage if ($#ARGV < 0 || $#ARGV > 1);
3055 if ($> == 0) { $mode = "allonly"; }
3056 else { $mode = "all"; }
3059 if ($opt eq "--") { shift; }
3060 elsif ($opt eq "-a") { $mode = "all"; shift; }
3061 elsif ($opt eq "-n") { $mode = "nonroot"; shift; }
3062 elsif ($opt eq "-r" ) { $mode = "allonly"; shift; }
3063 elsif ($opt =~ m/^-/ || $#ARGV > 0) { usage(); }
3065 $pattern = $ARGV[0];
3066 usage() if ($pattern eq "");
3068 open FH, "<$RC" or die "zg: Could not open $RC: $!\n";
3069 while ($line = <FH>) {
3071 if ($line =~ m/^#:grep:marker:for:mika:/) { $markerfound = 1; next; }
3072 next if ($mode eq "nonroot" && markerfound == 0);
3073 break if ($mode eq "allonly" && markerfound == 1);
3074 print $line, "\n" if ($line =~ /$pattern/);
3084 ssl_hashes=( sha512 sha256 sha1 md5 )
3086 for sh in ${ssl_hashes}; do
3087 eval 'ssl-cert-'${sh}'() {
3089 if [[ -z $1 ]] ; then
3090 printf '\''usage: %s <file>\n'\'' "ssh-cert-'${sh}'"
3093 openssl x509 -noout -fingerprint -'${sh}' -in $1
3097 ssl-cert-fingerprints() {
3100 if [[ -z $1 ]] ; then
3101 printf 'usage: ssl-cert-fingerprints <file>\n'
3104 for i in ${ssl_hashes}
3111 if [[ -z $1 ]] ; then
3112 printf 'usage: ssl-cert-info <file>\n'
3115 openssl x509 -noout -text -in $1
3116 ssl-cert-fingerprints $1
3121 # {{{ make sure our environment is clean regarding colors
3122 for color in BLUE RED GREEN CYAN YELLOW MAGENTA WHITE ; unset $color
3125 # "persistent history" {{{
3126 # just write important commands you always need to ~/.important_commands
3127 if [[ -r ~/.important_commands ]] ; then
3128 fc -R ~/.important_commands
3132 # load the lookup subsystem if it's available on the system
3133 zrcautoload lookupinit && lookupinit
3135 #:grep:marker:for:mika: :-)
3136 ### non-root (EUID != 0) code below
3139 if (( GRML_ALWAYS_LOAD_ALL == 0 )) && (( $EUID == 0 )) ; then
3146 # set terminal property (used e.g. by msgid-chooser)
3147 export COLORTERM="yes"
3149 # set default browser
3150 if [[ -z "$BROWSER" ]] ; then
3151 if [[ -n "$DISPLAY" ]] ; then
3152 #v# If X11 is running
3153 check_com -c firefox && export BROWSER=firefox
3155 #v# If no X11 is running
3156 check_com -c w3m && export BROWSER=w3m
3160 #m# v QTDIR \kbd{/usr/share/qt[34]}\quad [for non-root only]
3161 [[ -d /usr/share/qt3 ]] && export QTDIR=/usr/share/qt3
3162 [[ -d /usr/share/qt4 ]] && export QTDIR=/usr/share/qt4
3164 # support running 'jikes *.java && jamvm HelloWorld' OOTB:
3165 #v# [for non-root only]
3166 [[ -f /usr/share/classpath/glibj.zip ]] && export JIKESPATH=/usr/share/classpath/glibj.zip
3171 # Xterm resizing-fu.
3172 # Based on http://svn.kitenet.net/trunk/home-full/.zshrc?rev=11710&view=log (by Joey Hess)
3173 alias hide='echo -en "\033]50;nil2\007"'
3174 alias tiny='echo -en "\033]50;-misc-fixed-medium-r-normal-*-*-80-*-*-c-*-iso8859-15\007"'
3175 alias small='echo -en "\033]50;6x10\007"'
3176 alias medium='echo -en "\033]50;-misc-fixed-medium-r-normal--13-120-75-75-c-80-iso8859-15\007"'
3177 alias default='echo -e "\033]50;-misc-fixed-medium-r-normal-*-*-140-*-*-c-*-iso8859-15\007"'
3178 alias large='echo -en "\033]50;-misc-fixed-medium-r-normal-*-*-150-*-*-c-*-iso8859-15\007"'
3179 alias huge='echo -en "\033]50;-misc-fixed-medium-r-normal-*-*-210-*-*-c-*-iso8859-15\007"'
3180 alias smartfont='echo -en "\033]50;-artwiz-smoothansi-*-*-*-*-*-*-*-*-*-*-*-*\007"'
3181 alias semifont='echo -en "\033]50;-misc-fixed-medium-r-semicondensed-*-*-120-*-*-*-*-iso8859-15\007"'
3184 #a2# Execute \kbd{du -sch}
3186 #a2# Execute \kbd{jobs -l}
3190 #a2# Execute \kbd{./configure}
3191 alias CO="./configure"
3192 #a2# Execute \kbd{./configure --help}
3193 alias CH="./configure --help"
3196 #a2# Execute \kbd{ls -lSrah}
3197 alias dir="ls -lSrah"
3198 #a2# Only show dot-directories
3199 alias lad='ls -d .*(/)' # only show dot-directories
3200 #a2# Only show dot-files
3201 alias lsa='ls -a .*(.)' # only show dot-files
3202 #a2# Only files with setgid/setuid/sticky flag
3203 alias lss='ls -l *(s,S,t)' # only files with setgid/setuid/sticky flag
3204 #a2# Only show 1st ten symlinks
3205 alias lsl='ls -l *(@)' # only symlinks
3206 #a2# Display only executables
3207 alias lsx='ls -l *(*)' # only executables
3208 #a2# Display world-{readable,writable,executable} files
3209 alias lsw='ls -ld *(R,W,X.^ND/)' # world-{readable,writable,executable} files
3210 #a2# Display the ten biggest files
3211 alias lsbig="ls -flh *(.OL[1,10])" # display the biggest files
3212 #a2# Only show directories
3213 alias lsd='ls -d *(/)' # only show directories
3214 #a2# Only show empty directories
3215 alias lse='ls -d *(/^F)' # only show empty directories
3216 #a2# Display the ten newest files
3217 alias lsnew="ls -rtlh *(D.om[1,10])" # display the newest files
3218 #a2# Display the ten oldest files
3219 alias lsold="ls -rtlh *(D.Om[1,10])" # display the oldest files
3220 #a2# Display the ten smallest files
3221 alias lssmall="ls -Srl *(.oL[1,10])" # display the smallest files
3224 #a2# Execute \kbd{chmod 600}
3225 alias rw-='chmod 600'
3226 #a2# Execute \kbd{chmod 700}
3227 alias rwx='chmod 700'
3228 #m# a2 r-{}- Execute \kbd{chmod 644}
3229 alias r--='chmod 644'
3230 #a2# Execute \kbd{chmod 755}
3231 alias r-x='chmod 755'
3233 # some useful aliases
3234 #a2# Execute \kbd{mkdir -o}
3238 #a2# Execute \kbd{mplayer -vo fbdev}
3239 alias cmplayer='mplayer -vo fbdev'
3240 #a2# Execute \kbd{mplayer -vo fbdev -fs -zoom}
3241 alias fbmplayer='mplayer -vo fbdev -fs -zoom'
3242 #a2# Execute \kbd{links2 -driver fb}
3243 alias fblinks='links2 -driver fb'
3245 #a2# ssh with StrictHostKeyChecking=no \\&\quad and UserKnownHostsFile unset
3246 alias insecssh='ssh -o "StrictHostKeyChecking=no" -o "UserKnownHostsFile=/dev/null"'
3247 alias insecscp='scp -o "StrictHostKeyChecking=no" -o "UserKnownHostsFile=/dev/null"'
3250 check_com -c python && alias http="python -m SimpleHTTPServer"
3252 # Use 'g' instead of 'git':
3253 check_com g || alias g='git'
3255 # work around non utf8 capable software in utf environment via $LANG and luit
3256 if check_com isutfenv && check_com luit ; then
3257 if check_com -c mrxvt ; then
3258 isutfenv && [[ -n "$LANG" ]] && \
3259 alias mrxvt="LANG=${LANG/(#b)(*)[.@]*/$match[1].iso885915} luit mrxvt"
3262 if check_com -c aterm ; then
3263 isutfenv && [[ -n "$LANG" ]] && \
3264 alias aterm="LANG=${LANG/(#b)(*)[.@]*/$match[1].iso885915} luit aterm"
3267 if check_com -c centericq ; then
3268 isutfenv && [[ -n "$LANG" ]] && \
3269 alias centericq="LANG=${LANG/(#b)(*)[.@]*/$match[1].iso885915} luit centericq"
3274 # useful functions {{{
3277 #f4# Search for newspostings from authors
3278 agoogle() { ${=BROWSER} "http://groups.google.com/groups?as_uauthors=$*" ; }
3279 #f4# Search Debian Bug Tracking System
3283 if [[ $# -eq 1 ]]; then
3286 ${=BROWSER} "http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=$1"
3289 ${=BROWSER} "http://bugs.debian.org/cgi-bin/pkgreport.cgi?submitter=$1"
3292 ${=BROWSER} "http://bugs.debian.org/$*"
3296 print "$0 needs one argument"
3300 #f4# Search Debian Bug Tracking System in mbox format
3308 ${=BROWSER} http://search.dmoz.org/cgi-bin/search\?search=${1// /_}
3310 #f4# Search German Wiktionary
3313 ${=BROWSER} http://de.wiktionary.org/wiki/${(C)1// /_}
3315 #f4# Search English Wiktionary
3318 ${=BROWSER} http://en.wiktionary.org/wiki/${(C)1// /_}
3320 #f4# Search Google Groups
3323 ${=BROWSER} "http://groups.google.com/groups?q=$*"
3328 ${=BROWSER} "http://www.google.com/search?&num=100&q=$*"
3330 #f4# Search Google Groups for MsgID
3333 ${=BROWSER} "http://groups.google.com/groups?selm=$*"
3335 #f4# Search Netcraft
3338 ${=BROWSER} "http://toolbar.netcraft.com/site_report?url=$1"
3340 #f4# Use German Wikipedia's full text search
3343 ${=BROWSER} http://de.wikipedia.org/wiki/Spezial:Search/${(C)1}
3345 #f4# search \kbd{dict.leo.org}
3348 ${=BROWSER} "http://dict.leo.org/?search=$*"
3350 #f4# Search German Wikipedia
3353 ${=BROWSER} http://de.wikipedia.org/wiki/"${(C)*}"
3355 #f4# Search English Wikipedia
3358 ${=BROWSER} http://en.wikipedia.org/wiki/"${(C)*}"
3360 #f4# Search official debs
3363 ${=BROWSER} "http://packages.debian.org/search?keywords=$1&searchon=contents&suite=${2:=unstable}§ion=all"
3366 #m# f4 gex() Exact search via Google
3367 check_com google && gex () {
3368 google "\"[ $1]\" $*"
3372 #f5# Backup \kbd{file {\rm to} file\_timestamp}
3375 cp -b $1 $1_`date --iso-8601=m`
3380 diff -crd "$@" | egrep -v "^Only in |^Binary files "
3382 #f5# cd to directoy and list files
3390 cvs add $* && cvs com -m 'initial checkin' $*
3395 cvs diff -N $* |& $PAGER
3400 cvs log $* |& $PAGER
3417 #f5# Disassemble source files using gcc and as
3420 gcc -pipe -S -o - -O -g $* | as -aldh -o /dev/null
3422 #f5# Firefox remote control - open given URL
3424 if [ -e /etc/debian_version ]; then
3425 firefox -a iceweasel -remote "openURL($1)" || firefox ${1}&
3427 firefox -a firefox -remote "openURL($1)" || firefox ${1}&
3430 #f5# Create Directoy and \kbd{cd} to it
3432 mkdir -p "$@" && cd "$@"
3434 #f5# Unified diff to timestamped outputfile
3436 diff -udrP "$1" "$2" > diff.`date "+%Y-%m-%d"`."$1"
3438 #f5# Memory overview
3440 ps aux | awk '{if (NR > 1) print $5; if (NR > 2) print "+"} END { print "p" }' | dc
3442 #f5# Show contents of gzipped tar file
3445 gunzip -c $1 | tar -tf - -- | $PAGER
3447 #f5# Show contents of zip file
3450 unzip -l $1 | $PAGER
3455 diff -urd $* | egrep -v "^Only in |^Binary files "
3457 #f5# (Mis)use \kbd{vim} as \kbd{less}
3460 vim --cmd 'let no_plugin_maps = 1' -c "so \$VIMRUNTIME/macros/less.vim" "${@:--}"
3463 # Function Usage: uopen $URL/$file
3464 #f5# Download a file and display it locally
3467 if ! [[ -n "$1" ]] ; then
3468 print "Usage: uopen \$URL/\$file">&2
3472 MIME=$(curl --head $FILE | grep Content-Type | cut -d ' ' -f 2 | cut -d\; -f 1)
3474 curl $FILE | see ${MIME}:-
3478 # Function Usage: doc packagename
3479 #f5# \kbd{cd} to /usr/share/doc/\textit{package}
3482 cd /usr/share/doc/$1 && ls
3484 _doc() { _files -W /usr/share/doc -/ }
3485 check_com compdef && compdef _doc doc
3487 #f5# Make screenshot
3489 [[ ! -d ~/shots ]] && mkdir ~/shots
3490 #cd ~/shots ; sleep 5 ; import -window root -depth 8 -quality 80 `date "+%Y-%m-%d--%H:%M:%S"`.png
3491 cd ~/shots ; sleep 5; import -window root shot_`date --iso-8601=m`.jpg
3497 images=( *.{jpg,gif,png}(.N) )
3499 if [[ $#images -eq 0 ]] ; then
3500 print "No image files found"
3506 #f5# Create PDF file from source code
3511 a2ps --medium A4dj -E -o $output $*
3515 # zsh with perl-regex - use it e.g. via:
3516 # regcheck '\s\d\.\d{3}\.\d{3} Euro' ' 1.000.000 Euro'
3517 #f5# Checks whether a regex matches or not.\\&\quad Example: \kbd{regcheck '.\{3\} EUR' '500 EUR'}
3520 zmodload -i zsh/pcre
3521 pcre_compile $1 && \
3522 pcre_match $2 && echo "regex matches" || echo "regex does not match"
3525 #f5# List files which have been accessed within the last {\it n} days, {\it n} defaults to 1
3528 print -l -- *(a-${1:-1})
3531 #f5# List files which have been changed within the last {\it n} days, {\it n} defaults to 1
3534 print -l -- *(c-${1:-1})
3537 #f5# List files which have been modified within the last {\it n} days, {\it n} defaults to 1
3540 print -l -- *(m-${1:-1})
3542 # modified() was named new() in earlier versions, add an alias for backwards compatibility
3543 check_com new || alias new=modified
3545 #f5# Grep in history
3550 # use colors when GNU grep with color-support
3551 #a2# Execute \kbd{grep -{}-color=auto}
3552 (grep --help 2>/dev/null |grep -- --color) >/dev/null && alias grep='grep --color=auto'
3553 #a2# Execute \kbd{grep -i -{}-color=auto}
3554 alias GREP='grep -i --color=auto'
3556 #f5# Watch manpages in a stretched style
3557 man2() { PAGER='dash -c "sed G | /usr/bin/less"' command man "$@" ; }
3559 # usage example: 'lcheck strcpy'
3560 #f5# Find out which libs define a symbol
3562 if [[ -n "$1" ]] ; then
3563 nm -go /usr/lib/lib*.a 2>/dev/null | grep ":[[:xdigit:]]\{8\} . .*$1"
3565 echo "Usage: lcheck <function>" >&2
3569 #f5# Clean up directory - remove well known tempfiles
3571 FILES=(*~(N) .*~(N) \#*\#(N) *.o(N) a.out(N) *.core(N) *.cmo(N) *.cmi(N) .*.swp(N))
3573 if [[ $NBFILES > 0 ]] ; then
3576 echo -n "Remove these files? [y/n] "
3578 if [[ $ans == "y" ]] ; then
3580 echo ">> $PWD purged, $NBFILES files removed"
3582 echo "Ok. .. then not.."
3588 # 'translate' looks up fot a word in a file with language-to-language
3589 # translations (field separator should be " : "). A typical wordlist looks
3591 # | english-word : german-transmission
3592 # It's also only possible to translate english to german but not reciprocal.
3593 # Use the following oneliner to turn back the sort order:
3594 # $ awk -F ':' '{ print $2" : "$1" "$3 }' \
3595 # /usr/local/lib/words/en-de.ISO-8859-1.vok > ~/.translate/de-en.ISO-8859-1.vok
3596 #f5# Translates a word
3601 translate -l de-en $2
3604 translate -l en-de $2
3607 echo "Usage: $0 { -D | -E }"
3608 echo " -D == German to English"
3609 echo " -E == English to German"
3613 #f5# List all occurrences of programm in current PATH
3616 if [[ $# = 0 ]] ; then
3617 echo "Usage: $0 program"
3618 echo "Example: $0 zsh"
3619 echo "Lists all occurrences of program in the current PATH."
3621 ls -l ${^path}/*$1*(*N)
3625 # Found in the mailinglistarchive from Zsh (IIRC ~1996)
3626 #f5# Select items for specific command(s) from history
3631 echo "Usage: $0 command"
3634 cmd=(${(f)"$(grep -w $1 $HISTFILE | sort | uniq | pr -tn)"})
3635 print -l $cmd | less -F
3636 echo -n "enter number of desired command [1 - $(( ${#cmd[@]} - 1 ))]: "
3639 print -z "${cmd[$answer]#*$TAB}"
3642 # Use vim to convert plaintext to HTML
3643 #f5# Transform files to html with highlighting
3646 vim -u NONE -n -c ':syntax on' -c ':so $VIMRUNTIME/syntax/2html.vim' -c ':wqa' $1 &>/dev/null
3649 # Usage: simple-extract <file>
3650 #f5# Smart archive extractor
3653 if [[ -f $1 ]] ; then
3655 *.tar.bz2) bzip2 -v -d $1 ;;
3656 *.tar.gz) tar -xvzf $1 ;;
3659 *.bz2) bzip2 -d $1 ;;
3661 *.gz) gunzip -d $1 ;;
3662 *.tar) tar -xvf $1 ;;
3663 *.tgz) gunzip -d $1 ;;
3664 *.tbz2) tar -jxvf $1 ;;
3666 *.Z) uncompress $1 ;;
3667 *) echo "'$1' Error. Please go away" ;;
3670 echo "'$1' is not a valid file"
3674 # Usage: smartcompress <file> (<type>)
3675 #f5# Smart archive creator
3678 if [[ -n $2 ]] ; then
3680 tgz | tar.gz) tar -zcvf$1.$2 $1 ;;
3681 tbz2 | tar.bz2) tar -jcvf$1.$2 $1 ;;
3682 tar.Z) tar -Zcvf$1.$2 $1 ;;
3683 tar) tar -cvf$1.$2 $1 ;;
3684 gz | gzip) gzip $1 ;;
3685 bz2 | bzip2) bzip2 $1 ;;
3687 echo "Error: $2 is not a valid compression type"
3691 smartcompress $1 tar.gz
3695 # Usage: show-archive <archive>
3696 #f5# List an archive's content
3699 if [[ -f $1 ]] ; then
3701 *.tar.gz) gunzip -c $1 | tar -tf - -- ;;
3702 *.tar) tar -tf $1 ;;
3703 *.tgz) tar -ztf $1 ;;
3704 *.zip) unzip -l $1 ;;
3706 *.deb) dpkg-deb --fsys-tarfile $1 | tar -tf - -- ;;
3707 *) echo "'$1' Error. Please go away" ;;
3710 echo "'$1' is not a valid archive"
3714 # It's shameless stolen from <http://www.vim.org/tips/tip.php?tip_id=167>
3715 #f5# Use \kbd{vim} as your manpage reader
3718 if (( ${#argv} == 0 )); then
3719 printf 'usage: vman <topic>\n'
3722 man "$@" | col -b | view -c 'set ft=man nomod nolist' -
3725 # function readme() { $PAGER -- (#ia3)readme* }
3726 #f5# View all README-like files in current directory in pager
3730 files=(./(#i)*(read*me|lue*m(in|)ut)*(ND))
3731 if (($#files)) ; then
3734 print 'No README files.'
3738 # function ansi-colors()
3739 #f5# Display ANSI colors
3741 typeset esc="\033[" line1 line2
3742 echo " _ _ _40 _ _ _41_ _ _ _42 _ _ 43_ _ _ 44_ _ _45 _ _ _ 46_ _ _ 47_ _ _ 49_ _"
3743 for fore in 30 31 32 33 34 35 36 37; do
3746 for back in 40 41 42 43 44 45 46 47 49; do
3747 line1="${line1}${esc}${back};${fore}m Normal ${esc}0m"
3748 line2="${line2}${esc}${back};${fore};1m Bold ${esc}0m"
3750 echo -e "$line1\n$line2"
3754 #f5# Find all files in \$PATH with setuid bit set
3755 suidfind() { ls -latg $path | grep '^...s' }
3757 # TODO: So, this is the third incarnation of this function!?
3758 #f5# Reload given functions
3760 for func in $argv ; do
3766 # a small check to see which DIR is located on which server/partition.
3767 # stolen and modified from Sven's zshrc.forall
3768 #f5# Report diskusage of a directory
3771 if [[ -n "$1" ]] ; then
3772 for dir in "$@" ; do
3773 if [[ -d "$dir" ]] ; then
3774 ( cd $dir; echo "-<$dir>"; du -shx .; echo);
3776 echo "warning: $dir does not exist" >&2
3780 for dir in $path; do
3781 if [[ -d "$dir" ]] ; then
3782 ( cd $dir; echo "-<$dir>"; du -shx .; echo);
3784 echo "warning: $dir does not exist" >&2
3790 # % slow_print `cat /etc/passwd`
3791 #f5# Slowly print out parameters
3793 for argument in "$@" ; do
3794 for ((i = 1; i <= ${#1} ;i++)) ; do
3795 print -n "${argument[i]}"
3803 #f5# Show some status info
3806 print "Date..: "$(date "+%Y-%m-%d %H:%M:%S")
3807 print "Shell.: Zsh $ZSH_VERSION (PID = $$, $SHLVL nests)"
3808 print "Term..: $TTY ($TERM), ${BAUD:+$BAUD bauds, }$COLUMNS x $LINES chars"
3809 print "Login.: $LOGNAME (UID = $EUID) on $HOST"
3810 print "System: $(cat /etc/[A-Za-z]*[_-][rv]e[lr]*)"
3811 print "Uptime:$(uptime)"
3816 #f5# Rip an audio CD
3820 cdrdao read-cd --device $DEVICE --driver generic-mmc audiocd.toc
3821 cdrdao read-cddb --device $DEVICE --driver generic-mmc audiocd.toc
3822 echo " * Would you like to burn the cd now? (yes/no)"
3824 if [[ "$input" = "yes" ]] ; then
3825 echo " ! Burning Audio CD"
3829 echo " ! Invalid response."
3834 #f5# Burn an audio CD (in combination with audiorip)
3837 cdrdao write --device $DEVICE --driver generic-mmc audiocd.toc
3838 echo " * Should I remove the temporary files? (yes/no)"
3840 if [[ "$input" = "yes" ]] ; then
3841 echo " ! Removing Temporary Files."
3846 echo " ! Invalid response."
3850 #f5# Make an audio CD from all mp3 files
3852 # TODO: do the renaming more zshish, possibly with zmv()
3855 for i in *.[Mm][Pp]3; do mv "$i" `echo $i | tr '[A-Z]' '[a-z]'`; done
3856 for i in *.mp3; do mv "$i" `echo $i | tr ' ' '_'`; done
3857 for i in *.mp3; do mpg123 -w `basename $i .mp3`.wav $i; done
3859 for i in *.wav; do sox $i.wav -r 44100 $i.wav resample; done
3862 #f5# Create an ISO image. You are prompted for\\&\quad volume name, filename and directory
3865 echo " * Volume name "
3867 echo " * ISO Name (ie. tmp.iso)"
3869 echo " * Directory or File"
3871 mkisofs -o ~/$iso -A $volume -allow-multidot -J -R -iso-level 3 -V $volume -R $files
3874 #f5# Simple thumbnails generator
3876 rm -rf thumb-* index.html
3880 <title>Images</title>
3882 <body>" > index.html
3883 for f in *.(gif|jpeg|jpg|png) ; do
3884 convert -size 100x200 "$f" -resize 100x200 thumb-"$f"
3885 echo " <a href=\"$f\"><img src=\"thumb-$f\"></a>" >> index.html
3889 </html>" >> index.html
3892 #f5# Set all ulimit parameters to \kbd{unlimited}
3903 # ogg2mp3 with bitrate of 192
3906 oggdec -o - $1 | lame -b 192 - ${1:r}.mp3
3909 #f5# RFC 2396 URL encoding in Z-Shell
3914 print ${(j::)input/(#b)([^A-Za-z0-9_.!~*\'\(\)-])/%${(l:2::0:)$(([##16]#match))}}
3917 # http://strcat.de/blog/index.php?/archives/335-Software-sauber-deinstallieren...html
3918 #f5# Log 'make install' output
3921 [[ ! -d ~/.errorlogs ]] && mkdir ~/.errorlogs
3922 make -n install > ~/.errorlogs/${PWD##*/}-makelog
3925 #f5# Indent source code
3927 indent -npro -kr -i8 -ts8 -sob -l80 -ss -ncs "$@"
3930 # highlight important stuff in diff output, usage example: hg diff | hidiff
3931 #m# a2 hidiff \kbd{histring} oneliner for diffs
3932 check_com -c histring && \
3933 alias hidiff="histring -fE '^Comparing files .*|^diff .*' | histring -c yellow -fE '^\-.*' | histring -c green -fE '^\+.*'"
3935 # rename pictures based on information found in exif headers
3936 #f5# Rename pictures based on information found in exif headers
3939 if [[ $# -lt 1 ]] ; then
3940 echo 'Usage: jpgrename $FILES' >& 2
3943 echo -n 'Checking for jhead with version newer than 1.9: '
3944 jhead_version=`jhead -h | grep 'used by most Digital Cameras. v.*' | awk '{print $6}' | tr -d v`
3945 if [[ $jhead_version > '1.9' ]]; then
3946 echo 'success - now running jhead.'
3947 jhead -n%Y-%m-%d_%Hh%M_%f $*
3949 echo 'failed - exiting.'
3954 # get_ic() - queries imap servers for capabilities; real simple. no imaps
3958 if [[ ! -z $1 ]] ; then
3960 print "querying imap server on $1:${port}...\n";
3961 print "a1 capability\na2 logout\n" | nc $1 ${port}
3963 print "usage:\n $0 <imap-server> [port]"
3967 # creates a Maildir/ with its {new,cur,tmp} subdirs
3971 root=${MAILDIR_ROOT:-${HOME}/Mail}
3972 if [[ -z ${1} ]] ; then print "Usage:\n $0 <dirname>" ; return 1 ; fi
3974 mkdir -p ${root}/${subdir}/{cur,new,tmp}
3977 #f5# Change the xterm title from within GNU-screen
3980 if [[ $1 != "-f" ]] ; then
3981 if [[ -z ${DISPLAY} ]] ; then
3982 printf 'xtrename only makes sense in X11.\n'
3988 if [[ -z $1 ]] ; then
3989 printf 'usage: xtrename [-f] "title for xterm"\n'
3990 printf ' renames the title of xterm from _within_ screen.\n'
3991 printf ' also works without screen.\n'
3992 printf ' will not work if DISPLAY is unset, use -f to override.\n'
3995 print -n "\eP\e]0;${1}\C-G\e\\"
3999 # hl() highlighted less
4000 # http://ft.bewatermyfriend.org/comp/data/zsh/zfunct.html
4001 if check_com -c highlight ; then
4005 theme=${HL_THEME:-""}
4008 ( printf 'available languages (syntax parameter):\n\n' ;
4009 highlight --list-langs ; ) | less -SMr
4012 ( printf 'available themes (style parameter):\n\n' ;
4013 highlight --list-themes ; ) | less -SMr
4016 printf 'usage: hl <syntax[:theme]> <file>\n'
4017 printf ' available options: --list (-l), --themes (-t), --help (-h)\n\n'
4018 printf ' Example: hl c main.c\n'
4021 if [[ -z ${2} ]] || (( ${#argv} > 2 )) ; then
4022 printf 'usage: hl <syntax[:theme]> <file>\n'
4023 printf ' available options: --list (-l), --themes (-t), --help (-h)\n'
4024 (( ${#argv} > 2 )) && printf ' Too many arguments.\n'
4028 [[ ${1} == *:* ]] && [[ -n ${1#*:} ]] && theme=${1#*:}
4029 if [[ -n ${theme} ]] ; then
4030 highlight --xterm256 --syntax ${lang} --style ${theme} ${2} | less -SMr
4032 highlight --ansi --syntax ${lang} ${2} | less -SMr
4038 # ... and a proper completion for hl()
4039 # needs 'highlight' as well, so it fits fine in here.
4040 function _hl_genarg() {
4042 if [[ -prefix 1 *: ]] ; then
4044 themes=(${${${(f)"$(LC_ALL=C highlight --list-themes)"}/ #/}:#*(Installed|Use name)*})
4046 _wanted -C list themes expl theme compadd ${themes}
4049 langs=(${${${(f)"$(LC_ALL=C highlight --list-langs)"}/ #/}:#*(Installed|Use name)*})
4050 _wanted -C list languages expl languages compadd -S ':' -q ${langs}
4053 function _hl_complete() {
4054 _arguments -s '1: :_hl_genarg' '2:files:_path_files'
4056 compdef _hl_complete hl
4060 # Rewrite this by either using tinyurl.com's API
4061 # or using another shortening service to comply with
4062 # tinyurl.com's policy.
4064 # Create small urls via http://tinyurl.com using wget(1).
4067 # [[ -z $1 ]] && { print "USAGE: zurl <URL>" ; return 1 }
4069 # local PN url tiny grabber search result preview
4072 ## Check existence of given URL with the help of ping(1).
4073 ## N.B. ping(1) only works without an eventual given protocol.
4074 # ping -c 1 ${${url#(ftp|http)://}%%/*} >& /dev/null || \
4075 # read -q "?Given host ${${url#http://*/}%/*} is not reachable by pinging. Proceed anyway? [y|n] "
4077 # if (( $? == 0 )) ; then
4078 ## Prepend 'http://' to given URL where necessary for later output.
4079 # [[ ${url} != http(s|)://* ]] && url='http://'${url}
4080 # tiny='http://tinyurl.com/create.php?url='
4081 # if check_com -c wget ; then
4082 # grabber='wget -O- -o/dev/null'
4084 # print "wget is not available, but mandatory for ${PN}. Aborting."
4086 ## Looking for i.e.`copy('http://tinyurl.com/7efkze')' in TinyURL's HTML code.
4087 # search='copy\(?http://tinyurl.com/[[:alnum:]]##*'
4088 # result=${(M)${${${(f)"$(${=grabber} ${tiny}${url})"}[(fr)${search}*]}//[()\';]/}%%http:*}
4089 ## TinyURL provides the rather new feature preview for more confidence. <http://tinyurl.com/preview.php>
4090 # preview='http://preview.'${result#http://}
4092 # printf '%s\n\n' "${PN} - Shrinking long URLs via webservice TinyURL <http://tinyurl.com>."
4093 # printf '%s\t%s\n\n' 'Given URL:' ${url}
4094 # printf '%s\t%s\n\t\t%s\n' 'TinyURL:' ${result} ${preview}
4100 #f2# Print a specific line of file(s).
4104 if [ $# -lt 2 ] ; then
4105 print "Usage: linenr <number>[,<number>] <file>" ; return 1
4106 elif [ $# -eq 2 ] ; then
4109 command ed -s $file <<< "${number}n"
4113 for file in "$@" ; do
4114 if [ ! -d $file ] ; then
4116 command ed -s $file <<< "${number}n" 2> /dev/null
4125 #f2# Find history events by search pattern and list them by date.
4129 local usage help ident format_l format_s first_char remain first last
4130 usage='USAGE: whatwhen [options] <searchstring> <search range>'
4131 help='Use `whatwhen -h'\'' for further explanations.'
4132 ident=${(l,${#${:-Usage: }},, ,)}
4133 format_l="${ident}%s\t\t\t%s\n"
4134 format_s="${format_l//(\\t)##/\\t}"
4135 # Make the first char of the word to search for case
4136 # insensitive; e.g. [aA]
4137 first_char=[${(L)1[1]}${(U)1[1]}]
4139 # Default search range is `-100'.
4141 # Optional, just used for `<first> <last>' given.
4145 printf '%s\n\n' 'ERROR: No search string specified. Aborting.'
4146 printf '%s\n%s\n\n' ${usage} ${help} && return 1
4149 printf '%s\n\n' ${usage}
4151 printf $format_l '-h' 'show help text'
4153 print 'SEARCH RANGE:'
4154 printf $format_l "'0'" 'the whole history,'
4155 printf $format_l '-<n>' 'offset to the current history number; (default: -100)'
4156 printf $format_s '<[-]first> [<last>]' 'just searching within a give range'
4157 printf '\n%s\n' 'EXAMPLES:'
4158 printf ${format_l/(\\t)/} 'whatwhen grml' '# Range is set to -100 by default.'
4159 printf $format_l 'whatwhen zsh -250'
4160 printf $format_l 'whatwhen foo 1 99'
4163 printf '%s\n%s\n\n' ${usage} ${help} && return 1
4166 # -l list results on stout rather than invoking $EDITOR.
4167 # -i Print dates as in YYYY-MM-DD.
4168 # -m Search for a - quoted - pattern within the history.
4169 fc -li -m "*${first_char}${remain}*" $first $last
4175 # change fluxbox keys from 'Alt-#' to 'Alt-F#' and vice versa
4178 [[ -n "$FLUXKEYS" ]] || local FLUXKEYS="$HOME/.fluxbox/keys"
4179 if ! [[ -r "$FLUXKEYS" ]] ; then
4180 echo "Sorry, \$FLUXKEYS file $FLUXKEYS could not be read - nothing to be done."
4183 if grep -q 'Mod1 F[0-9] :Workspace [0-9]' $FLUXKEYS ; then
4184 echo -n 'Switching to Alt-# mode in ~/.fluxbox/keys: '
4185 sed -i -e 's|^\(Mod[0-9]\+[: space :]\+\)F\([0-9]\+[: space :]\+:Workspace.*\)|\1\2|' $FLUXKEYS && echo done || echo failed
4186 elif grep -q 'Mod1 [0-9] :Workspace [0-9]' $FLUXKEYS ; then
4187 echo -n 'Switching to Alt-F# mode in ~/.fluxbox/keys: '
4188 sed -i -e 's|^\(Mod[0-9]\+[: space :]\+\)\([0-9]\+[: space :]\+:Workspace.*\)|\1F\2|' $FLUXKEYS && echo done || echo failed
4190 echo 'Sorry, do not know what to do.'
4196 # retrieve weather information on the console
4197 # Usage example: 'weather LOWG'
4201 print 'Usage: weather <station_id>' >&2
4202 print 'List of stations: http://en.wikipedia.org/wiki/List_of_airports_by_ICAO_code'>&2
4206 local VERBOSE="yes" # TODO: Make this a command line switch
4209 local PLACE="${1:u}"
4210 local DIR="${HOME}/.weather"
4211 local LOG="${DIR}/log"
4213 [[ -d ${DIR} ]] || {
4214 print -n "Creating ${DIR}: "
4219 print "Retrieving information for ${PLACE}:"
4221 cd ${DIR} && wget -T 10 --no-verbose --output-file=$LOG --timestamping http://weather.noaa.gov/pub/data/observations/metar/decoded/$PLACE.TXT
4223 if [[ $? -eq 0 ]] ; then
4224 if [[ -n "$VERBOSE" ]] ; then
4227 DATE=$(grep 'UTC' ${PLACE}.TXT | sed 's#.* /##')
4228 TEMPERATURE=$(awk '/Temperature/ { print $4" degree Celcius / " $2" degree Fahrenheit" }' ${PLACE}.TXT | tr -d '(')
4230 echo "temp: $TEMPERATURE"
4233 print "There was an error retrieving the weather information for $PLACE" >&2
4242 # mercurial related stuff {{{
4243 if check_com -c hg ; then
4244 # gnu like diff for mercurial
4245 # http://www.selenic.com/mercurial/wiki/index.cgi/TipsAndTricks
4246 #f5# GNU like diff for mercurial
4249 for i in $(hg status -marn "$@") ; diff -ubwd <(hg cat "$i") "$i"
4252 # build debian package
4253 #a2# Alias for \kbd{hg-buildpackage}
4254 alias hbp='hg-buildpackage'
4256 # execute commands on the versioned patch-queue from the current repos
4257 alias mq='hg -R $(readlink -f $(hg root)/.hg/patches)'
4259 # diffstat for specific version of a mercurial repository
4260 # hgstat => display diffstat between last revision and tip
4261 # hgstat 1234 => display diffstat between revision 1234 and tip
4262 #f5# Diffstat for specific version of a mercurial repos
4265 [[ -n "$1" ]] && hg diff -r $1 -r tip | diffstat || hg export tip | diffstat
4268 fi # end of check whether we have the 'hg'-executable
4272 # some useful commands often hard to remember - let's grep for them {{{
4273 # actually use our zg() function now. :)
4275 # Work around ion/xterm resize bug.
4276 #if [[ "$SHLVL" -eq 1 ]]; then
4277 # if check_com -c resize ; then
4278 # eval `resize </dev/null`
4283 # /usr/bin/jackd -dalsa -dhw:0 -r48000 -p1024 -n2
4284 # now play audio file:
4285 # alsaplayer -o jack foobar.mp3
4287 # send files via netcat
4289 # send() {j=$*; tar cpz ${j/%${!#}/}|nc -w 1 ${!#} 51330;}
4291 # alias receive='nc -vlp 51330 | tar xzvp'
4294 # dh_make -e foo@localhost -f $1
4295 # dpkg-buildpackage -rfakeroot
4297 # dpkg-scanpackages ./ /dev/null | gzip > Packages.gz
4298 # dpkg-scansources . | gzip > Sources.gz
4299 # grep-dctrl --field Maintainer $* /var/lib/apt/lists/*
4302 # convert -geometry 200x200 -interlace LINE -verbose
4303 # ldapsearch -x -b "OU=Bedienstete,O=tug" -h ldap.tugraz.at sn=$1
4304 # ps -ao user,pcpu,start,command
4305 # gpg --keyserver blackhole.pca.dfn.de --recv-keys
4306 # xterm -bg black -fg yellow -fn -misc-fixed-medium-r-normal--14-140-75-75-c-90-iso8859-15 -ah
4307 # nc -vz $1 1-1024 # portscan via netcat
4308 # wget --mirror --no-parent --convert-links
4310 # autoload -U tetris; zle -N tetris; bindkey '...' ; echo "press ... for playing tennis"
4312 # modify console cursor
4313 # see http://www.tldp.org/HOWTO/Framebuffer-HOWTO-5.html
4314 # print $'\e[?96;0;64c'
4317 # grml-small cleanups {{{
4319 # The following is used to remove zsh-config-items that do not work
4320 # in grml-small by default.
4321 # If you do not want these adjustments (for whatever reason), set
4322 # $GRMLSMALL_SPECIFIC to 0 in your .zshrc.pre file (which this configuration
4323 # sources if it is there).
4325 if (( GRMLSMALL_SPECIFIC > 0 )) && isgrmlsmall ; then
4328 unalias 'V' &> /dev/null
4329 unfunction vman &> /dev/null
4330 unfunction viless &> /dev/null
4331 unfunction 2html &> /dev/null
4333 # manpages are not in grmlsmall
4334 unfunction manzsh &> /dev/null
4335 unfunction man2 &> /dev/null
4343 ## genrefcard.pl settings {{{
4345 ### doc strings for external functions from files
4346 #m# f5 grml-wallpaper() Sets a wallpaper (try completion for possible values)
4348 ### example: split functions-search 8,16,24,32
4349 #@# split functions-search 8
4353 ## END OF FILE #################################################################
4354 # vim:filetype=zsh foldmethod=marker autoindent expandtab shiftwidth=4