usr.sbin/bsdconfig/bsdconfig.8

   1 .\" Copyright (c) 2012 Ron McDowell
   2 .\" Copyright (c) 2012-2013 Devin Teske
   3 .\" All rights reserved.
   4 .\"
   5 .\" Redistribution and use in source and binary forms, with or without
   6 .\" modification, are permitted provided that the following conditions
   7 .\" are met:
   8 .\" 1. Redistributions of source code must retain the above copyright
   9 .\"    notice, this list of conditions and the following disclaimer.
  10 .\" 2. Redistributions in binary form must reproduce the above copyright
  11 .\"    notice, this list of conditions and the following disclaimer in the
  12 .\"    documentation and/or other materials provided with the distribution.
  13 .\"
  14 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
  15 .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
  16 .\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
  17 .\" DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT,
  18 .\" INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
  19 .\" (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
  20 .\" SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  21 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
  22 .\" STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
  23 .\" ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  24 .\" POSSIBILITY OF SUCH DAMAGE.
  25 .\"
  26 .\" $FreeBSD$
  27 .\"
  28 .Dd Jun 5, 2013
  29 .Dt BSDCONFIG 8
  30 .Os
  31 .Sh NAME
  32 .Nm bsdconfig
  33 .Nd system configuration utility
  34 .Sh SYNOPSIS
  35 .Nm
  36 .Op Fl h
  37 .Nm
  38 .Ar command
  39 .Op Fl h
  40 .Nm
  41 .Op OPTIONS
  42 .Op command Op OPTIONS
  43 .Sh DESCRIPTION
  44 .Nm
  45 is used to set up many system configuration settings, both for new systems, as
  46 well as changing configuration settings of existing systems.
  47 .Pp
  48 .Nm
  49 optionally takes a command as an argument.
  50 If invoked with no arguments, it will bring up an interactive menu listing the
  51 available modules.
  52 .Pp
  53 The following options are available:
  54 .Bl -tag -width indent+
  55 .It Fl d
  56 Provide lots of debugging info on standard-out when running.
  57 .It Fl D Ar file
  58 Send debugging info to file.
  59 If file begins with a plus-sign debug info is sent to both standard-out and
  60 file (minus the leading plus).
  61 .It Fl f Ar file
  62 Load
  63 .Ar file
  64 as script and then exit.
  65 If multiple occurrences, program will only exit after last occurrence.
  66 If
  67 .Ar file
  68 is a single dash
  69 .Pq Sq Fl ,
  70 .Nm
  71 reads from standard input.
  72 .It Fl h
  73 Print usage statement and exit.
  74 .It Fl S
  75 Secure X11 mode
  76 .Pq implies Fl X .
  77 As root, always prompt-for and validate
  78 .Xr sudo 8
  79 username/password before starting.
  80 .It Fl X
  81 Use
  82 .Xr Xdialog 1
  83 in place of
  84 .Xr dialog 1 .
  85 .El
  86 .Sh COMMANDS
  87 The following commands
  88 .Pq sorted alphabetically
  89 are currently included in the base
  90 .Nm
  91 program, with more to be added soon.
  92 Other commands can be added, as detailed below in the
  93 .Cm ADDING COMMANDS
  94 section, and once added, will appear in the master menu as well as in the
  95 .Cm -h
  96 listing.
  97 .Bl -tag -width ".Cm syscons_screenmap"
  98 .It Cm console
  99 Utilities to customize the behavior of the system console.
 100 .It Cm defaultrouter
 101 Shortcut to the Default Router/Gateway menu under networking.
 102 .It Cm diskmgmt
 103 Manage disk partitions and/or labels.
 104 Executes
 105 .Xr sade 8 .
 106 .It Cm docsinstall
 107 Executes the
 108 .Cm bsdinstall docsinstall
 109 sub-utility to allow installation/re-installation of the FreeBSD Documentation
 110 set(s).
 111 .It Cm dot
 112 Generate a graphviz
 113 .Xr dot 1
 114 language file
 115 .Pq printed on stdout
 116 visualizing the
 117 .Nm
 118 menu, include, and shortcut structure relationships.
 119 See
 120 .Dq bsdconfig dot -h
 121 for more details.
 122 .It Cm groupadd
 123 Shortcut to the Add Groups menu under groupmgmt.
 124 .It Cm groupdel
 125 Shortcut to the Delete Groups menu under groupmgmt.
 126 .It Cm groupedit
 127 Shortcut to the Edit/View Groups menu under groupmgmt.
 128 .It Cm groupmgmt
 129 Utilities to Add/Change/View/Delete Group Accounts.
 130 .It Cm hostname
 131 Shortcut to the Hostname/Domain menu under networking.
 132 .It Cm kern_securelevel
 133 Shortcut to the kern.securelevel menu under security.
 134 .It Cm mouse
 135 Utilities for configuring, exploring, and enabling console mouse support.
 136 .It Cm mouse_disable
 137 Shortcut to the Disable menu under mouse.
 138 .It Cm mouse_enable
 139 Shortcut to the Enable menu under mouse.
 140 .It Cm mouse_flags
 141 Shortcut to the Flags menu under mouse.
 142 .It Cm mouse_port
 143 Shortcut to the Port menu under mouse.
 144 .It Cm mouse_type
 145 Shortcut to the Type menu under mouse.
 146 .It Cm nameservers
 147 Shortcut to the DNS Nameservers menu under networking.
 148 .It Cm netdev
 149 Shortcut to the Network Interfaces menu under networking.
 150 .It Cm networking
 151 Utilities to set/change Hostname/Domain, Network Interfaces, Default
 152 Router/Gateway, and DNS Nameservers.
 153 .It Cm packages
 154 Browse, install, uninstall, or re-install packaged software.
 155 .It Cm password
 156 Set the system administrator
 157 .Pq root
 158 password.
 159 .It Cm security
 160 Configure various system security settings.
 161 .It Cm startup
 162 Configure various aspects of system startup.
 163 .It Cm startup_misc
 164 Shortcut to the Miscellaneous Startup Services menu under startup.
 165 .It Cm startup_rcadd
 166 Shortcut to the Add New menu under the View/Edit Startup Configuration menu
 167 (startup_rcconf) of startup.
 168 .It Cm startup_rcconf
 169 Shortcut to the View/Edit Startup Configuration menu under startup.
 170 .It Cm startup_rcdelete
 171 Shortcut to the Delete menu under the View/Edit Startup Configuration menu
 172 (startup_rcconf) of startup.
 173 .It Cm startup_rcvar
 174 Shortcut to the Toggle Startup Services menu under startup.
 175 .\" use neutral name, e.g. console_keymap instead of syscons_keymap?
 176 .\" font (encoding) selection not applicable to vt(4)!
 177 .It Cm syscons_font
 178 Shortcut to the Font menu under console.
 179 .\" .It Cm console_keymap
 180 .\" Shortcut to the Keymap menu under console.
 181 .It Cm syscons_keymap
 182 Shortcut to the Keymap menu under console.
 183 .\" .It Cm vt_repeat
 184 .\" Shortcut to the Repeat menu under console.
 185 .It Cm syscons_repeat
 186 Shortcut to the Repeat menu under console.
 187 .\" .It Cm vt_saver
 188 .\" Shortcut to the Saver menu under console.
 189 .It Cm syscons_saver
 190 Shortcut to the Saver menu under console.
 191 .\" screenmap (encoding) selection not applicable to vt(4)!
 192 .It Cm syscons_screenmap
 193 Shortcut to the Screenmap menu under console.
 194 .\" .It Cm vt_syscons_ttys
 195 .\" Shortcut to the Ttys menu under console.
 196 .It Cm syscons_ttys
 197 Shortcut to the Ttys menu under console.
 198 .It Cm timezone
 199 Set the regional timezone of the local machine.
 200 .It Cm ttys
 201 Edit the
 202 .Xr ttys 5
 203 database with your favorite editor.
 204 .It Cm useradd
 205 Shortcut to the Add Users menu under usermgmt.
 206 .It Cm userdel
 207 Shortcut to the Delete Users menu under usermgmt.
 208 .It Cm useredit
 209 Shortcut to the Edit/View Users menu under usermgmt.
 210 .It Cm usermgmt
 211 Utilities to Add/Edit/View/Delete User Accounts.
 212 .El
 213 .Sh INTERNATIONALIZATION
 214 i18n features are built into
 215 .Nm
 216 and language-specific translation files will be added as they become available.
 217 In the absence of language-specific translation files, the default
 218 .Pq en_US.ISO8859-1
 219 files will be used.
 220 .Sh ADDING COMMANDS
 221 To be documented later.
 222 Document menu_selection="command|*" syntax of INDEX files.
 223 .Sh ENVIRONMENT VARIABLES
 224 The following environment variables affect the execution of
 225 .Nm :
 226 .Bl -tag -width ".Ev LC_ALL"
 227 .It Ev LANG
 228 If LANG is set, messages and index information will be read from files named
 229 messages.$LANG and INDEX.$LANG and fall back to files named messages and INDEX
 230 if messages.$LANG and INDEX.$LANG do not exist.
 231 LANG takes precedence over LC_ALL.
 232 .It Ev LC_ALL
 233 If LC_ALL is set, messages and index information will be read from files named
 234 messages.$LC_ALL and INDEX.$LC_ALL and fall back to files named messages and
 235 INDEX if messages.$LC_ALL and INDEX.$LC_ALL do not exist.
 236 .El
 237 .Sh FILES
 238 /usr/share/examples/bsdconfig/bsdconfigrc can be copied to $HOME/.bsdconfigrc
 239 and customized as needed.
 240 .Sh EXIT STATUS
 241 .Ex -std
 242 .Sh SEE ALSO
 243 .Xr bsdinstall 8
 244 .Sh HISTORY
 245 .Nm
 246 first appeared in
 247 .Fx 9.2 .
 248 .Sh AUTHORS
 249 .An Ron McDowell
 250 .An Devin Teske Aq dteske@FreeBSD.org
 251 .Sh BUGS
 252 The docsinstall and diskmgmt modules call bsdinstall.
 253 Bugs found in these modules should be considered those of bsdinstall, not
 254 .Nm .