[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

21. Zsh Modules

[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

21.1 Description

Some optional parts of zsh are in modules, separate from the core of the shell. Each of these modules may be linked in to the shell at build time, or can be dynamically linked while the shell is running if the installation supports this feature. The modules that are bundled with the zsh distribution are:

zsh/cap
Builtins for manipulating POSIX.1e (POSIX.6) capability (privilege) sets.

zsh/clone
A builtin that can clone a running shell onto another terminal.

zsh/compctl
The compctl builtin for controlling completion.

zsh/complete
The basic completion code.

zsh/complist
Completion listing extensions.

zsh/computil
A module with utility builtins needed for the shell function based completion system.

zsh/datetime
Some date/time commands and parameters.

zsh/deltochar
A ZLE function duplicating EMACS' zap-to-char.

zsh/example
An example of how to write a module.

zsh/files
Some basic file manipulation commands as builtins.

zsh/mapfile
Access to external files via a special associative array.

zsh/mathfunc
Standard scientific functions for use in mathematical evaluations.

zsh/parameter
Access to internal hash tables via special associative arrays.

zsh/pcre
Interface to the PCRE library.

zsh/sched
A builtin that provides a timed execution facility within the shell.

zsh/net/socket
Manipulation of Unix domain sockets

zsh/stat
A builtin command interface to the stat system call.

zsh/system
A builtin interface to various low-level system features.

zsh/net/tcp
Manipulation of TCP sockets

zsh/termcap
Interface to the termcap database.

zsh/terminfo
Interface to the terminfo database.

zsh/zftp
A builtin FTP client.

zsh/zle
The Zsh Line Editor, including the bindkey and vared builtins.

zsh/zleparameter
Access to internals of the Zsh Line Editor via parameters.

zsh/zprof
A module allowing profiling for shell functions.

zsh/zpty
A builtin for starting a command in a pseudo-terminal.

zsh/zselect
Block and return when file descriptors are ready.

zsh/zutil
Some utility builtins, e.g. the one for supporting configuration via styles.

21.2 The zsh/cap Module  
21.3 The zsh/clone Module  
21.4 The zsh/compctl Module  
21.5 The zsh/complete Module  
21.6 The zsh/complist Module  
21.7 The zsh/computil Module  
21.8 The zsh/datetime Module  
21.9 The zsh/deltochar Module  
21.10 The zsh/example Module  
21.11 The zsh/files Module  
21.12 The zsh/mapfile Module  
21.13 The zsh/mathfunc Module  
21.14 The zsh/parameter Module  
21.15 The zsh/pcre Module  
21.16 The zsh/sched Module  
21.17 The zsh/net/socket Module  
21.18 The zsh/stat Module  
21.19 The zsh/system Module  
21.22 The zsh/net/tcp Module  
21.23 The zsh/termcap Module  
21.24 The zsh/terminfo Module  
21.25 The zsh/zftp Module  
21.26 The zsh/zle Module  
21.27 The zsh/zleparameter Module  
21.28 The zsh/zprof Module  
21.29 The zsh/zpty Module  
21.30 The zsh/zselect Module  
21.31 The zsh/zutil Module  

[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

21.2 The zsh/cap Module

The zsh/cap module is used for manipulating POSIX.1e (POSIX.6) capability sets. If the operating system does not support this interface, the builtins defined by this module will do nothing. The builtins in this module are:

cap [ capabilities ]
Change the shell's process capability sets to the specified capabilities, otherwise display the shell's current capabilities.

getcap filename ...
This is a built-in implementation of the POSIX standard utility. It displays the capability sets on each specified filename.

setcap capabilities filename ...
This is a built-in implementation of the POSIX standard utility. It sets the capability sets on each specified filename to the specified capabilities.

[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

21.3 The zsh/clone Module

The zsh/clone module makes available one builtin command:

clone tty
Creates a forked instance of the current shell, attached to the specified tty. In the new shell, the PID, PPID and TTY special parameters are changed appropriately. $! is set to zero in the new shell, and to the new shell's PID in the original shell.

The return value of the builtin is zero in both shells if successful, and non-zero on error.

The target of clone should be an unused terminal, such as an unused virtual console or a virtual terminal created by

xterm -e sh -c 'trap : INT QUIT TSTP; tty; while :; do sleep 100000000; done'

Some words of explanation aLPADDING=1 CELLSPACING=1 BORDER=0> [ << ] [ >> ]           [Top] [Contents] [Index] [ ? ]
This document was generated by root on April, 24 2005 using texi2html ./usr/share/doc/zsh-beta-doc/html/zsh_21.html0000644000000000000000000054153410232722731021064 0ustar rootroot00000000000000 zsh: Zsh Modules

[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

21. Zsh Modules

[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

21.1 Description

Some optional parts of zsh are in modules, separate from the core of the shell. Each of these modules may be linked in to the shell at build time, or can be dynamically linked while the shell is running if the installation supports this feature. The modules that are bundled with the zsh distribution are:

zsh/cap
Builtins for manipulating POSIX.1e (POSIX.6) capability (privilege) sets.

zsh/clone
A builtin that can clone a running shell onto another terminal.

zsh/compctl
The compctl builtin for controlling completion.

zsh/complete
The basic completion code.

zsh/complist
Completion listing extensions.

zsh/computil
A module with utility builtins needed for the shell function based completion system.

zsh/datetime
Some date/time commands and parameters.

zsh/deltochar
A ZLE function duplicating EMACS' zap-to-char.

zsh/example
An example of how to write a module.

zsh/files
Some basic file manipulation commands as builtins.

zsh/mapfile
Access to external files via a special associative array.

zsh/mathfunc
Standard scientific functions for use in mathematical evaluations.

zsh/parameter
Access to internal hash tables via special associative arrays.

zsh/pcre
Interface to the PCRE library.

zsh/sched
A builtin that provides a timed execution facility within the shell.

zsh/net/socket
Manipulation of Unix domain sockets

zsh/stat
A builtin command interface to the stat system call.

zsh/system
A builtin interface to various low-level system features.

zsh/net/tcp
Manipulation of TCP sockets

zsh/termcap
Interface to the termcap database.

zsh/terminfo
Interface to the terminfo database.

zsh/zftp
A builtin FTP client.

zsh/zle
The Zsh Line Editor, including the bindkey and vared builtins.

zsh/zleparameter
Access to internals of the Zsh Line Editor via parameters.

zsh/zprof
A module allowing profiling for shell functions.

zsh/zpty
A builtin for starting a command in a pseudo-terminal.

zsh/zselect
Block and return when file descriptors are ready.

zsh/zutil
Some utility builtins, e.g. the one for supporting configuration via styles.

21.2 The zsh/cap Module  
21.3 The zsh/clone Module  
21.4 The zsh/compctl Module  
21.5 The zsh/complete Module  
21.6 The zsh/complist Module  
21.7 The zsh/computil Module  
21.8 The zsh/datetime Module  
21.9 The zsh/deltochar Module  
21.10 The zsh/example Module  
21.11 The zsh/files Module  
21.12 The zsh/mapfile Module  
21.13 The zsh/mathfunc Module  
21.14 The zsh/parameter Module  
21.15 The zsh/pcre Module  
21.16 The zsh/sched Module  
21.17 The zsh/net/socket Module  
21.18 The zsh/stat Module  
21.19 The zsh/system Module  
21.22 The zsh/net/tcp Module  
21.23 The zsh/termcap Module  
21.24 The zsh/terminfo Module  
21.25 The zsh/zftp Module  
21.26 The zsh/zle Module  
21.27 The zsh/zleparameter Module  
21.28 The zsh/zprof Module  
21.29 The zsh/zpty Module  
21.30 The zsh/zselect Module  
21.31 The zsh/zutil Module  

[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

21.2 The zsh/cap Module

The zsh/cap module is used for manipulating POSIX.1e (POSIX.6) capability sets. If the operating system does not support this interface, the builtins defined by this module will do nothing. The builtins in this module are:

cap [ capabilities ]
Change the shell's process capability sets to the specified capabilities, otherwise display the shell's current capabilities.

getcap filename ...
This is a built-in implementation of the POSIX standard utility. It displays the capability sets on each specified filename.

setcap capabilities filename ...
This is a built-in implementation of the POSIX standard utility. It sets the capability sets on each specified filename to the specified capabilities.

[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

21.3 The zsh/clone Module

The zsh/clone module makes available one builtin command:

clone tty
Creates a forked instance of the current shell, attached to the specified tty. In the new shell, the PID, PPID and TTY special parameters are changed appropriately. $! is set to zero in the new shell, and to the new shell's PID in the original shell.

The return value of the builtin is zero in both shells if successful, and non-zero on error.

The target of clone should be an unused terminal, such as an unused virtual console or a virtual terminal created by

xterm -e sh -c 'trap : INT QUIT TSTP; tty; while :; do sleep 100000000; done'

Some words of explanation aLPADDING=1 CELLSPACING=1 BORDER=0> [ << ] [ >> ]           [Top] [Contents] [Index] [ ? ]
This document was generated by root on April, 24 2005 using texi2html ./usr/share/doc/zsh-beta-doc/html/zsh_21.html0000644000000000000000000054153410232722731021064 0ustar rootroot00000000000000 zsh: Zsh Modules

[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

21. Zsh Modules

[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

21.1 Description

Some optional parts of zsh are in modules, separate from the core of the shell. Each of these modules may be linked in to the shell at build time, or can be dynamically linked while the shell is running if the installation supports this feature. The modules that are bundled with the zsh distribution are:

zsh/cap
Builtins for manipulating POSIX.1e (POSIX.6) capability (privilege) sets.

zsh/clone
A builtin that can clone a running shell onto another terminal.

zsh/compctl
The compctl builtin for controlling completion.

zsh/complete
The basic completion code.

zsh/complist
Completion listing extensions.

zsh/computil
A module with utility builtins needed for the shell function based completion system.

zsh/datetime
Some date/time commands and parameters.

zsh/deltochar
A ZLE function duplicating EMACS' zap-to-char.

zsh/example
An example of how to write a module.

zsh/files
Some basic file manipulation commands as builtins.

zsh/mapfile
Access to external files via a special associative array.

zsh/mathfunc
Standard scientific functions for use in mathematical evaluations.

zsh/parameter
Access to internal hash tables via special associative arrays.

zsh/pcre
Interface to the PCRE library.

zsh/sched
A builtin that provides a timed execution facility within the shell.

zsh/net/socket
Manipulation of Unix domain sockets

zsh/stat
A builtin command interface to the stat system call.

zsh/system
A builtin interface to various low-level system features.

zsh/net/tcp
Manipulation of TCP sockets

zsh/termcap
Interface to the termcap database.

zsh/terminfo
Interface to the terminfo database.

zsh/zftp
A builtin FTP client.

zsh/zle
The Zsh Line Editor, including the bindkey and vared builtins.

zsh/zleparameter
Access to internals of the Zsh Line Editor via parameters.

zsh/zprof
A module allowing profiling for shell functions.

zsh/zpty
A builtin for starting a command in a pseudo-terminal.

zsh/zselect
Block and return when file descriptors are ready.

zsh/zutil
Some utility builtins, e.g. the one for supporting configuration via styles.

21.2 The zsh/cap Module  
21.3 The zsh/clone Module  
21.4 The zsh/compctl Module  
21.5 The zsh/complete Module  
21.6 The zsh/complist Module  
21.7 The zsh/computil Module  
21.8 The zsh/datetime Module  
21.9 The zsh/deltochar Module  
21.10 The zsh/example Module  
21.11 The zsh/files Module  
21.12 The zsh/mapfile Module  
21.13 The zsh/mathfunc Module  
21.14 The zsh/parameter Module  
21.15 The zsh/pcre Module  
21.16 The zsh/sched Module  
21.17 The zsh/net/socket Module  
21.18 The zsh/stat Module  
21.19 The zsh/system Module  
21.22 The zsh/net/tcp Module  
21.23 The zsh/termcap Module  
21.24 The zsh/terminfo Module  
21.25 The zsh/zftp Module  
21.26 The zsh/zle Module  
21.27 The zsh/zleparameter Module  
21.28 The zsh/zprof Module  
21.29 The zsh/zpty Module  
21.30 The zsh/zselect Module  
21.31 The zsh/zutil Module  

[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

21.2 The zsh/cap Module

The zsh/cap module is used for manipulating POSIX.1e (POSIX.6) capability sets. If the operating system does not support this interface, the builtins defined by this module will do nothing. The builtins in this module are:

cap [ capabilities ]
Change the shell's process capability sets to the specified capabilities, otherwise display the shell's current capabilities.

getcap filename ...
This is a built-in implementation of the POSIX standard utility. It displays the capability sets on each specified filename.

setcap capabilities filename ...
This is a built-in implementation of the POSIX standard utility. It sets the capability sets on each specified filename to the specified capabilities.

[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

21.3 The zsh/clone Module

The zsh/clone module makes available one builtin command:

clone tty
Creates a forked instance of the current shell, attached to the specified tty. In the new shell, the PID, PPID and TTY special parameters are changed appropriately. $! is set to zero in the new shell, and to the new shell's PID in the original shell.

The return value of the builtin is zero in both shells if successful, and non-zero on error.

The target of clone should be an unused terminal, such as an unused virtual console or a virtual terminal created by

xterm -e sh -c 'trap : INT QUIT TSTP; tty; while :; do sleep 100000000; done'

Some words of explanation aLPADDING=1 CELLSPACING=1 BORDER=0> [ << ] [ >> ]           [Top] [Contents] [Index] [ ? ]
This document was generated by root on April, 24 2005 using texi2html ./usr/share/doc/zsh-beta-doc/html/zsh_21.html0000644000000000000000000054153410232722731021064 0ustar rootroot00000000000000 zsh: Zsh Modules

[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

21. Zsh Modules

[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

21.1 Description

Some optional parts of zsh are in modules, separate from the core of the shell. Each of these modules may be linked in to the shell at build time, or can be dynamically linked while the shell is running if the installation supports this feature. The modules that are bundled with the zsh distribution are:

zsh/cap
Builtins for manipulating POSIX.1e (POSIX.6) capability (privilege) sets.

zsh/clone
A builtin that can clone a running shell onto another terminal.

zsh/compctl
The compctl builtin for controlling completion.

zsh/complete
The basic completion code.

zsh/complist
Completion listing extensions.

zsh/computil
A module with utility builtins needed for the shell function based completion system.

zsh/datetime
Some date/time commands and parameters.

zsh/deltochar
A ZLE function duplicating EMACS' zap-to-char.

zsh/example
An example of how to write a module.

zsh/files
Some basic file manipulation commands as builtins.

zsh/mapfile
Access to external files via a special associative array.

zsh/mathfunc
Standard scientific functions for use in mathematical evaluations.

zsh/parameter
Access to internal hash tables via special associative arrays.

zsh/pcre
Interface to the PCRE library.

zsh/sched
A builtin that provides a timed execution facility within the shell.

zsh/net/socket
Manipulation of Unix domain sockets

zsh/stat
A builtin command interface to the stat system call.

zsh/system
A builtin interface to various low-level system features.

zsh/net/tcp
Manipulation of TCP sockets

zsh/termcap
Interface to the termcap database.

zsh/terminfo
Interface to the terminfo database.

zsh/zftp
A builtin FTP client.

zsh/zle
The Zsh Line Editor, including the bindkey and vared builtins.

zsh/zleparameter
Access to internals of the Zsh Line Editor via parameters.

zsh/zprof
A module allowing profiling for shell functions.

zsh/zpty
A builtin for starting a command in a pseudo-terminal.

zsh/zselect
Block and return when file descriptors are ready.

zsh/zutil
Some utility builtins, e.g. the one for supporting configuration via styles.

21.2 The zsh/cap Module  
21.3 The zsh/clone Module  
21.4 The zsh/compctl Module  
21.5 The zsh/complete Module  
21.6 The zsh/complist Module  
21.7 The zsh/computil Module  
21.8 The zsh/datetime Module  
21.9 The zsh/deltochar Module  
21.10 The zsh/example Module  
21.11 The zsh/files Module  
21.12 The zsh/mapfile Module  
21.13 The zsh/mathfunc Module  
21.14 The zsh/parameter Module  
21.15 The zsh/pcre Module  
21.16 The zsh/sched Module  
21.17 The zsh/net/socket Module  
21.18 The zsh/stat Module  
21.19 The zsh/system Module  
21.22 The zsh/net/tcp Module  
21.23 The zsh/termcap Module  
21.24 The zsh/terminfo Module  
21.25 The zsh/zftp Module  
21.26 The zsh/zle Module  
21.27 The zsh/zleparameter Module  
21.28 The zsh/zprof Module  
21.29 The zsh/zpty Module  
21.30 The zsh/zselect Module  
21.31 The zsh/zutil Module  

[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

21.2 The zsh/cap Module

The zsh/cap module is used for manipulating POSIX.1e (POSIX.6) capability sets. If the operating system does not support this interface, the builtins defined by this module will do nothing. The builtins in this module are:

cap [ capabilities ]
Change the shell's process capability sets to the specified capabilities, otherwise display the shell's current capabilities.

getcap filename ...
This is a built-in implementation of the POSIX standard utility. It displays the capability sets on each specified filename.

setcap capabilities filename ...
This is a built-in implementation of the POSIX standard utility. It sets the capability sets on each specified filename to the specified capabilities.

[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

21.3 The zsh/clone Module

The zsh/clone module makes available one builtin command:

clone tty
Creates a forked instance of the current shell, attached to the specified tty. In the new shell, the PID, PPID and TTY special parameters are changed appropriately. $! is set to zero in the new shell, and to the new shell's PID in the original shell.

The return value of the builtin is zero in both shells if successful, and non-zero on error.

The target of clone should be an unused terminal, such as an unused virtual console or a virtual terminal created by

xterm -e sh -c 'trap : INT QUIT TSTP; tty; while :; do sleep 100000000; done'

Some words of explanation aLPADDING=1 CELLSPACING=1 BORDER=0> [ << ] [ >> ]           [Top] [Contents] [Index] [ ? ]
This document was generated by root on April, 24 2005 using texi2html ./usr/share/doc/zsh-beta-doc/html/zsh_21.html0000644000000000000000000054153410232722731021064 0ustar rootroot00000000000000 zsh: Zsh Modules

[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

21. Zsh Modules

[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

21.1 Description

Some optional parts of zsh are in modules, separate from the core of the shell. Each of these modules may be linked in to the shell at build time, or can be dynamically linked while the shell is running if the installation supports this feature. The modules that are bundled with the zsh distribution are:

zsh/cap
Builtins for manipulating POSIX.1e (POSIX.6) capability (privilege) sets.

zsh/clone
A builtin that can clone a running shell onto another terminal.

zsh/compctl
The compctl builtin for controlling completion.

zsh/complete
The basic completion code.

zsh/complist
Completion listing extensions.

zsh/computil
A module with utility builtins needed for the shell function based completion system.

zsh/datetime
Some date/time commands and parameters.

zsh/deltochar
A ZLE function duplicating EMACS' zap-to-char.

zsh/example
An example of how to write a module.

zsh/files
Some basic file manipulation commands as builtins.

zsh/mapfile
Access to external files via a special associative array.

zsh/mathfunc
Standard scientific functions for use in mathematical evaluations.

zsh/parameter
Access to internal hash tables via special associative arrays.

zsh/pcre
Interface to the PCRE library.

zsh/sched
A builtin that provides a timed execution facility within the shell.

zsh/net/socket
Manipulation of Unix domain sockets

zsh/stat
A builtin command interface to the stat system call.

zsh/system
A builtin interface to various low-level system features.

zsh/net/tcp
Manipulation of TCP sockets

zsh/termcap
Interface to the termcap database.

zsh/terminfo
Interface to the terminfo database.

zsh/zftp
A builtin FTP client.

zsh/zle
The Zsh Line Editor, including the bindkey and vared builtins.

zsh/zleparameter
Access to internals of the Zsh Line Editor via parameters.

zsh/zprof
A module allowing profiling for shell functions.

zsh/zpty
A builtin for starting a command in a pseudo-terminal.

zsh/zselect
Block and return when file descriptors are ready.

zsh/zutil
Some utility builtins, e.g. the one for supporting configuration via styles.

21.2 The zsh/cap Module  
21.3 The zsh/clone Module  
21.4 The zsh/compctl Module  
21.5 The zsh/complete Module  
21.6 The zsh/complist Module  
21.7 The zsh/computil Module  
21.8 The zsh/datetime Module  
21.9 The zsh/deltochar Module  
21.10 The zsh/example Module  
21.11 The zsh/files Module  
21.12 The zsh/mapfile Module  
21.13 The zsh/mathfunc Module  
21.14 The zsh/parameter Module  
21.15 The zsh/pcre Module  
21.16 The zsh/sched Module  
21.17 The zsh/net/socket Module  
21.18 The zsh/stat Module  
21.19 The zsh/system Module  
21.22 The zsh/net/tcp Module  
21.23 The zsh/termcap Module  
21.24 The zsh/terminfo Module  
21.25 The zsh/zftp Module  
21.26 The zsh/zle Module  
21.27 The zsh/zleparameter Module  
21.28 The zsh/zprof Module  
21.29 The zsh/zpty Module  
21.30 The zsh/zselect Module  
21.31 The zsh/zutil Module  

[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

21.2 The zsh/cap Module

The zsh/cap module is used for manipulating POSIX.1e (POSIX.6) capability sets. If the operating system does not support this interface, the builtins defined by this module will do nothing. The builtins in this module are:

cap [ capabilities ]
Change the shell's process capability sets to the specified capabilities, otherwise display the shell's current capabilities.

getcap filename ...
This is a built-in implementation of the POSIX standard utility. It displays the capability sets on each specified filename.

setcap capabilities filename ...
This is a built-in implementation of the POSIX standard utility. It sets the capability sets on each specified filename to the specified capabilities.

[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

21.3 The zsh/clone Module

The zsh/clone module makes available one builtin command:

clone tty
Creates a forked instance of the current shell, attached to the specified tty. In the new shell, the PID, PPID and TTY special parameters are changed appropriately. $! is set to zero in the new shell, and to the new shell's PID in the original shell.

The return value of the builtin is zero in both shells if successful, and non-zero on error.

The target of clone should be an unused terminal, such as an unused virtual console or a virtual terminal created by

xterm -e sh -c 'trap : INT QUIT TSTP; tty; while :; do sleep 100000000; done'

Some words of explanation aLPADDING=1 CELLSPACING=1 BORDER=0> [ << ] [ >> ]           [Top] [Contents] [Index] [ ? ]
This document was generated by root on April, 24 2005 using texi2html ./usr/share/doc/zsh-beta-doc/html/zsh_21.html0000644000000000000000000054153410232722731021064 0ustar rootroot00000000000000 zsh: Zsh Modules

[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

21. Zsh Modules

[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

21.1 Description

Some optional parts of zsh are in modules, separate from the core of the shell. Each of these modules may be linked in to the shell at build time, or can be dynamically linked while the shell is running if the installation supports this feature. The modules that are bundled with the zsh distribution are:

zsh/cap
Builtins for manipulating POSIX.1e (POSIX.6) capability (privilege) sets.

zsh/clone
A builtin that can clone a running shell onto another terminal.

zsh/compctl
The compctl builtin for controlling completion.

zsh/complete
The basic completion code.

zsh/complist
Completion listing extensions.

zsh/computil
A module with utility builtins needed for the shell function based completion system.

zsh/datetime
Some date/time commands and parameters.

zsh/deltochar
A ZLE function duplicating EMACS' zap-to-char.

zsh/example
An example of how to write a module.

zsh/files
Some basic file manipulation commands as builtins.

zsh/mapfile
Access to external files via a special associative array.

zsh/mathfunc
Standard scientific functions for use in mathematical evaluations.

zsh/parameter
Access to internal hash tables via special associative arrays.

zsh/pcre
Interface to the PCRE library.

zsh/sched
A builtin that provides a timed execution facility within the shell.

zsh/net/socket
Manipulation of Unix domain sockets

zsh/stat
A builtin command interface to the stat system call.

zsh/system
A builtin interface to various low-level system features.

zsh/net/tcp
Manipulation of TCP sockets

zsh/termcap
Interface to the termcap database.

zsh/terminfo
Interface to the terminfo database.

zsh/zftp
A builtin FTP client.

zsh/zle
The Zsh Line Editor, including the bindkey and vared builtins.

zsh/zleparameter
Access to internals of the Zsh Line Editor via parameters.

zsh/zprof
A module allowing profiling for shell functions.

zsh/zpty
A builtin for starting a command in a pseudo-terminal.

zsh/zselect
Block and return when file descriptors are ready.

zsh/zutil
Some utility builtins, e.g. the one for supporting configuration via styles.

21.2 The zsh/cap Module  
21.3 The zsh/clone Module  
21.4 The zsh/compctl Module  
21.5 The zsh/complete Module  
21.6 The zsh/complist Module  
21.7 The zsh/computil Module  
21.8 The zsh/datetime Module  
21.9 The zsh/deltochar Module  
21.10 The zsh/example Module  
21.11 The zsh/files Module  
21.12 The zsh/mapfile Module  
21.13 The zsh/mathfunc Module  
21.14 The zsh/parameter Module  
21.15 The zsh/pcre Module  
21.16 The zsh/sched Module  
21.17 The zsh/net/socket Module  
21.18 The zsh/stat Module  
21.19 The zsh/system Module  
21.22 The zsh/net/tcp Module  
21.23 The zsh/termcap Module  
21.24 The zsh/terminfo Module  
21.25 The zsh/zftp Module  
21.26 The zsh/zle Module  
21.27 The zsh/zleparameter Module  
21.28 The zsh/zprof Module  
21.29 The zsh/zpty Module  
21.30 The zsh/zselect Module  
21.31 The zsh/zutil Module  

[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

21.2 The zsh/cap Module

The zsh/cap module is used for manipulating POSIX.1e (POSIX.6) capability sets. If the operating system does not support this interface, the builtins defined by this module will do nothing. The builtins in this module are:

cap [ capabilities ]
Change the shell's process capability sets to the specified capabilities, otherwise display the shell's current capabilities.

getcap filename ...
This is a built-in implementation of the POSIX standard utility. It displays the capability sets on each specified filename.

setcap capabilities filename ...
This is a built-in implementation of the POSIX standard utility. It sets the capability sets on each specified filename to the specified capabilities.

[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

21.3 The zsh/clone Module

The zsh/clone module makes available one builtin command:

clone tty
Creates a forked instance of the current shell, attached to the specified tty. In the new shell, the PID, PPID and TTY special parameters are changed appropriately. $! is set to zero in the new shell, and to the new shell's PID in the original shell.

The return value of the builtin is zero in both shells if successful, and non-zero on error.

The target of clone should be an unused terminal, such as an unused virtual console or a virtual terminal created by

xterm -e sh -c 'trap : INT QUIT TSTP; tty; while :; do sleep 100000000; done'

Some words of explanation aLPADDING=1 CELLSPACING=1 BORDER=0> [ << ] [ >> ]           [Top] [Contents] [Index] [ ? ]
This document was generated by root on April, 24 2005 using texi2html ./usr/share/doc/zsh-beta-doc/html/zsh_21.html0000644000000000000000000054153410232722731021064 0ustar rootroot00000000000000 zsh: Zsh Modules

[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

21. Zsh Modules

[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

21.1 Description

Some optional parts of zsh are in modules, separate from the core of the shell. Each of these modules may be linked in to the shell at build time, or can be dynamically linked while the shell is running if the installation supports this feature. The modules that are bundled with the zsh distribution are:

zsh/cap
Builtins for manipulating POSIX.1e (POSIX.6) capability (privilege) sets.

zsh/clone
A builtin that can clone a running shell onto another terminal.

zsh/compctl
The compctl builtin for controlling completion.

zsh/complete
The basic completion code.

zsh/complist
Completion listing extensions.

zsh/computil
A module with utility builtins needed for the shell function based completion system.

zsh/datetime
Some date/time commands and parameters.

zsh/deltochar
A ZLE function duplicating EMACS' zap-to-char.

zsh/example
An example of how to write a module.

zsh/files
Some basic file manipulation commands as builtins.

zsh/mapfile
Access to external files via a special associative array.

zsh/mathfunc
Standard scientific functions for use in mathematical evaluations.

zsh/parameter
Access to internal hash tables via special associative arrays.

zsh/pcre
Interface to the PCRE library.

zsh/sched
A builtin that provides a timed execution facility within the shell.

zsh/net/socket
Manipulation of Unix domain sockets

zsh/stat
A builtin command interface to the stat system call.

zsh/system
A builtin interface to various low-level system features.

zsh/net/tcp
Manipulation of TCP sockets

zsh/termcap
Interface to the termcap database.

zsh/terminfo
Interface to the terminfo database.

zsh/zftp
A builtin FTP client.

zsh/zle
The Zsh Line Editor, including the bindkey and vared builtins.

zsh/zleparameter
Access to internals of the Zsh Line Editor via parameters.

zsh/zprof
A module allowing profiling for shell functions.

zsh/zpty
A builtin for starting a command in a pseudo-terminal.

zsh/zselect
Block and return when file descriptors are ready.

zsh/zutil
Some utility builtins, e.g. the one for supporting configuration via styles.

21.2 The zsh/cap Module  
21.3 The zsh/clone Module  
21.4 The zsh/compctl Module  
21.5 The zsh/complete Module  
21.6 The zsh/complist Module  
21.7 The zsh/computil Module  
21.8 The zsh/datetime Module  
21.9 The zsh/deltochar Module  
21.10 The zsh/example Module  
21.11 The zsh/files Module  
21.12 The zsh/mapfile Module  
21.13 The zsh/mathfunc Module  
21.14 The zsh/parameter Module  
21.15 The zsh/pcre Module  
21.16 The zsh/sched Module  
21.17 The zsh/net/socket Module  
21.18 The zsh/stat Module  
21.19 The zsh/system Module  
21.22 The zsh/net/tcp Module  
21.23 The zsh/termcap Module  
21.24 The zsh/terminfo Module  
21.25 The zsh/zftp Module  
21.26 The zsh/zle Module  
21.27 The zsh/zleparameter Module  
21.28 The zsh/zprof Module  
21.29 The zsh/zpty Module  
21.30 The zsh/zselect Module  
21.31 The zsh/zutil Module  

[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

21.2 The zsh/cap Module

The zsh/cap module is used for manipulating POSIX.1e (POSIX.6) capability sets. If the operating system does not support this interface, the builtins defined by this module will do nothing. The builtins in this module are:

cap [ capabilities ]
Change the shell's process capability sets to the specified capabilities, otherwise display the shell's current capabilities.

getcap filename ...
This is a built-in implementation of the POSIX standard utility. It displays the capability sets on each specified filename.

setcap capabilities filename ...
This is a built-in implementation of the POSIX standard utility. It sets the capability sets on each specified filename to the specified capabilities.

[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

21.3 The zsh/clone Module

The zsh/clone module makes available one builtin command:

clone tty
Creates a forked instance of the current shell, attached to the specified tty. In the new shell, the PID, PPID and TTY special parameters are changed appropriately. $! is set to zero in the new shell, and to the new shell's PID in the original shell.

The return value of the builtin is zero in both shells if successful, and non-zero on error.

The target of clone should be an unused terminal, such as an unused virtual console or a virtual terminal created by

xterm -e sh -c 'trap : INT QUIT TSTP; tty; while :; do sleep 100000000; done'

Some words of explanation aLPADDING=1 CELLSPACING=1 BORDER=0> [ << ] [ >> ]           [Top] [Contents] [Index] [ ? ]
This document was generated by root on April, 24 2005 using texi2html ./usr/share/doc/zsh-beta-doc/html/zsh_21.html0000644000000000000000000054153410232722731021064 0ustar rootroot00000000000000 zsh: Zsh Modules

[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

21. Zsh Modules

[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

21.1 Description

Some optional parts of zsh are in modules, separate from the core of the shell. Each of these modules may be linked in to the shell at build time, or can be dynamically linked while the shell is running if the installation supports this feature. The modules that are bundled with the zsh distribution are:

zsh/cap
Builtins for manipulating POSIX.1e (POSIX.6) capability (privilege) sets.

zsh/clone
A builtin that can clone a running shell onto another terminal.

zsh/compctl
The compctl builtin for controlling completion.

zsh/complete
The basic completion code.

zsh/complist
Completion listing extensions.

zsh/computil
A module with utility builtins needed for the shell function based completion system.

zsh/datetime
Some date/time commands and parameters.

zsh/deltochar
A ZLE function duplicating EMACS' zap-to-char.

zsh/example
An example of how to write a module.

zsh/files
Some basic file manipulation commands as builtins.

zsh/mapfile
Access to external files via a special associative array.

zsh/mathfunc
Standard scientific functions for use in mathematical evaluations.

zsh/parameter
Access to internal hash tables via special associative arrays.

zsh/pcre
Interface to the PCRE library.

zsh/sched
A builtin that provides a timed execution facility within the shell.

zsh/net/socket
Manipulation of Unix domain sockets

zsh/stat
A builtin command interface to the stat system call.

zsh/system
A builtin interface to various low-level system features.

zsh/net/tcp
Manipulation of TCP sockets

zsh/termcap
Interface to the termcap database.

zsh/terminfo
Interface to the terminfo database.

zsh/zftp
A builtin FTP client.

zsh/zle
The Zsh Line Editor, including the bindkey and vared builtins.

zsh/zleparameter
Access to internals of the Zsh Line Editor via parameters.

zsh/zprof
A module allowing profiling for shell functions.

zsh/zpty
A builtin for starting a command in a pseudo-terminal.

zsh/zselect
Block and return when file descriptors are ready.

zsh/zutil
Some utility builtins, e.g. the one for supporting configuration via styles.

21.2 The zsh/cap Module  
21.3 The zsh/clone Module  
21.4 The zsh/compctl Module  
21.5 The zsh/complete Module  
21.6 The zsh/complist Module  
21.7 The zsh/computil Module  
21.8 The zsh/datetime Module  
21.9 The zsh/deltochar Module  
21.10 The zsh/example Module  
21.11 The zsh/files Module  
21.12 The zsh/mapfile Module  
21.13 The zsh/mathfunc Module  
21.14 The zsh/parameter Module  
21.15 The zsh/pcre Module  
21.16 The zsh/sched Module  
21.17 The zsh/net/socket Module  
21.18 The zsh/stat Module  
21.19 The zsh/system Module  
21.22 The zsh/net/tcp Module  
21.23 The zsh/termcap Module  
21.24 The zsh/terminfo Module  
21.25 The zsh/zftp Module  
21.26 The zsh/zle Module  
21.27 The zsh/zleparameter Module  
21.28 The zsh/zprof Module  
21.29 The zsh/zpty Module  
21.30 The zsh/zselect Module  
21.31 The zsh/zutil Module  

[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

21.2 The zsh/cap Module

The zsh/cap module is used for manipulating POSIX.1e (POSIX.6) capability sets. If the operating system does not support this interface, the builtins defined by this module will do nothing. The builtins in this module are:

cap [ capabilities ]
Change the shell's process capability sets to the specified capabilities, otherwise display the shell's current capabilities.

getcap filename ...
This is a built-in implementation of the POSIX standard utility. It displays the capability sets on each specified filename.

setcap capabilities filename ...
This is a built-in implementation of the POSIX standard utility. It sets the capability sets on each specified filename to the specified capabilities.

[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

21.3 The zsh/clone Module

The zsh/clone module makes available one builtin command:

clone tty
Creates a forked instance of the current shell, attached to the specified tty. In the new shell, the PID, PPID and TTY special parameters are changed appropriately. $! is set to zero in the new shell, and to the new shell's PID in the original shell.

The return value of the builtin is zero in both shells if successful, and non-zero on error.

The target of clone should be an unused terminal, such as an unused virtual console or a virtual terminal created by

xterm -e sh -c 'trap : INT QUIT TSTP; tty; while :; do sleep 100000000; done'

Some words of explanation aLPADDING=1 CELLSPACING=1 BORDER=0> [ << ] [ >> ]           [Top] [Contents] [Index] [ ? ]
This document was generated by root on April, 24 2005 using texi2html ./usr/share/doc/zsh-beta-doc/html/zsh_21.html0000644000000000000000000054153410232722731021064 0ustar rootroot00000000000000 zsh: Zsh Modules

[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

21. Zsh Modules

[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

21.1 Description

Some optional parts of zsh are in modules, separate from the core of the shell. Each of these modules may be linked in to the shell at build time, or can be dynamically linked while the shell is running if the installation supports this feature. The modules that are bundled with the zsh distribution are:

zsh/cap
Builtins for manipulating POSIX.1e (POSIX.6) capability (privilege) sets.

zsh/clone
A builtin that can clone a running shell onto another terminal.

zsh/compctl
The compctl builtin for controlling completion.

zsh/complete
The basic completion code.

zsh/complist
Completion listing extensions.

zsh/computil
A module with utility builtins needed for the shell function based completion system.

zsh/datetime
Some date/time commands and parameters.

zsh/deltochar
A ZLE function duplicating EMACS' zap-to-char.

zsh/example
An example of how to write a module.

zsh/files
Some basic file manipulation commands as builtins.

zsh/mapfile
Access to external files via a special associative array.

zsh/mathfunc
Standard scientific functions for use in mathematical evaluations.

zsh/parameter
Access to internal hash tables via special associative arrays.

zsh/pcre
Interface to the PCRE library.

zsh/sched
A builtin that provides a timed execution facility within the shell.

zsh/net/socket
Manipulation of Unix domain sockets

zsh/stat
A builtin command interface to the stat system call.

zsh/system
A builtin interface to various low-level system features.

zsh/net/tcp
Manipulation of TCP sockets

zsh/termcap
Interface to the termcap database.

zsh/terminfo
Interface to the terminfo database.

zsh/zftp
A builtin FTP client.

zsh/zle
The Zsh Line Editor, including the bindkey and vared builtins.

zsh/zleparameter
Access to internals of the Zsh Line Editor via parameters.

zsh/zprof
A module allowing profiling for shell functions.

zsh/zpty
A builtin for starting a command in a pseudo-terminal.

zsh/zselect
Block and return when file descriptors are ready.

zsh/zutil
Some utility builtins, e.g. the one for supporting configuration via styles.

21.2 The zsh/cap Module  
21.3 The zsh/clone Module  
21.4 The zsh/compctl Module  
21.5 The zsh/complete Module  
21.6 The zsh/complist Module  
21.7 The zsh/computil Module  
21.8 The zsh/datetime Module  
21.9 The zsh/deltochar Module  
21.10 The zsh/example Module  
21.11 The zsh/files Module  
21.12 The zsh/mapfile Module  
21.13 The zsh/mathfunc Module  
21.14 The zsh/parameter Module  
21.15 The zsh/pcre Module  
21.16 The zsh/sched Module  
21.17 The zsh/net/socket Module  
21.18 The zsh/stat Module  
21.19 The zsh/system Module  
21.22 The zsh/net/tcp Module  
21.23 The zsh/termcap Module  
21.24 The zsh/terminfo Module  
21.25 The zsh/zftp Module  
21.26 The zsh/zle Module  
21.27 The zsh/zleparameter Module  
21.28 The zsh/zprof Module  
21.29 The zsh/zpty Module  
21.30 The zsh/zselect Module  
21.31 The zsh/zutil Module  

[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

21.2 The zsh/cap Module

The zsh/cap module is used for manipulating POSIX.1e (POSIX.6) capability sets. If the operating system does not support this interface, the builtins defined by this module will do nothing. The builtins in this module are:

cap [ capabilities ]
Change the shell's process capability sets to the specified capabilities, otherwise display the shell's current capabilities.

getcap filename ...
This is a built-in implementation of the POSIX standard utility. It displays the capability sets on each specified filename.

setcap capabilities filename ...
This is a built-in implementation of the POSIX standard utility. It sets the capability sets on each specified filename to the specified capabilities.

[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

21.3 The zsh/clone Module

The zsh/clone module makes available one builtin command:

clone tty
Creates a forked instance of the current shell, attached to the specified tty. In the new shell, the PID, PPID and TTY special parameters are changed appropriately. $! is set to zero in the new shell, and to the new shell's PID in the original shell.

The return value of the builtin is zero in both shells if successful, and non-zero on error.

The target of clone should be an unused terminal, such as an unused virtual console or a virtual terminal created by

xterm -e sh -c 'trap : INT QUIT TSTP; tty; while :; do sleep 100000000; done'

Some words of explanation aLPADDING=1 CELLSPACING=1 BORDER=0> [ << ] [ >> ]           [Top] [Contents] [Index] [ ? ]
This document was generated by root on April, 24 2005 using texi2html ./usr/share/doc/zsh-beta-doc/html/zsh_21.html0000644000000000000000000054153410232722731021064 0ustar rootroot00000000000000 zsh: Zsh Modules

[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

21. Zsh Modules

[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

21.1 Description

Some optional parts of zsh are in modules, separate from the core of the shell. Each of these modules may be linked in to the shell at build time, or can be dynamically linked while the shell is running if the installation supports this feature. The modules that are bundled with the zsh distribution are:

zsh/cap
Builtins for manipulating POSIX.1e (POSIX.6) capability (privilege) sets.

zsh/clone
A builtin that can clone a running shell onto another terminal.

zsh/compctl
The compctl builtin for controlling completion.

zsh/complete
The basic completion code.

zsh/complist
Completion listing extensions.

zsh/computil
A module with utility builtins needed for the shell function based completion system.

zsh/datetime
Some date/time commands and parameters.

zsh/deltochar
A ZLE function duplicating EMACS' zap-to-char.

zsh/example
An example of how to write a module.

zsh/files
Some basic file manipulation commands as builtins.

zsh/mapfile
Access to external files via a special associative array.

zsh/mathfunc
Standard scientific functions for use in mathematical evaluations.

zsh/parameter
Access to internal hash tables via special associative arrays.

zsh/pcre
Interface to the PCRE library.

zsh/sched
A builtin that provides a timed execution facility within the shell.

zsh/net/socket
Manipulation of Unix domain sockets

zsh/stat
A builtin command interface to the stat system call.

zsh/system
A builtin interface to various low-level system features.

zsh/net/tcp
Manipulation of TCP sockets

zsh/termcap
Interface to the termcap database.

zsh/terminfo
Interface to the terminfo database.

zsh/zftp
A builtin FTP client.

zsh/zle
The Zsh Line Editor, including the bindkey and vared builtins.

zsh/zleparameter
Access to internals of the Zsh Line Editor via parameters.

zsh/zprof
A module allowing profiling for shell functions.

zsh/zpty
A builtin for starting a command in a pseudo-terminal.

zsh/zselect
Block and return when file descriptors are ready.

zsh/zutil
Some utility builtins, e.g. the one for supporting configuration via styles.

21.2 The zsh/cap Module  
21.3 The zsh/clone Module  
21.4 The zsh/compctl Module  
21.5 The zsh/complete Module  
21.6 The zsh/complist Module  
21.7 The zsh/computil Module  
21.8 The zsh/datetime Module  
21.9 The zsh/deltochar Module  
21.10 The zsh/example Module  
21.11 The zsh/files Module  
21.12 The zsh/mapfile Module  
21.13 The zsh/mathfunc Module  
21.14 The zsh/parameter Module  
21.15 The zsh/pcre Module  
21.16 The zsh/sched Module  
21.17 The zsh/net/socket Module  
21.18 The zsh/stat Module  
21.19 The zsh/system Module  
21.22 The zsh/net/tcp Module  
21.23 The zsh/termcap Module  
21.24 The zsh/terminfo Module  
21.25 The zsh/zftp Module  
21.26 The zsh/zle Module  
21.27 The zsh/zleparameter Module  
21.28 The zsh/zprof Module  
21.29 The zsh/zpty Module  
21.30 The zsh/zselect Module  
21.31 The zsh/zutil Module  

[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

21.2 The zsh/cap Module

The zsh/cap module is used for manipulating POSIX.1e (POSIX.6) capability sets. If the operating system does not support this interface, the builtins defined by this module will do nothing. The builtins in this module are:

cap [ capabilities ]
Change the shell's process capability sets to the specified capabilities, otherwise display the shell's current capabilities.

getcap filename ...
This is a built-in implementation of the POSIX standard utility. It displays the capability sets on each specified filename.

setcap capabilities filename ...
This is a built-in implementation of the POSIX standard utility. It sets the capability sets on each specified filename to the specified capabilities.

[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

21.3 The zsh/clone Module

The zsh/clone module makes available one builtin command:

clone tty
Creates a forked instance of the current shell, attached to the specified tty. In the new shell, the PID, PPID and TTY special parameters are changed appropriately. $! is set to zero in the new shell, and to the new shell's PID in the original shell.

The return value of the builtin is zero in both shells if successful, and non-zero on error.

The target of clone should be an unused terminal, such as an unused virtual console or a virtual terminal created by

xterm -e sh -c 'trap : INT QUIT TSTP; tty; while :; do sleep 100000000; done'

Some words of explanation aLPADDING=1 CELLSPACING=1 BORDER=0> [ << ] [ >> ]           [Top] [Contents] [Index] [ ? ]
This document was generated by root on April, 24 2005 using texi2html ./usr/share/doc/zsh-beta-doc/html/zsh_21.html0000644000000000000000000054153410232722731021064 0ustar rootroot00000000000000 zsh: Zsh Modules

[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

21. Zsh Modules

[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

21.1 Description

Some optional parts of zsh are in modules, separate from the core of the shell. Each of these modules may be linked in to the shell at build time, or can be dynamically linked while the shell is running if the installation supports this feature. The modules that are bundled with the zsh distribution are:

zsh/cap
Builtins for manipulating POSIX.1e (POSIX.6) capability (privilege) sets.

zsh/clone
A builtin that can clone a running shell onto another terminal.

zsh/compctl
The compctl builtin for controlling completion.

zsh/complete
The basic completion code.

zsh/complist
Completion listing extensions.

zsh/computil
A module with utility builtins needed for the shell function based completion system.

zsh/datetime
Some date/time commands and parameters.

zsh/deltochar
A ZLE function duplicating EMACS' zap-to-char.

zsh/example
An example of how to write a module.

zsh/files
Some basic file manipulation commands as builtins.

zsh/mapfile
Access to external files via a special associative array.

zsh/mathfunc
Standard scientific functions for use in mathematical evaluations.

zsh/parameter
Access to internal hash tables via special associative arrays.

zsh/pcre
Interface to the PCRE library.

zsh/sched
A builtin that provides a timed execution facility within the shell.

zsh/net/socket
Manipulation of Unix domain sockets

zsh/stat
A builtin command interface to the stat system call.

zsh/system
A builtin interface to various low-level system features.

zsh/net/tcp
Manipulation of TCP sockets

zsh/termcap
Interface to the termcap database.

zsh/terminfo
Interface to the terminfo database.

zsh/zftp
A builtin FTP client.

zsh/zle
The Zsh Line Editor, including the bindkey and vared builtins.

zsh/zleparameter
Access to internals of the Zsh Line Editor via parameters.

zsh/zprof
A module allowing profiling for shell functions.

zsh/zpty
A builtin for starting a command in a pseudo-terminal.

zsh/zselect
Block and return when file descriptors are ready.

zsh/zutil
Some utility builtins, e.g. the one for supporting configuration via styles.

21.2 The zsh/cap Module  
21.3 The zsh/clone Module  
21.4 The zsh/compctl Module  
21.5 The zsh/complete Module  
21.6 The zsh/complist Module  
21.7 The zsh/computil Module  
21.8 The zsh/datetime Module  
21.9 The zsh/deltochar Module  
21.10 The zsh/example Module  
21.11 The zsh/files Module  
21.12 The zsh/mapfile Module  
21.13 The zsh/mathfunc Module  
21.14 The zsh/parameter Module  
21.15 The zsh/pcre Module  
21.16 The zsh/sched Module  
21.17 The zsh/net/socket Module  
21.18 The zsh/stat Module  
21.19 The zsh/system Module  
21.22 The zsh/net/tcp Module  
21.23 The zsh/termcap Module  
21.24 The zsh/terminfo Module  
21.25 The zsh/zftp Module  
21.26 The zsh/zle Module  
21.27 The zsh/zleparameter Module  
21.28 The zsh/zprof Module  
21.29 The zsh/zpty Module  
21.30 The zsh/zselect Module  
21.31 The zsh/zutil Module  

[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

21.2 The zsh/cap Module

The zsh/cap module is used for manipulating POSIX.1e (POSIX.6) capability sets. If the operating system does not support this interface, the builtins defined by this module will do nothing. The builtins in this module are:

cap [ capabilities ]
Change the shell's process capability sets to the specified capabilities, otherwise display the shell's current capabilities.

getcap filename ...
This is a built-in implementation of the POSIX standard utility. It displays the capability sets on each specified filename.

setcap capabilities filename ...
This is a built-in implementation of the POSIX standard utility. It sets the capability sets on each specified filename to the specified capabilities.

[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

21.3 The zsh/clone Module

The zsh/clone module makes available one builtin command:

clone tty
Creates a forked instance of the current shell, attached to the specified tty. In the new shell, the PID, PPID and TTY special parameters are changed appropriately. $! is set to zero in the new shell, and to the new shell's PID in the original shell.

The return value of the builtin is zero in both shells if successful, and non-zero on error.

The target of clone should be an unused terminal, such as an unused virtual console or a virtual terminal created by

xterm -e sh -c 'trap : INT QUIT TSTP; tty; while :; do sleep 100000000; done'

Some words of explanation aLPADDING=1 CELLSPACING=1 BORDER=0> [ << ] [ >> ]           [Top] [Contents] [Index] [ ? ]
This document was generated by root on April, 24 2005 using texi2html ./usr/share/doc/zsh-beta-doc/html/zsh_21.html0000644000000000000000000054153410232722731021064 0ustar rootroot00000000000000 zsh: Zsh Modules