Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
BSDCONFIG(8)		    System Manager's Manual		  BSDCONFIG(8)

NAME
       bsdconfig -- system configuration utility

SYNOPSIS
       bsdconfig [-h]
       bsdconfig command [-h]
       bsdconfig [OPTIONS] [command [OPTIONS]]

DESCRIPTION
       bsdconfig  is  used  to set up many system configuration	settings, both
       for new systems,	as well	as changing configuration settings of existing
       systems.

       bsdconfig optionally takes a command as an argument.  If	 invoked  with
       no  arguments,  it will bring up	an interactive menu listing the	avail-
       able modules.

       The following options are available:

       -d	Provide	lots of	debugging info on standard-out when running.

       -D file	Send debugging info to file.  If file begins with a  plus-sign
		debug  info  is	 sent to both standard-out and file (minus the
		leading	plus).

       -f file	Load file as script and	then exit.  If	multiple  occurrences,
		program	 will  only  exit after	last occurrence.  If file is a
		single dash (`-'), bsdconfig reads from	standard input.

       -h	Print usage statement and exit.

       -S	Secure X11 mode	(implies -X).  As root,	always prompt-for  and
		validate  sudo(8)  (ports/security/sudo) username/password be-
		fore starting.

       -X	Use Xdialog(1) (ports/x11/xdialog) in place of dialog(1).

COMMANDS
       The following commands (sorted alphabetically) are  currently  included
       in  the base bsdconfig program, with more to be added soon.  Other com-
       mands can be added, as detailed below in	the ADDING  COMMANDS  section,
       and  once  added,  will	appear in the master menu as well as in	the -h
       listing.

       console		  Utilities to customize the behavior  of  the	system
			  console.

       defaultrouter	  Shortcut  to	the  Default Router/Gateway menu under
			  networking.

       diskmgmt		  Manage  disk	partitions  and/or  labels.   Executes
			  sade(8).

       docsinstall	  Executes  the	 bsdinstall docsinstall	sub-utility to
			  allow	installation/re-installation  of  the  FreeBSD
			  Documentation	set(s).

       dot		  Generate a graphviz dot(1) (ports/graphics/graphviz)
			  language  file  (printed  on stdout) visualizing the
			  bsdconfig menu, include, and shortcut	structure  re-
			  lationships.	 See  "bsdconfig  dot -h" for more de-
			  tails.

       groupadd		  Shortcut to the Add Groups menu under	groupmgmt.

       groupdel		  Shortcut to the Delete Groups	menu under groupmgmt.

       groupedit	  Shortcut to the Edit/View Groups menu	 under	group-
			  mgmt.

       groupmgmt	  Utilities to Add/Change/View/Delete Group Accounts.

       hostname		  Shortcut  to the Hostname/Domain menu	under network-
			  ing.

       kern_securelevel	  Shortcut to the kern.securelevel  menu  under	 secu-
			  rity.

       mouse		  Utilities  for  configuring, exploring, and enabling
			  console mouse	support.

       mouse_disable	  Shortcut to the Disable menu under mouse.

       mouse_enable	  Shortcut to the Enable menu under mouse.

       mouse_flags	  Shortcut to the Flags	menu under mouse.

       mouse_port	  Shortcut to the Port menu under mouse.

       mouse_type	  Shortcut to the Type menu under mouse.

       nameservers	  Shortcut to the DNS Nameservers menu under  network-
			  ing.

       netdev		  Shortcut  to	the Network Interfaces menu under net-
			  working.

       networking	  Utilities to set/change Hostname/Domain, Network In-
			  terfaces, Wireless Network, Default  Router/Gateway,
			  and DNS Nameservers.

       packages		  Browse,  install,  uninstall,	or re-install packaged
			  software.

       password		  Set the system administrator (root) password.

       security		  Configure various system security settings.

       startup		  Configure various aspects of system startup.

       startup_misc	  Shortcut to the Miscellaneous	Startup	Services  menu
			  under	startup.

       startup_rcadd	  Shortcut  to	the  Add  New menu under the View/Edit
			  Startup  Configuration  menu	 (startup_rcconf)   of
			  startup.

       startup_rcconf	  Shortcut to the View/Edit Startup Configuration menu
			  under	startup.

       startup_rcdelete	  Shortcut  to	the  Delete  menu  under the View/Edit
			  Startup  Configuration  menu	 (startup_rcconf)   of
			  startup.

       startup_rcvar	  Shortcut  to	the Toggle Startup Services menu under
			  startup.

       syscons_font	  Shortcut to the Font menu under console.

       syscons_keymap	  Shortcut to the Keymap menu under console.

       syscons_repeat	  Shortcut to the Repeat menu under console.

       syscons_saver	  Shortcut to the Saver	menu under console.

       syscons_screenmap  Shortcut to the Screenmap menu under console.

       syscons_ttys	  Shortcut to the Ttys menu under console.

       timezone		  Set the regional timezone of the local machine.

       ttys		  Edit the ttys(5) database with your favorite editor.

       useradd		  Shortcut to the Add Users menu under usermgmt.

       userdel		  Shortcut to the Delete Users menu under usermgmt.

       useredit		  Shortcut to the Edit/View Users menu under usermgmt.

       usermgmt		  Utilities to Add/Edit/View/Delete User Accounts.

       wireless		  Shortcut to the Wireless Networks  menu  under  net-
			  working.

INTERNATIONALIZATION
       i18n  features  are built into bsdconfig	and language-specific transla-
       tion files will be added	as they	become available.  In the  absence  of
       language-specific  translation  files,  the  default  (en_US.ISO8859-1)
       files will be used.

ADDING COMMANDS
       To be documented	later.	Document menu_selection="command|*" syntax  of
       INDEX files.

ENVIRONMENT VARIABLES
       The following environment variables affect the execution	of bsdconfig:

       LANG    If  LANG	 is  set,  messages and	index information will be read
	       from files named	messages.$LANG and INDEX.$LANG and  fall  back
	       to  files  named	 messages  and INDEX if	messages.$LANG and IN-
	       DEX.$LANG do not	exist.	LANG takes precedence over LC_ALL.

       LC_ALL  If LC_ALL is set, messages and index information	will  be  read
	       from  files  named  messages.$LC_ALL and	INDEX.$LC_ALL and fall
	       back to files named messages and	INDEX if messages.$LC_ALL  and
	       INDEX.$LC_ALL do	not exist.

FILES
       /usr/share/examples/bsdconfig/bsdconfigrc  can be copied	to $HOME/.bsd-
       configrc	and customized as needed.

EXIT STATUS
       The bsdconfig utility exits 0 on	success, and >0	if an error occurs.

SEE ALSO
       bsdinstall(8)

HISTORY
       bsdconfig first appeared	in FreeBSD 9.2.

AUTHORS
       Ron McDowell
       Devin Teske <dteske@FreeBSD.org>

BUGS
       The docsinstall and diskmgmt modules call bsdinstall.   Bugs  found  in
       these modules should be considered those	of bsdinstall, not bsdconfig.

FreeBSD	13.2			April 12, 2020			  BSDCONFIG(8)

NAME | SYNOPSIS | DESCRIPTION | COMMANDS | INTERNATIONALIZATION | ADDING COMMANDS | ENVIRONMENT VARIABLES | FILES | EXIT STATUS | SEE ALSO | HISTORY | AUTHORS | BUGS

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=bsdconfig&sektion=8&manpath=FreeBSD+14.1-RELEASE+and+Ports>

home | help