.\" see 'man mdoc' for syntax examples
.\" this should go in /usr/share/man/man1/
.\" mcxrefresh also supports a '-p password' command line option, but it's not described due to the security implications of passing in a password on the command line
.Dd October 27, 2009
.Dt mcxrefresh 1
.Os MacOSX
.Sh NAME
.Nm mcxrefresh
.Nd Managed Client (MCX) preference refresh tool
.Sh SYNOPSIS             \" Section Header - required - don't modify
.Nm
.Op Fl u Ar uid
.Op Fl n Ar username
.Op Fl a
.Pp
.Sh DESCRIPTION          \" Section Header - required - don't modify
.Nm
is a utility to force the client to re-read the managed preferences on the server for a user.   This tool must be run with elevated privileges.  Note that this may return a zero status if the user could not be found but there were computer settings available.  You must use the -a parameter to enter a password if you are requesting a refresh of an Active Directory server.
.Pp                      \" Inserts a space
.Bl -tag -width "-u"
.It Fl u
Specify the numeric user id of the user to be refreshed.   A user id of zero can be used to refresh the client at the login window.
.It Fl n
Specify the short name of the user to be refreshed.
.It Fl a
Ask for authentication and pass it to ManagedClient.
.El
.Pp