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

FreeBSD Man Pages

Man Page or Keyword Search:
Man Architecture
Apropos Keyword Search (all sections) Output format
home | help
BSDCONFIG(8)            FreeBSD 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 available
     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) username/password before starting.

     -X       Use Xdialog(1) 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 commands
     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) language file (printed
                            on stdout) visualizing the bsdconfig menu,
                            include, and shortcut structure relationships.
                            See ``bsdconfig dot -h'' for more details.

     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
                            groupmgmt.

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

     hostname               Shortcut to the Hostname/Domain menu under
                            networking.

     kern_securelevel       Shortcut to the kern.securelevel menu under
                            security.

     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
                            networking.

     netdev                 Shortcut to the Network Interfaces menu under
                            networking.

     networking             Utilities to set/change Hostname/Domain, Network
                            Interfaces, 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.

INTERNATIONALIZATION
     i18n features are built into bsdconfig and language-specific translation
     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
                 INDEX.$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/.bsdconfigrc 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 11.0-PRERELEASE          June 5, 2013          FreeBSD 11.0-PRERELEASE

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://www.freebsd.org/cgi/man.cgi?query=bsdconfig&sektion=8&manpath=FreeBSD+9.3-RELEASE>

home | help