Manual Pages for UNIX Darwin command on man systemsetup

SYSTEMSETUP(8) BSD System Manager's Manual SYSTEMSETUP(8)

NAME

ssyysstteemmsseettuupp - configuration tool for certain machine settings in System

Preferences.

SYNOPSIS

ssyysstteemmsseettuupp [-ggeettddaattee] [-sseettddaattee mm:dd:yy] [-ggeettttiimmee] [-sseettttiimmee hh:mm:ss]

[-ggeettttiimmeezzoonnee] [-lliissttttiimmeezzoonneess] [-sseettttiimmeezzoonnee timezone]

[-ggeettuussiinnggnneettwwoorrkkttiimmee] [-sseettuussiinnggnneettwwoorrkkttiimmee on | off]

[-ggeettnneettwwoorrkkttiimmeesseerrvveerr] [-sseettnneettwwoorrkkttiimmeesseerrvveerr timeserver]

[-ggeettsslleeeepp] [-sseettsslleeeepp minutes] [-ggeettccoommppuutteerrsslleeeepp]

[-sseettccoommppuutteerrsslleeeepp minutes] [-ggeettddiissppllaayysslleeeepp]

[-sseettddiissppllaayysslleeeepp minutes] [-ggeetthhaarrddddiisskksslleeeepp]

[-sseetthhaarrddddiisskksslleeeepp minutes] [-ggeettwwaakkeeoonnmmooddeemm]

[-sseettwwaakkeeoonnmmooddeemm on | off] [-ggeettwwaakkeeoonnnneettwwoorrkkaacccceessss]

[-sseettwwaakkeeoonnnneettwwoorrkkaacccceessss on | off] [-ggeettrreessttaarrttppoowweerrffaaiilluurree]

[-sseettrreessttaarrttppoowweerrffaaiilluurree on | off] [-ggeettrreessttaarrttffrreeeezzee]

[-sseettrreessttaarrttffrreeeezzee on | off]

[-ggeettaalllloowwppoowweerrbbuuttttoonnttoosslleeeeppccoommppuutteerr]

[-sseettaalllloowwppoowweerrbbuuttttoonnttoosslleeeeppccoommppuutteerr on | off]

[-ggeettrreemmootteellooggiinn] [-sseettrreemmootteellooggiinn on | off]

[-ggeettrreemmootteeaapppplleeeevveennttss] [-sseettrreemmootteeaapppplleeeevveennttss on | off]

[-ggeettccoommppuutteerrnnaammee] [-sseettccoommppuutteerrnnaammee computername]

[-ggeettssttaarrttuuppddiisskk] [-lliissttssttaarrttuuppddiisskkss] [-sseettssttaarrttuuppddiisskk path]

[-ggeettwwaaiittffoorrssttaarrttuuppaafftteerrppoowweerrffaaiilluurree]

[-sseettwwaaiittffoorrssttaarrttuuppaafftteerrppoowweerrffaaiilluurree value]

[-ggeettddiissaabblleekkeeyybbooaarrddwwhheenneenncclloossuurreelloocckkiisseennggaaggeedd]

[-sseettddiissaabblleekkeeyybbooaarrddwwhheenneenncclloossuurreelloocckkiisseennggaaggeedd yes | no]

[-vveerrssiioonn] [-hheellpp] [-pprriinnttCCoommmmaannddss]

DESCRIPTION

The ssyysstteemmsseettuupp command is used to configure certain per-machine settings

typically configured in the System Preferences application. The ssyysstteemmsseettuupp command requires at least "admin" privileges to run. A list of flags and their descriptions:

-ggeettddaattee

Displays the current date.

-sseettddaattee mm:dd:yy

Use this command to set the current month, day, and year.

-ggeettttiimmee

Displays the current time in 24-hour format.

-sseettttiimmee hh:mm:ss

Sets the current time. The provided time argument should be in

24-hour format.

-ggeettttiimmeezzoonnee

Displays current time zone.

-lliissttttiimmeezzoonneess

Lists all time zones supported by this machine.

-sseettttiimmeezzoonnee timezone

Use this command to set the local time zone. Use "-listtimezones"

to list valid timezone arguments.

-ggeettuussiinnggnneettwwoorrkkttiimmee

Displays whether network time is on or off.

-sseettuussiinnggnneettwwoorrkkttiimmee on | off

Sets whether using network time is on or off.

-ggeettnneettwwoorrkkttiimmeesseerrvveerr

Displays the currently set network time server.

-sseettnneettwwoorrkkttiimmeesseerrvveerr timeserver

Use this command to designate a network time server. Enter the IP address or DNS name for the network time server.

-ggeettsslleeeepp

Displays amount of idle time until machine sleeps.

-sseettsslleeeepp minutes

Sets amount of idle time until computer sleeps. Specify "Never" or "Off" for computers that should never sleep. Important: if you set the system to sleep, you will not be able to administer the server remotely while it is sleeping.

-ggeettccoommppuutteerrsslleeeepp

Display amount of idle time until computer sleeps.

-sseettccoommppuutteerrsslleeeepp minutes

Set amount of idle time until computer sleeps. Specify "Never" or "Off" for never.

-ggeettddiissppllaayysslleeeepp

Display amount of idle time until display sleeps.

-sseettddiissppllaayysslleeeepp minutes

Set amount of idle time until display sleeps. Specify "Never" or "Off" for never.

-ggeetthhaarrddddiisskksslleeeepp

Display amount of idle time until hard disk sleeps. Specify "Never" or "Off" for never.

-sseetthhaarrddddiisskksslleeeepp

Set amount of idle time until hard disk sleeps. Specify "Never" or "Off" for never.

-ggeettwwaakkeeoonnmmooddeemm

Displays whether wake on modem is on or off.

-sseettwwaakkeeoonnmmooddeemm on | off

Use this command to specify whether or not the server will wake from sleep when modem activity is detected.

-ggeettwwaakkeeoonnnneettwwoorrkkaacccceessss

Displays whether wake on network access is on or off.

-sseettwwaakkeeoonnnneettwwoorrkkaacccceessss on | off

Use this command to specify whether the server wakes from sleep when a network admin packet is sent to it.

-ggeettrreessttaarrttppoowweerrffaaiilluurree

Displays whether restart on power failure is on or off.

-sseettrreessttaarrttppoowweerrffaaiilluurree on | off

Use this command to specify whether the server automatically restarts after a power failure.

-ggeettrreessttaarrttffrreeeezzee

Displays whether restart on freeze is on or off.

-sseettrreessttaarrttffrreeeezzee on | off

Use this command to specify whether the server restarts automati-

cally after the system freezes.

-ggeettaalllloowwppoowweerrbbuuttttoonnttoosslleeeeppccoommppuutteerr

Enable or disable whether the power button can sleep the com-

puter.

-sseettaalllloowwppoowweerrbbuuttttoonnttoosslleeeeppccoommppuutteerr on | off

Enable or disable whether the power button can sleep the com-

puter.

-ggeettrreemmootteellooggiinn

Displays whether remote login (SSH) is on or off.

-sseettrreemmootteellooggiinn [-f] on | off

Sets remote login (SSH) to either on or off. Important If you turn off remote login, you won't be able to administer the server using remote command line tools and SSH. To turn remote login back on, you'll need to connect a monitor and keyboard to the

server to administer it locally. Use "setremotelogin -f off" to

suppress prompting when turning remote login off.

-ggeettrreemmootteeaapppplleeeevveennttss

Displays whether remote apple events are on or off.

-sseettrreemmootteeaapppplleeeevveennttss on | off

Use this command to set whether the server responds to events sent by other computers (such as AppleScripts).

-ggeettccoommppuutteerrnnaammee

Displays computer name.

-sseettccoommppuutteerrnnaammee computername

Sets computer name to . This name is used by AFP and AppleTalk.

-ggeettllooccaallssuubbnneettnnaammee

Display local subnet name.

-sseettllooccaallssuubbnneettnnaammee name

Set local subnet name to .

-ggeettssttaarrttuuppddiisskk

Displays current startup disk.

-lliissttssttaarrttuuppddiisskkss

Lists all valid startup disks on this computer.

-sseettssttaarrttuuppddiisskk path

Sets current startup disk to the indicated path. Valid arguments

can be listed using "-liststartupdisks."

-ggeettwwaaiittffoorrssttaarrttuuppaafftteerrppoowweerrffaaiilluurree

Get the number of seconds after which the computer will start up after a power failure.

-sseettwwaaiittffoorrssttaarrttuuppaafftteerrppoowweerrffaaiilluurree seconds

Set the number of seconds after which the computer will start up after a power failure. The value must be a multiple of 30 seconds.

-ggeettddiissaabblleekkeeyybbooaarrddwwhheenneenncclloossuurreelloocckkiisseennggaaggeedd

Get whether or not the keyboard should be disabled when the X Serve enclosure lock is engaged.

-sseettddiissaabblleekkeeyybbooaarrddwwhheenneenncclloossuurreelloocckkiisseennggaaggeedd yes | no

Set whether or not the keyboard should be disabled when the X Serve enclosure lock is engaged.

-vveerrssiioonn

Displays version of systemsetup tool.

-hheellpp Displays a list of all the commands available in the System Setup

Tool, with explanatory information.

-pprriinnttCCoommmmaannddss

Displays a list of commands with no detail. EEXXAAMMPPLLEESS

ssyysstteemmsseettuupp -setdate 04:15:02

ssyysstteemmsseettuupp -settime 16:20:00

ssyysstteemmsseettuupp -settimezone US/Pacific

ssyysstteemmsseettuupp -setnetworktimeserver time.apple.com

FILES