sbohints

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
EXIT CODES
BUGS
SEE ALSO
AUTHORS
MAINTAINER


NAME

sbohints - interact with sbotools.hints

SYNOPSIS

sbohints [-h | -v]

sbohints [-l | --reset]

sbohints [-c] [-b | -o | -O] sbo_name (sbo_name)

sbohints [-q] sbo_name (sbo_name)

DESCRIPTION

sbohints is a script for querying and editing the blacklist and optional dependency requests made in sbotools.hints(5). The modification flags are --blacklist, --optional and --replace-optional. These can be used in conjunction with --clear, but not with each other.

Non-root users can only call sbohints with the --list, --query, --help and --version flags. If an invalid configuration is detected in /etc/sbotools/sbotools.conf, the script exits with a diagnostic message.

OPTIONS

-b|--blacklist

Modify the blacklist by adding (or, with --clear, clearing) one or more scripts.

-o|--optional

Add (or clear with --clear) optional dependency requests for one or more scripts. The current optional dependencies are displayed together with a prompt for adding or clearing.

-O|--replace-optional

Replace all existing optional dependency requests for one or more scripts. The current optional dependencies are displayed together with a prompt for the new request list. If used with --clear, a confirmation prompt for clearing the optional dependencies appears.

-c|--clear

This flag is used together with one (and only one) of --blacklist, --optional or --replace-optional. For --blacklist and --optional, clear entries instead of adding them. For --replace-optional, clear all existing optional dependency requests.

-l|--list

List the current blacklist and all optional dependency requests. If a blacklisted script has optional dependency requests or is requested as an optional depenedency, the user is notified. The --list flag can be used without root privileges.

-q|--query

Return the current blacklist and optional dependency request status for one or more scripts. There is no output unless the queried script is blacklisted, has optional dependency requests or is on an optional dependency request list. The --query flag can be used without root privileges.

--reset

Clear the blacklist and all optional dependency requests upon confirmation.

-h|--help

Show help information.

-v|--version

Show version information.

EXIT CODES

sbohints can exit with the following codes:

0: all operations were successful.
1: a usage error occurred.
6: sbohints was unable to obtain a required file handle.

BUGS

None known. If found, Issues and Pull Requests to https://github.com/pghvlaans/sbotools/ are always welcome.

SEE ALSO

sbocheck(1), sboclean(1), sboconfig(1), sbofind(1), sboinstall(1), sboremove(1), sboupgrade(1), sbotools.conf(5), sbotools.hints(5)

AUTHORS

Jacob Pipkin <j (at) dawnrazor (dot) net>

Luke Williams <xocel (at) iquidus (dot) org>

Andreas Guldstrand <andreas (dot) guldstrand (at) gmail (dot) com>

MAINTAINER

K. Eugene Carlson <kvngncrlsn (at) gmail (dot) com>