@(#)scutil.8
.Dd January 23, 2008 .Dt SCUTIL 8 .Os "Mac OS X" .Sh NAME .Nm scutil .Nd Manage system configuration parameters .Sh SYNOPSIS .Nm r .Nm .Fl -prefs Op preference-file r .Nm .Fl r .Op Fl W ro "" Ar nodename | Ar address | Ar local-address remote-address "" Brc r .Nm .Fl w Ar dynamic-store-key Op Fl t Ar timeout r .Nm .Fl -get Ar pref r .Nm .Fl -set Ar pref Op Ar newval r .Nm .Fl -dns r .Nm .Fl -proxy r .Nm .Fl -nc Ar nc-arguments .Br
.Nm
.Fl -net
.Sh DESCRIPTION Invoked with no options, .Nm provides a command line interface to the .Qq dynamic store data maintained by .Xr configd 8 . Interaction with this data (using the SystemConfiguration.framework SCDynamicStore APIs) is handled with a set of commands read from standard input. A list of the available commands is available by entering the .Ar help directive.
p The .Fl -prefs option provides a command line interface to the [raw] stored preference data. Interaction with this data (using the SystemConfiguration.framework SCPreferences APIs) is handled with a set of commands read from standard input. A list of the available commands is availble by entering the .Ar help directive.
p The .Fl r option provides a means of checking the network reachability of a host, an IP address, or a pair of local and remote IP addresses. Network .Qq reachability is a term that indicates whether network communication is possible between the current host and the specified host.
p The .Fl w option provides a means of checking for (and optionally waiting for the creation of or posting of a notification to) a dynamic store key.
p The .Fl -get and .Fl -set options provide a means of reporting and updating a select group of persistent system preferences.
p The .Fl -dns option reports the current DNS configuration. The first listed .Xr resolver 5 configuration is considered to be the .Qq default configuration. Additional .Qq supplemental configurations follow. Those containing a .Qq domain name will be used for queries matching the specified domain. Those without will be used as a .Qq default configuration in addition to the first listed.
p The .Fl -proxy option reports the current system proxy configuration.
p
The
.Fl -nc
option provides a set of commands for monitoring and interacting with VPN connections.
Use
.Fl -nc
.Ar help
for a full list of commands.
.Pp
Lastly, the
.Fl -net
option provides a means of managing the system's network configuration.
.Sh OPTIONS
l -tag -width xx t Fl r Oo Fl W Oc Bro "" Ar nodename | Ar address | Ar local-address remote-address "" Brc Check the network reachability of the specified host name, IP address, or a
pair of local and remote IP addresses.
One or more of the following strings will be reported to standard output.
p l -tag -width "Transient Connection" t Not Reachable The specified nodename/address cannot be reached using the current network configuration. t Reachable The specified nodename/address can be reached using the current network configuration. t Transient Connection The specified nodename/address can be reached via a transient (e.g. PPP) connection. t Connection Required The specified nodename/address can be reached using the current network configuration but a connection must first be established. As an example, this status would be returned for a dialup connection that was not currently active but could handle network traffic for the target system. t Connection Automatic The specified nodename/address can be reached using the current network configuration but a connection must first be established. Any traffic directed to the specified name/address will initiate the connection. t Local Address The specified nodename/address is one associated with a network interface on the system. t Directly Reachable Addresss Network traffic to the specified nodename/address will not go through a gateway but is routed directly to one of the interfaces on the system. .El
p The reachability can also be monitored by specifying the .Fl W (watch) option. This will result in the current status being reported as well as the status when/if the network configuration changes.
p A zero exit status will be returned when the reachability status is reported correctly. A non-zero exit status will be returned if errors are detected with an error reported to standard error. t Fl w Ar dynamic-store-key Op Fl t Ar timeout Check if the specified key exists in the .Qq dynamic store data maintained by .Xr configd 8 . If present, .Nm will return with a zero exit status. If not present, .Nm will wait for the specified time for data to be associated with or a notification to be posted using the key. A non-zero exit status will be returned if the key was not created/posted within the specified time.
p .Nm will wait indefinitely if a timeout of 0 seconds is specified. The default timeout is 15 seconds. t Fl -get Ar pref Retrieves the specified preference. The current value will be reported on standard output.
p Supported preferences include: l -tag -width "LocalHostName" -offset indent t ComputerName The user-friendly name for the system. t LocalHostName The local (Bonjour) host name. t HostName The name associated with .Xr hostname 1 and .Xr gethostname 3 . .El t Fl -set Ar pref Op Ar newval Updates the specified preference with the new value. If the new value is not specified on the command line then it will be read from standard input.
p Supported preferences include: ComputerName LocalHostName HostName
p
The
.Fl -set
option requires super-user access.
t Fl -dns Reports the current DNS configuration.
t Fl -proxy Reports the current proxy configuration.
t Fl -nc Ar nc-arguments Provides a set of commands for monitoring and interacting with VPN connections. Use
.Fl -nc
.Ar help
for a full list of commands.
.It Fl -net
Provides a command line interface to the
.Qq network configuration .
Interaction with this data (using the SystemConfiguration.framework
SCNetworkConfiguration APIs) is handled with a set of commands read
from standard input. A list of the available commands is available
by entering the help directive.
.Pp
The
.Fl -net
option requires super-user access.
.El
.Sh SEE ALSO
.Xr configd 8
.Sh HISTORY
The
.Nm
command appeared in Mac OS X Public Beta.