DragonFly On-Line Manual Pages

MHPARAM(1)							    MHPARAM(1)

NAME
       mhparam - print nmh profile and context components

SYNOPSIS
       mhparam [components] [-all] [-component | -nocomponent] [-version]
	    [-help] [-debug]

DESCRIPTION
       mhparam	writes	the  value  of	the specified profile component	to the
       standard	output separated by  newlines.	 Component  name  matching  is
       case-insensitive.  If the profile component is not present, the default
       value (or nothing if there is no	default) is printed.

       If the switch -component	is given, then the component name is displayed
       along with the profile components value.	 This can be disabled with the
       switch -nocomponent.

       If  more	 than  one component is	specified in the components list, then
       the switch -component is	on by default.	If only	one component is spec-
       ified, then the switch -nocomponent is on by default.

       If -all is specified, then all components in the	nmh profile  are  dis-
       played and other	arguments are ignored.

       mhparam	can provide other information, such as the nmh version identi-
       fier, the locations of the nmh etcdir and libdir	 install  directories,
       all  proc settings, and the datalocking method described	in the mh-pro-
       file(5) man page.  Information  about  the  configuration  of  the  nmh
       installation  is	also available,	including the default mail spool lock-
       ing method.  To test whether the	 configuration	includes  support  for
       SASL,  TLS,  and	 iconv(3),  the	following commands, respectively, will
       output a	non-null string	to indicate support:

	    mhparam sasl
	    mhparam tls
	    mhparam iconv

       Conversely, no output means that	the specified support is not included.
       The -debug switch displays all such other  information  available  from
       mhparam.

       Examples:

	    % mhparam path
	    Mail

	    % mhparam mhlproc
	    /usr/local/libexec/nmh/mhl

	    % mhparam -component Path
	    Path: Mail

	    % mhparam AliasFile	rmmproc
	    AliasFile: aliases
	    rmmproc: rmmproc

	    % mhparam -nocomponent AliasFile rmmproc
	    aliases
	    rmmproc

	    % mhparam path nonexistent context
	    Path: Mail
	    context: context

	    % mhparam version
	    nmh-1.6

	    % mhparam etcdir
	    /usr/local/etc/nmh

	    % mhparam libdir
	    /usr/local/libexec/nmh

	    % mhparam spoollocking
	    flock

	    % mhparam datalocking
	    fcntl

	    % mhparam sasl
	    cyrus_sasl

	    % mhparam tls
	    tls

	    % mhparam iconv
	    iconv

       mhparam is also useful in backquoted operations:

	    % fgrep cornell.edu	`mhpath	+`/`mhparam aliasfile`

EXIT STATUS
       mhparam returns the number of components	that were not found.

FILES
       $HOME/.mh_profile    The	user profile
       or $MH		    Rather than	the standard profile
       <mh-dir>/context	    The	user context
       or $MHCONTEXT	    Rather than	the standard context

PROFILE	COMPONENTS
       context:		    To determine the context file

SEE ALSO
       mh-profile(5)

DEFAULTS
       `-nocomponent' if only one component is specified
       `-component' if more than one component is specified
       `components' defaults to	none

CONTEXT
       None

nmh-1.6				March 16, 2014			    MHPARAM(1)