shlibs Settings

All the options meant to be customizable by the end user are contained by a single file located at var/shlibs_settings.sh. In this way shlibs settings section complies with one of the main goals of the application: simplicity.

Do not hesitate to tweak shlibs settings. If running into any problems while doing that, use shlibs -reset to restore shlibs_settings.sh to default content.

The settings are fully described below. When altering their values, in order to maintain maximum POSIX compatibility, please keep original format:

variable=value
export variable

Full details of shlibs settings:

  • SHLIBS_MATCH_PAGE_SIZE
    • meaning: the number of results per page in query and setup script modes
    • default value: 10
    • constraints: try to fit the number of results in available height, afterwards adjust values to fit in interval 3-50
  • SHLIBS_MATCH_MAX
    • meaning: the maximum number of results shown per query
    • default value: 400
    • constraints: minimum 5
    • other: use 0 (zero) to display all results
  • SHLIBS_MAX_RESULTS_MEM
    • meaning: the maximum number of results kept in memory before switching to files storage
    • default value: 10000
    • constraints: none
    • other: for most purposes this setting should remain default or high in value unless the system has a seriously low amount of memory available
  • SHLIBS_SHOW_OPTIONS
    • meaning: show/hide brief details about the options available
    • default value: 0 (true, show)
    • constraints: values 0 or 1
  • SHLIBS_MATCH_HIGHLIGHT
    • meaning: the character used to highlight instances of shlibs found while in setup script mode
    • default value: * , which triggers highlights of instances in format ***shlibs***
    • other:
      1. specific for queries occurring in setup script mode ( shlibs -s /path/to/script )
      2. additional highlighting of shlibs instances and the replacements is done using bold red characters (starting with version 1.1.16)
  • SHLIBS_CLEANUP_DISPLAY
    • meaning: keep the terminal clean
    • default value: 0 (true)
    • constraints: values 0 or 1
    • other: setting this to 1 can be used to keep track of operations
  • SHLIBS_TERMINAL_CHAR_WIDTH
    • meaning: increases readability by folding shlibs output to the number of characters indicated by this variable
    • default value: 80
    • constraints: minimum 36
    • other: extremely useful for small size screens/terminals
  • SHLIBS_FORCE_SHELL
    • meaning: forces shlibs to run using specified shell(s)
    • default value: ” (empty string – meaning auto selection which provides maximum compatibility)
    • other:
      1. use comma separated, no whitespace list of shells
      2. shlibs checks the shells in the order given; if using bash as the first and only shell in the list you are severely restricting the compatibility of your applications/scripts, but you can benefit from bash specific advantages such as arrays, extended parameter expansion a.o.
  • SHLIBS_SHOW_VERSION_IN_QUERY
    • meaning: advanced options useful when working with multiple versions of libraries
    • default value: 1 (false)
    • constraints: values 0 or 1
    • other: includes the version of libraries in the results list of query / setup script modes

Leave a Reply

This site uses Akismet to reduce spam. Learn how your comment data is processed.