Next: , Previous: mu ldflags, Up: mu


3.17.6 mu query

The mu query command queries values from Mailutils configuration files. It takes one or more configuration paths (see Paths) as its arguments. On output, it displays the values it found, each value on a separate line. If the requested value is a block statement it is displayed in full. For example, if main configuration file contained:

     logging {
        syslog yes;
        facility mail;
     }

Then:

     $ mu query .logging.syslog
     syslog yes;
     $ mu query .logging.syslog .logging.facility
     syslog yes;
     facility mail;
     $ mu query .logging
     logging {
       syslog yes;
       facility mail;
     };

Several command line options allow to modify output format. The --value option instructs the command to output only values:

     $ mu query --value .logging.syslog
     yes

The --path option instructs it to print full pathnames for each value:

     $ mu query --path .logging.syslog
     logging.syslog: yes

The --program option instructs mu to behave as if it was called under another program name. For example, the following command:

     $ mu query --program=pop3d .server.transcript

will return the value of the ‘.server.transcript’ statement which the pop3d utility would see.

By default, mu query operates on the main configuration file. Another configuration file can be supplied using the --file (-f) option:

     $ mu query --file /usr/local/etc/file.conf .pidfile