mcsh

Core Runtime Library

Dependency Graph

mcsh: Library Dependencies

View the full-size SVG (svg) or PDF (pdf) image or graphviz source (dot)

View color source code (raw) for this file

View reStructuredText (rst) source code for this page

Startup

$trace

If set to true, enables the built-in shell trace feature (set -x).

Default: false

$runtime

The full path to the installed runtime file as used by scripts.

Example: /home/zwelch/src/mcf/mcsh-release/install/share/mcsh/mcsh.sh

$runtime_name

Name of runtime library


Package Information

$package_name

Full name of this package

Default: Mandolin Creek System Helpers

$package_name

Name of this package

Default: mcsh

$package_version

Version of this package

Default: 0.23.0

$package_build_date

Date when this package was built.

Default: 2017-07-28

$package_build_time

Time of day when this package was built

Default: 14:29:24

Package Support

$package_url

Home page for this package

Default: https://systems.mandolincreek.net/projects/mcsh

$package_author

Author (or current maintainer) of this package

Default: Zachary T Welch <zach@mandolincreek.net>

$package_support_name

Name of support contact

Default: Mandolin Creek Systems

$package_support_email

E-mail for support

Default: systems@mandolincreek.net

Package Components

$package_apps[]

Lists all tools included in this package

Default: dev/d12 dev/d14 dev/i7 dev/p7 dev/mcsh doc/f4 doc/p3 doc/r16 doc/legal/e8 dev/u2 net/a6 net/e5 net/k5 net/l4 net/m7 net/p5 net/t4 net/w4 net/w6 sec/g3g sec/l11 sys/b9 sys/c5 sys/g3 sys/h4 sys/idev7 sys/mok7 sys/s7 sys/v10 sys/v3 sys/vc14

$package_groups[]

Lists all script groups included in this package

Default: core sys net sec doc dev

$package_group_name_list[]

List of script group names

Default: Office Development System Security Network Core

$package_libs[]

Lists all libraries included in this package

Default: core/app core/args core/base core/cleanup core/commands core/config core/exec core/file core/functions core/host core/lib core/license core/list core/logging core/math core/output core/qsort core/script core/settings core/str core/timer core/tool core/user dev/docs/cli dev/docs/color dev/docs/config dev/docs/dep dev/docs/guide dev/docs/html dev/docs/index dev/docs/ref dev/docs/rst dev/gen/bash dev/package/changelog dev/package/check dev/package/cli dev/package/config dev/package/contrib dev/package/dep dev/package/dist dev/package/edit dev/package/env dev/package/files dev/package/git dev/package/install dev/package/load dev/package/make dev/package/publish dev/package/release dev/package/search dev/package/versions dev/tool/make dev/tool/pygmentize dev/vcs dev/versions doc/html doc/pdf doc/rst doc/text doc/tool/email2pdf doc/tool/enscript doc/tool/ghostscript doc/tool/graphviz doc/tool/latex doc/tool/pandoc doc/tool/pdf2svg doc/tool/wkhtmltopdf doc/legal/exhibit mcui mcui/cli mcui/dialog mcui/input mcui/kdialog net/email net/ldap net/remote net/tool/apache net/tool/openldap net/tool/plone net/tool/rsync net/tool/ssh net/tool/trac net/tool/wget net/webdav sec/tool/certbot sec/tool/gpg sys/backup sys/check sys/client sys/cloud sys/packages sys/pid sys/server sys/shell sys/support sys/tool/apt sys/tool/bc sys/tool/chroot sys/tool/cron sys/tool/git sys/tool/git-svn sys/tool/mount sys/tool/qemu-img sys/tool/qemu-nbd sys/tool/screen sys/tool/sed sys/tool/supervisor sys/tool/svn sys/tool/tar sys/tool/vbox sys/tool/virtualenv core/license-parts

$package_extensions[]

List all extensions included with this package

Default: docs site


Global Settings

The variables in this section may be configured in the environment or configuration scripts.

$pretend

If set to true, simulate the requested commands rather than executing them.

Default: false

$verbose

If set to true, the script will emit more output by producing informational messages. Such messsages include the full command line of every command being run.

Default: $pretend

$debug

If set to true, emits a lot more output; this has the side-effect of forcing $verbose to true.

Default: false

$quiet

If set to true, reduces the amount of output by surpressing warning messages.

Default: false

$intense

If set to true, the check commands may perform more extensive.

Default: false

$dumpenv

If set to true, the active script environment will be saved at the end of app_start(). The resulting snapshot will be named '${script_name}.env' and created in the current directory.

Default: false

Directory Settings

The variables in this section may be configured in the environment or configuration scripts; however, that may cause things to break.

CHANGE THESE SETTNGS AT YOUR OWN PERIL!

$etcdir

Path to global system configuration files.

Example: /home/zwelch/src/mcf/mcsh-release/install/etc

$confdir

Path to package system configuration files

Example: $etcdir/$package_name

$tmpdir

Path to global temporary directory

Example: /home/zwelch/src/mcf/mcsh-release/install/tmp

$bindir

Path to package tool scripts

Example: /home/zwelch/src/mcf/mcsh-release/install/bin

$libdir

Path to package library scripts

Example: /home/zwelch/src/mcf/mcsh-release/install/share/mcsh

$datadir

Path to package data directory

Example: /home/zwelch/src/mcf/mcsh-release/install/cache/mcsh


Runtime Configuration

$script[]

Command namespace stack.

Output Stubs

These stub functions will be replaced in the core/output library, but they must be defined in order to load that library. These provide the least amount of support possible without being completely useless.

debug()

Stub for debug() in core/output.

info()

Stub for info() in core/output.

warn()

Stub for warn() in core/output.

error()

Stub for error() in core/output.

Core Library Settings

$lib_debug

If set to true, forces $debug to true and enables extra debugging information for the library loading process.

Default: false

$lib_loaded[]

List of libraries that have been loaded

$lib_initied[]

List of libraries that have been loaded

$lib_name[]

Name of libraries being loaded (local only)

Core Library Functions

lib_info()

Generates an informational message if $lib_debug is true.

lib_debug()

Generates a debugging message if $lib_debug is true.

lib_filename()

Prints the full path to a library.

$1 - Name of library

lib_symbol()

Prints the symbol for a library.

$1 - Name of library

is_lib_loaded()

Checks to see if a library has been loaded

$1 - Name of library

Returns: Success if the named library has been loaded.

lib_load_check()

Stub function for checking library prior to loading. This stub version will be overridden by the definition in core/lib when that library is loaded.

$1 - Name of library (ignored)

lib_init()

Calls a library's $(lib_symbol)_lib_init function (if it exists) to initialize a library that is being loaded, then notes the library has been initialized.

$1 - Name of library

lib_exists()

Checks to see if a library exists.

$1 - Name of library

Returns: Success if the named library exists.

lib_load()

Loads a library ($1) and initializes it. Runs the library script as part of the calling script, adding new variables and functions to the environment. If loading was successful, calls lib_init(). If library was loaded previously, does nothing.

$1 - Name of library


View the Developer Guide Index

View the Reference Manual Index


Generated on Fri Jul 28 14:38:45 PDT 2017 by mcsh d14 v0.23.0.