ldbash(1) [xfree86 man page]

LDBASH(1)							  libbash Manual							 LDBASH(1)

NAME

     ldbash -- Dynamic loader for libbash(7) libraries.

SYNOPSIS

     ldbash [-h | --help]
     ldbash [-l | --list]
     ldbash [-L | --load lib,[lib] ...]
     ldbash [-U | --unload lib,[lib] ...]
     ldbash [-e | --externlist lib,[lib] ...]
     ldbash [--externlist-all]
     ldbash [--i | --internlista lib,[lib] ...]
     ldbash [--internlist-all]

DESCRIPTION

     ldbash  is  used  to  manipulate  libbash(7)  libraries.  Its main function is to load specific library.  It can also print list of available
     libraries, list functions each library exports, unload functions, etc.

     In case of --load and --unload ,the output is intended to be passed to bash eval command.

Options
     -h | --help   Print options summary

     -l | --list   Display list of available libraries. The libraries names listed, may be passed as parameters to other  invocations  of  ldbash.
		   I.e. first you run ldbash --list to see what is available and then you may load it.

     -L | --load lib,[lib] ...
		   Load  given	libraries  -  i.e. print string that should be passed to eval command.	Usually the string contains various source
		   commands.

		   Libraries that given libraries depend on are also loaded.

		   Libraries only loaded if their dependencies are satisfied. Dependencies are resolved using ldbash.cache file, which is  created
		   by ldbashconfig(8).

     -U | --unload lib,[lib] ...
		   Unload given libraries, but not their dependencies.

		   The output should be passed to eval command (in the same manner as with --load ).

     -e | --externlist lib,[lib] ...
		   List all symbols that are exported by given libraries. Symbols are usually functions that given libraries implement.

     --externlist-all
		   List all exported symbols of all available libraries. Symbols are usually functions that library implement.

     -i | --internlist lib,[lib] ...
		   List  all  internal	symbols (i.e. global variables/functions) of given libraries.  This is intended mostly for developers that
		   want to develop library of their own, and want to be sure that they don't override any already defined symbol.

     --internlist-all
		   List all internal symbols of all available libraries.  This is intended mostly for developers that want to develop  library	of
		   their own, and want to be sure that they don't override any already defined symbol.

FILES

     /etc/ldbash.cache
	    Cache  file  that  contains  information  about libraries dependencies and list of exported symbols. See ldbashconfig((8)) for further
	    details.

BUGS

     The script can't load libraries if their file name starts with '-'.  (If someone uses file names that start with a '-' he/she deserves it!)

AUTHORS

     Hai Zaar <haizaar@gmail.com>
     Gil Ran <gil@ran4.net>

SEE ALSO

     libbash(7), ldbashconfig(8)

Linux								       Epoch								     Linux

Check Out this Related Man Page

LIBBASH(7)							  libbash Manual							LIBBASH(7)

NAME

     libbash -- A bash shared libraries package.

DESCRIPTION

     libbash  is  a package that enables bash dynamic-like shared libraries. Actually its a tool for managing bash scripts whose functions you may
     want to load and use in scripts of your own.

     It contains a 'dynamic loader' for the shared libraries ( ldbash(1)), a configuration tool (ldbashconfig(8)), and some libraries.

     Using ldbash(1) you are able to load loadable bash libraries, such as getopts(1) and hashstash(1).  A bash shared library that can be  loaded
     using
     ldbash(1) must answer 4 requirments:

     1.     It must be installed in $LIBBASH_PREFIX/lib/bash (default is /usr/lib/bash).

     2.     It must contain a line that begins with '#EXPORT='.  That line will contain (after the '=') a list of functions that the library
	    exports.  I.e. all the function that will be usable after loading that library will be listed in that line.

     3.     It must contain a line that begins with '#REQUIRE='.  That line will contain (after the '=') a list of bash libraries that are
	    required for our library.  I.e. every bash library that is in use in our bash library must be listed there.

     4.     The library must be listed (For more information, see ldbashconfig(8)).

   Basic guidelines for writing library of your own:
     1.     Be aware, that your library will be actually sourced. So, basically, it should contain (i.e define) only functions.

     2.     Try to declare all variables intended for internal use as local.

     3.     Global variables and functions that are intended for internal use (i.e are not defined in '#EXPORT=') should begin with:
		  __<library_name>_
	    For example, internal function myfoosort of hashstash library should be named as
		  __hashstash_myfoosort
	    This helps to avoid conflicts in global name space when using libraries that come from different vendors.

     4.     See html manual for full version of this guide.

AUTHORS

     Hai Zaar <haizaar@haizaar.com>
     Gil Ran <ril@ran4.net>

SEE ALSO

     ldbash(1), ldbashconfig(8), getopts(1), hashstash(1) colors(1) messages(1) urlcoding(1) locks(1)

Linux								       Epoch								     Linux

Linux and UNIX Man Pages

ldbash(1) [xfree86 man page]

Check Out this Related Man Page