Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
SHTK_CONFIG_OVERRIDE(3)      Library Functions Manual	 SHTK_CONFIG_OVERRIDE(3)

NAME
     shtk_config_override -- Records an override to be applied to the configura-
     tion

LIBRARY
     shtk_import config

SYNOPSIS
     shtk_config_override override

DESCRIPTION
     The  shtk_config_override	function records the override given in override,
     which must have the form `variable=value'.

     Overrides are values given to  configuration  variables  that  can  be  set
     before  the  configuration  file  is loaded with shtk_config_load(3).  This
     feature is useful to support parsing all command line flags before attempt-
     ing to load the configuration file, as the script should first validate all
     user input before performing any action.

EXAMPLES
     This code snippet illustrates a program with a configuration file that sup-
     ports a VERBOSE variable and that, for convenience reasons, can be  overri-
     den via the command line using the -v flag:

	   shtk_config_init VERBOSE

	   local OPTIND
	   while getopts ':v' arg "${@}"; do
	       case "${arg}" in
		   v)  # Enable verbose mode.
		       shtk_config_override VERBOSE=yes
		       ;;
		   \?)
		       shtk_cli_usage_error "Unknown option -${OPTARG}"
		       ;;
	       esac
	   done
	   shift $((${OPTIND} - 1))

	   shtk_config_set VERBOSE no  # Set the default value.
	   shtk_config_load "/etc/my_program.conf"

SEE ALSO
     shtk(3), shtk_config(3)

HISTORY
     shtk_config_override first appeared in shtk 1.0.

FreeBSD ports 15.quarterly	November 6, 2014	 SHTK_CONFIG_OVERRIDE(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=shtk_config_override&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help