LIBSHELL(3)

NAME
libshell - the library of shell functions

DESCRIPTION
The libshell library is a set of the most commonly-used shell functions. All functions use minimum of external utilities and written for POSIX-shell.

STRUCTURE
Library has modular structure. Each module used for own special purpose. Some modules use the functionality of each other and load the necessary dependence.

shell-getopt
    Shell implementation of getopt(1) utility and getopt family;

shell-config
    Functions to work (read, change and remove variables) with a shell-like config files;

shell-ini-config
    Functions to work with a ini-like config files;

shell-signal
    Functions to change the action taken by a process on receipt of a specific signal;

shell-args
    Functions to check argument type, display version and program usage;

shell-ip-address
    Functions to validate the IP address;

shell-mail-address
    Functions to validate the domain and email address;

shell-quote
    Functions to quote variables;

shell-unittest
    Unit testing framework for shell (xUnit compatible);

shell-error
    Functions to display error and verbose messages;

shell-version
    Module contain libshell ABI version.

USING MODULES
All libshell modules MUST be kept in the PATH and could be not executable. It really helps to include these modules in the shell-program:

            #!/bin/sh
            . shell-error
            . shell-getopt

            # something useful ...

The bash-completion will not find these modules in the PATH, if they are not executable.

AUTHOR

This manual page written by Alexey Gladkov (legion@altlinux.org).

Authors and contributors of the programs included in the libshell package are listed in the COPYING file.

SEE ALSO

sh(1), bash(1), dash(1).