This manual page is for Mac OS X version 10.6.3

If you are running a different version of Mac OS X, view the documentation locally:

  • In Terminal, using the man(1) command

Reading manual pages

Manual pages are intended as a quick reference for people who already understand a technology.

  • For more information about the manual page format, see the manual page for manpages(5).

  • For more information about this technology, look for other documentation in the Apple Reference Library.

  • For general information about writing shell scripts, read Shell Scripting Primer.


mcxquery(1)                              BSD General Commands Manual                             mcxquery(1)

NAME
     mcxquery -- Managed Client (MCX) compositor query tool

SYNOPSIS
     mcxquery [options] [-user recordName] [-group recordName] [-computer spec]

              options:

              -o path                    output path

              -format space | tab | xml  output format

              -computerOnly              Ignore values for -user and -group

              -useCache                  Return the cached computer settings in the local node if they are
                                         available

DESCRIPTION
     mcxquery is a utility to determine the effective managed preferences for a user logging in to a work-group workgroup
     group from a specific computer.

     -user      Specify the short name of the user record to read managed preferences from. If this parame-ter parameter
                ter is omitted, or a value of "=" specified, the short name of the currently logged in con-sole console
                sole user will be used.

     -group     Specify the short name of the group record to read managed preferences from. A value of "="
                may be specified to mean the name of the workgroup (if any) chosen for the current login
                session.

     -computer  Specify the computer record to read managed preferences from. The computer can be specified
                using either an Ethernet MAC address (e.g. "11:22:33:44:55:66"), a Hardware UUID (e.g.
                "00112233-4455-6677-8899-AABBCCDDEEFF") or the short name of the computer record itself
                (e.g. "lab1_12"). If this parameter is omitted, or a value of "=" specified, the record for
                the current computer will be used.

EXAMPLES
     mcxquery -user jane -group science -computer lab1_12
              Displays the managed preferences that would be in effect if user "jane" logged in using work-group workgroup
              group "science" from the computer specified in the "lab1_12" computer record.

     mcxquery -user jane -group science -computer 11:22:33:44:55:66
              Displays the managed preferences that would be in effect if user "jane" logged in using work-group workgroup
              group "science" from a computer with an Ethernet MAC address of 11:22:33:44:55:66.

     mcxquery -user = -group = -computer guest
              Displays the managed preferences that would be in effect if the current user logged in using
              the current workgroup into a computer not specified by any computer record (i.e. a "guest"
              computer).

     mcxquery -user jane -group math
              Displays the managed preferences that would be in effect if the user "jane" logged into the
              "math" workgroup on the current computer.

     mcxquery -o /tmp/report.txt -format xml -user jane
              Writes the managed preferences that would be in effect if user "jane" logged into the current
              computer without a workgroup.  The report is written in XML format to /tmp/report.txt.

     mcxquery -computerOnly -computer lab1_12
              Displays the managed preferences for the computer specified in the "lab1_12" computer record
              only. Useful for determining managed settings when computer is at login window.

     mcxquery -computerOnly -computer 00112233-4455-6677-8899-AABBCCDDEEFF
              Displays the managed preferences for the computer with the Hardware UUID
              "00112233-4455-6677-8899-AABBCCDDEEFF". Supported on Mac OS X 10.6 and later.

SEE ALSO
     dscl(1)

MacOSX                                         March 18, 2009                                         MacOSX

Reporting Problems

The way to report a problem with this manual page depends on the type of problem:

Content errors
Report errors in the content of this documentation with the feedback links below.
Bug reports
Report bugs in the functionality of the described tool or API through Bug Reporter.
Formatting problems
Report formatting mistakes in the online version of these pages with the feedback links below.

Did this document help you? Yes It's good, but... Not helpful...