X-Git-Url: http://git.grml.org/?a=blobdiff_plain;f=doc%2Fgrmlzshrc.t2t;h=3aae18f12ea5fa0e9cc4bf9408c5a78e2571a6fc;hb=a3d8018d5f6547c85a366db053d2ef22ac40e433;hp=df3946ca4863e0adcf84b8b8ec01ee574530f3e4;hpb=e6beda13323ec34d2b6e404297799ac2b67f8d7b;p=grml-etc-core.git diff --git a/doc/grmlzshrc.t2t b/doc/grmlzshrc.t2t index df3946c..3aae18f 100644 --- a/doc/grmlzshrc.t2t +++ b/doc/grmlzshrc.t2t @@ -56,9 +56,6 @@ put the battery status into the right hand side interactive prompt. A non zero value activates a handler, which is called when a command can not be found. The handler is defined by GRML_ZSH_CNF_HANDLER (see below). -: **GRML_ALWAYS_LOAD_ALL** -Enables the whole Grml setup for root, if set to a non zero value. - : **GRML_ZSH_CNF_HANDLER** This variable contains the handler to be used by COMMAND_NOT_FOUND (see above) and defaults to "/usr/share/command-not-found/command-not-found". @@ -317,10 +314,6 @@ already set otherwise. : **PAGER** Set less(1) as default pager, if not already set to something different. -: **QTDIR** -Holds the path to shared files for the C++ application framework QT -(version 3 or 4). - : **SHELL** Set explicitly to /bin/zsh, to prevent certain terminal emulators to default to /bin/sh or /bin/bash. @@ -386,11 +379,6 @@ A wildcard character never matches a leading '.'. : **nohup** Do not send the hangup signal (HUP:1) to running jobs when the shell exits. -: **nonomatch** -If a pattern for filename generation has no matches, do not print an error -and leave it unchanged in the argument list. This also applies to file -expansion of an initial `~' or `='. - : **notify** Report the status of background jobs immediately, rather than waiting until just before printing a prompt. @@ -450,22 +438,12 @@ Lists files in current directory, which have been accessed within the last N days. N is an integer to be passed as first and only argument. If no argument is specified N is set to 1. -: **agoogle()** -Searches for USENET postings from authors using google groups. - : **allulimit()** Sets all ulimit values to "unlimited". : **any()** Lists processes matching given pattern. -: **aoeu(), asdf(), uiae()** -Pressing the 'asdf' keys toggles between dvorak or neon and us keyboard -layout. - -: **apache2-ssl-certificate()** -Advices the user how to create self signed certificates. - : **asc()** Login on the host provided as argument using autossh. Then reattach a GNU screen session if a detached session is around or detach a currently attached screen or @@ -477,11 +455,6 @@ Simple backup of a file or directory using cp(1). The target file name is the original name plus a time stamp attached. Symlinks and file attributes like mode, ownership and timestamps are preserved. -: **cdiff()** -Runs a recursive diff(1) over two given directories trying to find the -smallest set of changes. Three lines of context will be printed and binary -files filtered out. - : **cdrecord()** If the original cdrecord is not installed, issues a warning to the user to use the wodim binary instead. Wodim is the debian fork of Joerg Schillings @@ -509,35 +482,9 @@ grml systems with autologin. Changes current directory to the one supplied by argument and lists the files in it, including file names starting with ".". -: **cvsa()** -Adds and commits the given files using cvs(1). The commit message will be -'initial checkin'. - -: **cvsd()** -Shows a cvs diff of the arguments in $PAGER. - -: **cvsl()** -Shows the cvs log in $PAGER. - -: **cvsq()** -Runs a cvs update. - -: **cvsr()** -Generates a changelog using rcs2log and shows it in $PAGER. - -: **cvss()** -Shows cvs status of given files. - : **dchange()** Shows the changelog of given package in $PAGER. -: **debbug()** -Searches the Debian bug tracking system (bugs.debian.org) for Bug numbers, -email addresses of submitters or any string given on the command line. - -: **debbugm()** -Shows bug report for debian given by number in mailbox format. - : **debian2hd()** Tells the user to use grml-debootstrap, if she wants to install debian to harddisk. @@ -547,50 +494,18 @@ A trick from $LINUX-KERNELSOURCE/Documentation/power/swsusp.txt. It brings back interactive responsiveness after suspend, when the system is swapping heavily. -: **dmoz()** -Searches for the first argument (optional) in the Open Directory Project -(See http://www.dmoz.org/docs/en/about.html). - : **dnews()** Shows the NEWS file for the given package in $PAGER. -: **doc()** -Takes packagename as argument. Sets current working directory to -/usr/share/doc/ and prints out a directory listing. - -: **dwicti()** -Looks up the first argument (optional) in the german Wiktionary -which is an online dictionary (See: http://de.wiktionary.org/). - : **edalias()** Edit given alias. : **edfunc()** Edit given shell function. -: **ewicti()** -Looks up the first argument (optional in the english Wiktionary -which is an online dictionary (See: http://en.wiktionary.org/). - : **freload()** Reloads an autoloadable shell function (See autoload in zshbuiltins(1)). -: **get_tw_cli()** -Fetches 3ware RAID controller software using get_3ware(1). - -: **gex()** -Performs an exact (i. e. quoted) web search using Google. - -: **ggogle()** -Searches the arguments on Google Groups, a web to USENET gateway. - -: **google()** -Searches the search engine Google using arguments as search string. - -: **hex()** -Prints the hexadecimal representation of the number supplied as argument -(base ten only). - : **hgdi()** Use GNU diff with options -ubwd for mercurial. @@ -601,10 +516,6 @@ argument means last revision). : **hidiff()** Outputs highlighted diff; needs highstring(1). -: **ipv6-tunnel()** -Sets up an IPv6 tunnel on interface sit1. Needs one argument - -either "start", "stop" or "status". - : **is4()** Returns true, if zsh version is equal or greater than 4, else false. @@ -642,32 +553,15 @@ environment variables to UTF-8. : **isutfenv()** Returns true, if run within an utf environment, else false. -: **iwclient()** -Searches a wireless interface and runs dhclient(8) on it. - -: **manzsh()** -Shows the zshall manpage and jumps to the first match of the regular -expression optionally given as argument (Needs qma(1)). - -: **mcd()** +: **mkcd()** Creates directory including parent directories, if necessary. Then changes current working directory to it. -: **mggogle()** -Searches Google Groups for a USENET message-ID. - -: **minimal-shell()** -Spawns a minimally set up MirBSD Korn shell. It references no files in /usr, -so that file system can be unmounted. - : **modified()** Lists files in current directory, which have been modified within the last N days. N is an integer to be passed as first and only argument. If no argument is specified N is set to 1. -: **netcraft()** -Asks netcraft.com for informations about the site given as argument. - : **nt()** A helper function for the "e" glob qualifier to list all files newer than a reference file. @@ -680,32 +574,14 @@ Example usages: % ls -l *(e:'nt /reference/file':) ``` -: **oleo()** -Translates the given word using the english - german online -dictionary dict.leo.org. - -: **peval()** -Evaluates a perl expression; useful as command line -calculator, therefore also available as "calc". - : **profile()** Runs a command in $SHELL with profiling enabled (See startup variable ZSH_PROFILE_RC above). -: **refunc()** -Reloads functions given as parameters. - : **salias()** Creates an alias whith sudo prepended, if $EUID is not zero. Run "salias -h" for details. See also xunfunction() below. -: **setenv()** -Reimplementation of the csh(1) builtin setenv. - -: **show-archive()** -Lists the contents of a (compressed) archive with the appropriate programs. -The choice is made along the filename extension. - : **simple-extract()** Tries to uncompress/unpack given files with the appropriate programs. If an URI starting with https, http or ftp is provided simple-extract tries to download @@ -716,18 +592,6 @@ ending. simple-extract will not delete the original archive (even on .gz,.bz2 or : **sll()** Prints details of symlinks given as arguments. -: **smartcompress()** -Compresses/archives the file given as first parameter. Takes an optional -second argument, which denotes the compression/archive type as typical -filename extension; defaults to "tar.gz". - -: **sshot()** -Creates directory named shots in user's home directory, if it does not yet -exist and changes current working directory to it. Then sleeps 5 seconds, -so you have plenty of time to switch desktops/windows. Then makes a screenshot -of the current desktop. The result is stored in ~/shots to a timestamped -jpg file. - : **ssl-cert-fingerprints** Prints the SHA512, SHA256, SHA1 and MD5 digest of a x509 certificate. First and only parameter must be a file containing a certificate. Use @@ -753,9 +617,6 @@ Example usage: % Restart ssh ``` -: **swiki()** -Searches articles in the german Wikipedia for the term given as argument. - : **trans()** Translates a word from german to english (-D) or vice versa (-E). @@ -779,17 +640,6 @@ Searches the history for a given pattern and lists the results by date. The first argument is the search pattern. The second and third ones are optional and denote a search range (default: -100). -: **wikide()** -Looks up the argument on Wikipedia (german). - -: **wikien()** -Looks up the argument on Wikipedia (english). - -: **wodeb()** -Searches the list of official debian packages for the term given as -first argument. The optional second argument denotes the distribution -(stable, testing or unstable) and defaults to unstable. - : **xcat()** Tries to cat(1) file(s) given as parameter(s). Always returns true. See also xunfunction() below. @@ -806,12 +656,6 @@ arguments for details. : **xunfunction()** Removes the functions salias, xcat, xsource, xunfunction and zrcautoload. -: **zg()** -Search for patterns in grml's zshrc using perl. zg takes no or exactly one -option plus a non empty pattern. Run zg without any arguments for a listing -of available command line switches. For a zshrc not in /etc/zsh, set the -GRML_ZSHRC environment variable. - : **zrcautoload()** Wrapper around the autoload builtin. Loads the definitions of functions from the file given as argument. Searches $fpath for the file. See also @@ -880,24 +724,6 @@ available packages are fetched from the location(s) specified in /etc/apt/sources.list. An update should always be performed before an upgrade or dist-upgrade; run by sudo, if necessary. -: **calc** (//peval//) -Evaluates a perl expression (see peval() above); useful as a command line -calculator. - -: **CH** (//./configure --help//) -Lists available compilation options for building program from source. - -: **cmplayer** (//mplayer -vo fbdev//) -Video player with framebuffer as video output device, so you can watch -videos on a virtual tty. Hint: Using fbdev2 allows you to use the shell -while watching a movie. - -: **CO** (//./configure//) -Prepares compilation for building program from source. - -: **cp** (//nocorrect cp//) -cp(1) without spelling correction. - : **da** (//du -sch//) Prints the summarized disk usage of the arguments as well as a grand total in human readable format. @@ -908,25 +734,10 @@ Builds binary or source packages from sources (See: dpkg-buildpackage(1)). : **debs-by-size** (//grep-status -FStatus -sInstalled-Size,Package -n "install ok installed" | paste -sd " \n" | sort -rn//) Prints installed Packages sorted by size (descending). -: **default** (//echo -en [ escape sequence ]//) -Sets font of xterm to "-misc-fixed-medium-r-normal-*-*-140-*-*-c-*-iso8859-15" -using escape sequence. - : **dir** (//ls -lSrah//) Lists files (including dot files) sorted by size (biggest last) in long and human readable output format. -: **fblinks** (//links2 -driver fb//) -A Web browser on the framebuffer device. So you can browse images and click -links on the virtual tty. - -: **fbmplayer** (//mplayer -vo fbdev -fs -zoom//) -Fullscreen Video player with the framebuffer as video output device. So you -can watch videos on a virtual tty. - -: **g** (//git//) -Revision control system by Linus Torvalds. - : **ge** (//grep-excuses//) Searches the testing excuses files for a specific maintainer (See: grep-excuses(1)). @@ -934,9 +745,6 @@ grep-excuses(1)). : **grep** (//grep --color=auto//) Shows grep output in nice colors, if available. -: **GREP** (//grep -i --color=auto//) -Case insensitive grep with colored output. - : **grml-rebuildfstab** (//rebuildfstab -v -r -config//) Scans for new devices and updates /etc/fstab according to the findings. @@ -962,16 +770,6 @@ ssh with possible man-in-the-middle attack enabled : **help-zshglob** (//H-Glob()//) Runs the function H-Glob() to expand or explain wildcards. -: **hide** (//echo -en [ escape sequence ]//) -Tries to hide xterm window using escape sequence. - -: **hidiff** (//histring -fE '^Comparing files .*|^diff .*' | histring -c yellow -fE '^\-.*' | histring -c green -fE '^\+.*'//) -If histring(1) is installed, highlight important stuff in diff(1) output. - -: **huge** (//echo -en [ escape sequence ]//) -Sets huge font in xterm ("-misc-fixed-medium-r-normal-*-*-210-*-*-c-*-iso8859-15") -using escape sequence. - : **j** (//jobs -l//) Prints status of jobs in the current shell session in long format. @@ -986,10 +784,6 @@ starting with ".". : **lad** (//ls -d .*(/)//) Lists the dot directories (not their contents) in current directory. -: **large** (//echo -en [ escape sequence ]//) -Sets large font in xterm ("-misc-fixed-medium-r-normal-*-*-150-*-*-c-*-iso8859-15") -using escape sequence. - : **lh** (//ls -hAl --color=auto//) Lists files in long and human readable output format in nice colors, if available. Includes file names starting with "." except "." and @@ -1042,33 +836,13 @@ world executable (long output format). : **lsx** (//ls -l *(*)//) Lists only executable files. -: **md** (//mkdir -p//) -Creates directory including parent directories, if necessary - : **mdstat** (//cat /proc/mdstat//) Lists all active md (i.e. linux software raid) devices with some information about them. -: **medium** (//echo -en [ escape sequence ]//) -Sets medium sized font -("-misc-fixed-medium-r-normal--13-120-75-75-c-80-iso8859-15") in xterm -using escape sequence. - -: **mkdir** (//nocorrect mkdir//) -mkdir(1) without spelling correction. - : **mq** (//hg -R $(readlink -f $(hg root)/.hg/patches)//) Executes the commands on the versioned patch queue from current repository. -: **mv** (//nocorrect mv//) -mv(1) without spelling correction. - -: **rd** (//rmdir//) -Short rmdir(1) (remove directory). - -: **rm** (//nocorrect rm//) -rm(1) without spelling correction. - : **rmcdir** (//'cd ..; rmdir $OLDPWD || cd $OLDPWD//) rmdir current working directory @@ -1078,39 +852,6 @@ as config file. If invoked by a regular user, start a screen session with users .screenrc config if it exists, else use /etc/grml/screenrc_grml as configuration. -: **rw-** (//chmod 600//) -Grants read and write permission of a file to the owner and nobody else. - -: **rwx** (//chmod 700//) -Grants read, write and execute permission of a file to the owner and nobody -else. - -: **r--** (//chmod 644//) -Grants read and write permission of a file to the owner and read-only to -anybody else. - -: **r-x** (//chmod 755//) -Grants read, write and execute permission of a file to the owner and -read-only plus execute permission to anybody else. - -: **S** (//screen//) -Short for screen(1). - -: **s** (//ssh//) -Short for ssh(1). - -: **semifont** (//echo -en [ escape sequence ]//) -Sets font of xterm to -"-misc-fixed-medium-r-semicondensed-*-*-120-*-*-*-*-iso8859-15" using -escape sequence. - -: **small** (//echo -en [ escape sequence ]//) -Sets small xterm font ("6x10") using escape sequence. - -: **smartfont** (//echo -en [ escape sequence ]//) -Sets font of xterm to "-artwiz-smoothansi-*-*-*-*-*-*-*-*-*-*-*-*" using -escape sequence. - : **su** (//sudo su//) If user is running a grml live-CD, dont ask for any password, if she wants a root shell. @@ -1123,22 +864,9 @@ http://www.cl.cam.ac.uk/~mgk25/unicode.html#term). Sets mode from ISO 2022 to UTF-8 (See: http://www.cl.cam.ac.uk/~mgk25/unicode.html#term). -: **tiny** (//echo -en [ escape sequence ]//) -Sets tiny xterm font -("-misc-fixed-medium-r-normal-*-*-80-*-*-c-*-iso8859-15") using escape -sequence. - : **tlog** (//tail -f /var/log/syslog//) Prints syslog continuously (See tail(1)). -: **top10** (//print -l ? ${(o)history%% *} | uniq -c | sort -nr | head -n 10//) -Prints the ten most used shell commands. - -: **truec** (//truecrypt [ mount options ]//) -Mount a truecrypt volume with some reasonable mount options -("rw,sync,dirsync,users,uid=1000,gid=users,umask=077" and "utf8", if -available). - : **up** (//aptitude update ; aptitude safe-upgrade//) Performs a system update followed by a system upgrade using aptitude; run by sudo, if necessary. See au and ag above. @@ -1147,21 +875,12 @@ by sudo, if necessary. See au and ag above. After calling, characters of URLs as typed get automatically escaped, if necessary, to protect them from the shell. -: **0** (//return 0//) -Gives a clean prompt (i.e. without $?). - : **$(uname -r)-reboot** (//kexec -l --initrd=/boot/initrd.img-"$(uname -r)" --command-line=\"$(cat /proc/cmdline)\" /boot/vmlinuz-"$(uname -r)"//) Reboots using kexec(8) and thus reduces boot time by skipping hardware initialization of BIOS/firmware. : **...** (//cd ../..///) Changes current directory two levels higher. -: **?** (//qma zshall//) -Runs the grml script qma (quick manual access) to build the collected man -pages for the z-shell. This compressed file is kept at -~/man/zshall.txt.lzo Once it is built, the second use of the alias '?' is -fast. See "man qma" for further information. - = AUXILIARY FILES = This is a set of files, that - if they exist - can be used to customize the