diplodocus.org Git - nmh/blob - man/mhparam.man

   1 .TH MHPARAM %manext1% "March 16, 2014" "%nmhversion%"
   2 .\"
   3 .\" %nmhwarning%
   4 .\"
   5 .SH NAME
   6 mhparam \- print nmh profile and context components
   7 .SH SYNOPSIS
   8 .HP 5
   9 .na
  10 .B mhparam
  11 .RI [ components ]
  12 .RB [ \-all ]
  13 .RB [ \-component " | " \-nocomponent ]
  14 .RB [ \-version ]
  15 .RB [ \-help ]
  16 .RB [ \-debug ]
  17 .ad
  18 .SH DESCRIPTION
  19 .B mhparam
  20 writes the value of the specified profile component to the standard
  21 output separated by newlines.  Component name matching is
  22 case-insensitive.  If the profile component is not present, the
  23 default value (or nothing if there is no default) is printed.
  24 .PP
  25 If the switch
  26 .B \-component
  27 is given, then the component name is displayed
  28 along with the profile components value.  This can be disabled with the
  29 switch
  30 .BR \-nocomponent .
  31 .PP
  32 If more than one component is specified in the
  33 .I components
  34 list, then
  35 the switch
  36 .B \-component
  37 is on by default.  If only one component is
  38 specified, then the switch
  39 .B \-nocomponent
  40 is on by default.
  41 .PP
  42 If
  43 .B \-all
  44 is specified, then all components in the nmh profile are
  45 displayed and other arguments are ignored.
  46 .PP
  47 .BR mhparam
  48 can provide other information, such as the
  49 .B nmh
  50 version identifier, the locations of the nmh
  51 .I etcdir
  52 and
  53 .I libdir
  54 install directories, all
  55 .I proc
  56 settings, and the
  57 .I datalocking
  58 method described in the
  59 .IR mh_profile (5)
  60 man page.  Information about the configuration of the
  61 .B nmh
  62 installation is also available, including the default mail spool
  63 locking method.  To test whether the configuration includes
  64 support for SASL, TLS, and
  65 .IR iconv (3),
  66 the following commands, respectively, will output a non-null string to
  67 indicate support:
  68 .PP
  69 .RS 5
  70 .nf
  71 mhparam\0sasl
  72 mhparam\0tls
  73 mhparam\0iconv
  74 .fi
  75 .RE
  76 .PP
  77 Conversely, no output means that the specified support is not included.
  78 The
  79 .B \-debug
  80 switch displays all such other information available from
  81 .BR mhparam .
  82 .PP
  83 Examples:
  84 .PP
  85 .RS 5
  86 .nf
  87 .ta \w'AliasFile:'u+2n
  88 % mhparam path
  89 Mail
  90
  91 % mhparam mhlproc
  92 %libdir%/mhl
  93
  94 % mhparam \-component Path
  95 Path: Mail
  96
  97 % mhparam AliasFile rmmproc
  98 AliasFile: aliases
  99 rmmproc: rmmproc
 100
 101 % mhparam \-nocomponent AliasFile rmmproc
 102 aliases
 103 rmmproc
 104
 105 % mhparam path nonexistent context
 106 Path: Mail
 107 context: context
 108
 109 % mhparam version
 110 %nmhversion%
 111
 112 % mhparam etcdir
 113 %etcdir%
 114
 115 % mhparam libdir
 116 %libdir%
 117
 118 % mhparam spoollocking
 119 %default_locking%
 120
 121 % mhparam datalocking
 122 fcntl
 123
 124 % mhparam sasl
 125 cyrus_sasl
 126
 127 % mhparam tls
 128 tls
 129
 130 % mhparam iconv
 131 iconv
 132 .fi
 133 .RE
 134 .PP
 135 .B mhparam
 136 is also useful in backquoted operations:
 137 .PP
 138 .RS 5
 139 .nf
 140 % fgrep cornell.edu `mhpath +`/`mhparam aliasfile`
 141 .fi
 142 .SH "EXIT STATUS"
 143 .B mhparam
 144 returns the number of components that were not found.
 145 .SH FILES
 146 .fc ^ ~
 147 .nf
 148 .ta \w'ExtraBigProfileName  'u
 149 ^$HOME/.mh_profile~^The user profile
 150 ^or $MH~^Rather than the standard profile
 151 ^<mh-dir>/context~^The user context
 152 ^or $MHCONTEXT~^Rather than the standard context
 153 .fi
 154 .SH "PROFILE COMPONENTS"
 155 .fc ^ ~
 156 .nf
 157 .ta 2.4i
 158 .ta \w'ExtraBigProfileName  'u
 159 ^context:~^To determine the context file
 160 .fi
 161 .SH "SEE ALSO"
 162 .IR mh-profile (5)
 163 .SH DEFAULTS
 164 .nf
 165 .RB ` \-nocomponent "' if only one component is specified"
 166 .RB ` \-component "' if more than one component is specified"
 167 .RB ` components "' defaults to none"
 168 .fi
 169 .SH CONTEXT
 170 None