Editing Sysrc

{{welcome}}
{{Navbar OpenRC}}

==Introduction==

The [https://www.freebsd.org/cgi/man.cgi?query=sysrc&apropos=0&sektion=8&manpath=FreeBSD+12.1-RELEASE+and+Ports&arch=default&format=html sysrc] utility retrieves '''[[Rc.conf|rc.conf(5)]]''' variables from the collection of   system '''[[Rc|rc]]''' files and allows	processes with appropriate privilege to	change   values in a safe and effective manner.

==Usage==
You can edit '''[[Rc.conf]]''' directly with a editor or with the command <code>sysrc</code> on the CLI. With <code>sysrc</code> you can alter '''[[Rc.conf]]''' safely.



==Options==

{|class="wikitable" style="width:96.5%;background:#FFFFFF; border:2px solid #008000;text-align:left;padding: 10px" 
|-
! scope="col" style="width: 100px;"|'''Option'''
! scope="col" style="width: 350px;"|'''Description'''
|-
|<nowiki>-a	</nowiki>||Dump a list of all non-default configuration variables.
|-
|<nowiki>-A	</nowiki>||Dump a list of all configuration variables (incl.	defaults).
|-
|<nowiki>-c	</nowiki> ||Check only.  For querying, return	success	if all requested vari ables are	set (even if NULL), otherwise return error status.  For assignments, return success if no changes are	required, otherwise failure.  If verbose (see "-v") prints a message stating   whether variables	are set	and/or changes are required.
|-
|<nowiki>-d</nowiki>||Print a description of the given variable.
|-
|<nowiki>-D</nowiki>||Show default value(s) only (this is the same as setting RC_CONFS  to NULL or passing `-f' with a NULL file-argument).
|-
|<nowiki>-e</nowiki>||Print query results as sh(1) compatible syntax (for example, `var=value').  Ignored if	either `-n' or `-F' is specified.
|-
|<nowiki>-E</nowiki>||When given `-l' or `-L' to list configuration files, only	list those that exist.	 When changing a setting, prefer to modify existing files.
|-
|<nowiki>-f	</nowiki>''file''||Operate on the specified file(s) instead of the files obtained 	      by reading the `rc_conf_files' entry in the RC_DEFAULTS file.      This option can be specified multiple times for additional     files.
|-
|<nowiki>-F</nowiki>||Show only	the last '''[[Rc.conf|rc.conf(5)]]''' file each directive	is in.
|-
|<nowiki>-h</nowiki>||Print a short usage message to stderr and	exit.
|-
|<nowiki>--help</nowiki>||Print a full usage statement to stderr and exit.
|-
|<nowiki>-i</nowiki>||Ignore unknown variables.
|-
|<nowiki>-j	</nowiki>''jail''||The jid or name of the jail to operate within (overrides `-R  dir'; requires jexec(8)).
|-
|<nowiki>-l</nowiki>||List configuration files used at startup on stdout and exit.
|-
|<nowiki>-L</nowiki>||List all configuration files including '''[[Rc.conf.d|rc.conf.d]]''' entries on stdout and exit.  Can be combined with `-v' or `-e' to show service  names.  sysrc exits with success if all named services are installed, failure otherwise.
|-
|<nowiki>-n</nowiki>||Show only	variable values, not their names.
|-
|<nowiki>-N</nowiki>||Show only	variable names,	not their values.
|-
|<nowiki>-q</nowiki>||Quiet.  Disable verbose and hide certain errors.	When combined      with `-L'	and one	or more	name arguments,	provide	only exit status and no output.
|-
|<nowiki>-R	</nowiki>''dir''||Operate within the root directory	`dir' rather than `/'.
|-
|<nowiki>-s	</nowiki>''name''||If an '''[[Rc.d|rc.d]]''' script	of name	exists (in'''/etc/[[Rc.d|rc.d]]''' or local_startup directories), process its '''[[Rc.conf.d|rc.conf.d]]''' entries as    potential	overrides to `rc_conf_files'.  See rc.subr(8) for additional information on '''[[Rc.conf.d|rc.conf.d]]'''.  Can	be combined with `-l'  to list configuration files used by service at startup.
|-
|<nowiki>-v</nowiki>||Verbose.	Print the pathname of the specific '''[[Rc.conf|rc.conf(5)]]''' file   where the	directive was found.
|-
|<nowiki>--version</nowiki>||Print version information	to stdout and exit.
|-
|<nowiki>-x</nowiki>||Remove variable(s) from specified	file(s).
|}


==Example==

With the <code>sysrc -a</code> you get information about all non-default settings in '''/etc/[[Rc.conf|rc.conf]]'''.

$ sysrc -a<br/>
autofs_enable: YES<br/>
cupsd_enable: YES<br/>
devfs_system_ruleset: devfsrules_common<br/>
dsbmd_enable: NO<br/>
hald_enable: YES<br/>
hostname: yourname.ghostbsd-pc.home<br/>
ifconfig_em0: DHCP<br/>
ifconfig_nfe0: DHCP<br/>
keymap: de.kbd<br/>
kld_list: linux linux64 cuse<br/>
kldload_nvidia: nvidia-modeset nvidia<br/>
kldload_vbox: vboxdrv<br/>
lpd_enable: NO<br/>
ntpd_sync_on_start: YES<br/>
root_rw_mount: NO<br/>
sendmail_enable: NONE<br/>
sendmail_msp_queue_enable: NO<br/>
sendmail_outbound_enable: NO<br/>
sendmail_submit_enable: NO<br/>
vboxguest_enable: YES<br/>
vboxnet_enable: YES<br/>
vboxservice_enable: YES<br/>



[[Category:Sysutils]]