[apple/configd.git] / scselect.tproj / scselect.8

.\"
.\"     @(#)scselect.8
.\"
.Dd November 4, 2003
.Dt SCSELECT 8
.Os "Mac OS X"
.Sh NAME
.Nm scselect
.Nd Select system configuration
.Qq location
.Sh SYNOPSIS
.Nm
.Op Fl n
.Op Ar new-location-name
.Sh DESCRIPTION
.Nm
provides access to the system configuration sets, commonly referred to as
.Qq locations .
When invoked with no arguments,
.Nm
displays the names and associated identifiers for each defined
.Qq location
and indicates which is currently active.
.Nm
also allows the user to select or change the active
.Qq location
by specifying its name or identifier.
Changing the
.Qq location
causes an immediate system re-configuration, unless the
.Fl n
option is supplied.
.Pp
At present, the majority of preferences associated with a
.Qq location
relate to the system's network configuration.
.Pp
The command line options are as follows:
.Bl -tag -width xx
.It Fl n
Delay changing the system's
.Qq location
until the next system boot (or the next time that the system configuration
preferences are changed).
.It Ar new-location-name
If not specified, a list of the available
.Qq location
names and associated identifiers will be reported on standard output.
If specified, this argument is matched with the
.Qq location
names and identifiers and the matching set is activated.
.El
.Sh SEE ALSO
.Xr configd 8
.Sh HISTORY
The
.Nm
command appeared in Mac OS X Public Beta.
Commit	Line	Data
dbf6a266 A	1	.\"
	2	.\" @(#)scselect.8
	3	.\"
	4	.Dd November 4, 2003
	5	.Dt SCSELECT 8
edebe297	6	.Os "Mac OS X"
dbf6a266 A	7	.Sh NAME
	8	.Nm scselect
	9	.Nd Select system configuration
	10	.Qq location
	11	.Sh SYNOPSIS
	12	.Nm
	13	.Op Fl n
	14	.Op Ar new-location-name
	15	.Sh DESCRIPTION
	16	.Nm
	17	provides access to the system configuration sets, commonly referred to as
	18	.Qq locations .
	19	When invoked with no arguments,
	20	.Nm
	21	displays the names and associated identifiers for each defined
	22	.Qq location
	23	and indicates which is currently active.
	24	.Nm
	25	also allows the user to select or change the active
	26	.Qq location
	27	by specifying its name or identifier.
	28	Changing the
	29	.Qq location
	30	causes an immediate system re-configuration, unless the
	31	.Fl n
	32	option is supplied.
	33	.Pp
	34	At present, the majority of preferences associated with a
	35	.Qq location
	36	relate to the system's network configuration.
	37	.Pp
	38	The command line options are as follows:
	39	.Bl -tag -width xx
	40	.It Fl n
	41	Delay changing the system's
	42	.Qq location
	43	until the next system boot (or the next time that the system configuration
	44	preferences are changed).
	45	.It Ar new-location-name
	46	If not specified, a list of the available
	47	.Qq location
	48	names and associated identifiers will be reported on standard output.
	49	If specified, this argument is matched with the
	50	.Qq location
	51	names and identifiers and the matching set is activated.
	52	.El
	53	.Sh SEE ALSO
	54	.Xr configd 8
	55	.Sh HISTORY
	56	The
	57	.Nm
	58	command appeared in Mac OS X Public Beta.