diff options
Diffstat (limited to 'documentation/content/en/books/handbook/config/_index.po')
| -rw-r--r-- | documentation/content/en/books/handbook/config/_index.po | 960 |
1 files changed, 480 insertions, 480 deletions
diff --git a/documentation/content/en/books/handbook/config/_index.po b/documentation/content/en/books/handbook/config/_index.po index edc5d57504..5c5e7a167e 100644 --- a/documentation/content/en/books/handbook/config/_index.po +++ b/documentation/content/en/books/handbook/config/_index.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: FreeBSD Documentation VERSION\n" -"POT-Creation-Date: 2023-01-21 20:00-0300\n" +"POT-Creation-Date: 2023-04-20 20:56-0300\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <LL@li.org>\n" @@ -35,19 +35,19 @@ msgid "Chapter 13. Configuration and Tuning" msgstr "" #. type: Title = -#: documentation/content/en/books/handbook/config/_index.adoc:15 +#: documentation/content/en/books/handbook/config/_index.adoc:14 #, no-wrap msgid "Configuration and Tuning" msgstr "" #. type: Title == -#: documentation/content/en/books/handbook/config/_index.adoc:53 +#: documentation/content/en/books/handbook/config/_index.adoc:52 #, no-wrap msgid "Synopsis" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:57 +#: documentation/content/en/books/handbook/config/_index.adoc:56 msgid "" "One of the important aspects of FreeBSD is proper system configuration. " "This chapter explains much of the FreeBSD configuration process, including " @@ -55,69 +55,69 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:59 +#: documentation/content/en/books/handbook/config/_index.adoc:58 msgid "After reading this chapter, you will know:" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:61 +#: documentation/content/en/books/handbook/config/_index.adoc:60 msgid "" "The basics of [.filename]#rc.conf# configuration and [.filename]#/usr/local/" "etc/rc.d# startup scripts." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:62 +#: documentation/content/en/books/handbook/config/_index.adoc:61 msgid "How to configure and test a network card." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:63 +#: documentation/content/en/books/handbook/config/_index.adoc:62 msgid "How to configure virtual hosts on network devices." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:64 +#: documentation/content/en/books/handbook/config/_index.adoc:63 msgid "How to use the various configuration files in [.filename]#/etc#." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:65 +#: documentation/content/en/books/handbook/config/_index.adoc:64 msgid "How to tune FreeBSD using man:sysctl[8] variables." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:66 +#: documentation/content/en/books/handbook/config/_index.adoc:65 msgid "How to tune disk performance and modify kernel limitations." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:68 +#: documentation/content/en/books/handbook/config/_index.adoc:67 msgid "Before reading this chapter, you should:" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:70 +#: documentation/content/en/books/handbook/config/_index.adoc:69 msgid "" "Understand UNIX(R) and FreeBSD basics (crossref:basics[basics,FreeBSD " "Basics])." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:71 +#: documentation/content/en/books/handbook/config/_index.adoc:70 msgid "" "Be familiar with the basics of kernel configuration and compilation " "(crossref:kernelconfig[kernelconfig,Configuring the FreeBSD Kernel])." msgstr "" #. type: Title == -#: documentation/content/en/books/handbook/config/_index.adoc:73 +#: documentation/content/en/books/handbook/config/_index.adoc:72 #, no-wrap msgid "Starting Services" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:78 +#: documentation/content/en/books/handbook/config/_index.adoc:77 msgid "" "Many users install third party software on FreeBSD from the Ports Collection " "and require the installed services to be started upon system " @@ -128,20 +128,20 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:80 +#: documentation/content/en/books/handbook/config/_index.adoc:79 msgid "" "In FreeBSD, most included services, such as man:cron[8], are started through " "the system startup scripts." msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/config/_index.adoc:81 +#: documentation/content/en/books/handbook/config/_index.adoc:80 #, no-wrap msgid "Extended Application Configuration" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:86 +#: documentation/content/en/books/handbook/config/_index.adoc:85 msgid "" "Now that FreeBSD includes [.filename]#rc.d#, configuration of application " "startup is easier and provides more features. Using the key words discussed " @@ -152,7 +152,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:94 +#: documentation/content/en/books/handbook/config/_index.adoc:93 #, no-wrap msgid "" "#!/bin/sh\n" @@ -163,13 +163,13 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:96 +#: documentation/content/en/books/handbook/config/_index.adoc:95 #, no-wrap msgid ". /etc/rc.subr\n" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:99 +#: documentation/content/en/books/handbook/config/_index.adoc:98 #, no-wrap msgid "" "name=utility\n" @@ -177,19 +177,19 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:101 +#: documentation/content/en/books/handbook/config/_index.adoc:100 #, no-wrap msgid "command=\"/usr/local/sbin/utility\"\n" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:103 +#: documentation/content/en/books/handbook/config/_index.adoc:102 #, no-wrap msgid "load_rc_config $name\n" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:110 +#: documentation/content/en/books/handbook/config/_index.adoc:109 #, no-wrap msgid "" "#\n" @@ -201,13 +201,13 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:112 +#: documentation/content/en/books/handbook/config/_index.adoc:111 #, no-wrap msgid "run_rc_command \"$1\"\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:116 +#: documentation/content/en/books/handbook/config/_index.adoc:115 msgid "" "This script will ensure that the provided `utility` will be started after " "the `DAEMON` pseudo-service. It also provides a method for setting and " @@ -215,20 +215,20 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:118 +#: documentation/content/en/books/handbook/config/_index.adoc:117 msgid "" "This application could then have the following line placed in [.filename]#/" "etc/rc.conf#:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:122 +#: documentation/content/en/books/handbook/config/_index.adoc:121 #, no-wrap msgid "utility_enable=\"YES\"\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:125 +#: documentation/content/en/books/handbook/config/_index.adoc:124 msgid "" "This method allows for easier manipulation of command line arguments, " "inclusion of the default functions provided in [.filename]#/etc/rc.subr#, " @@ -237,13 +237,13 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/config/_index.adoc:126 +#: documentation/content/en/books/handbook/config/_index.adoc:125 #, no-wrap msgid "Using Services to Start Services" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:130 +#: documentation/content/en/books/handbook/config/_index.adoc:129 msgid "" "Other services can be started using man:inetd[8]. Working with man:inetd[8] " "and its configuration is described in depth in crossref:network-" @@ -251,7 +251,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:134 +#: documentation/content/en/books/handbook/config/_index.adoc:133 msgid "" "In some cases, it may make more sense to use man:cron[8] to start system " "services. This approach has a number of advantages as man:cron[8] runs " @@ -260,7 +260,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:137 +#: documentation/content/en/books/handbook/config/_index.adoc:136 msgid "" "The `@reboot` feature of man:cron[8], may be used in place of the time " "specification. This causes the job to run when man:cron[8] is started, " @@ -268,13 +268,13 @@ msgid "" msgstr "" #. type: Title == -#: documentation/content/en/books/handbook/config/_index.adoc:139 +#: documentation/content/en/books/handbook/config/_index.adoc:138 #, no-wrap msgid "Configuring man:cron[8]" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:145 +#: documentation/content/en/books/handbook/config/_index.adoc:144 msgid "" "One of the most useful utilities in FreeBSD is cron. This utility runs in " "the background and regularly checks [.filename]#/etc/crontab# for tasks to " @@ -285,7 +285,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:151 +#: documentation/content/en/books/handbook/config/_index.adoc:150 msgid "" "Two different types of configuration files are used: the system crontab, " "which should not be modified, and user crontabs, which can be created and " @@ -297,7 +297,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:154 +#: documentation/content/en/books/handbook/config/_index.adoc:153 msgid "" "User crontabs allow individual users to schedule their own tasks. The " "`root` user can also have a user [.filename]#crontab# which can be used to " @@ -305,13 +305,13 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:156 +#: documentation/content/en/books/handbook/config/_index.adoc:155 msgid "" "Here is a sample entry from the system crontab, [.filename]#/etc/crontab#:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:169 +#: documentation/content/en/books/handbook/config/_index.adoc:168 #, no-wrap msgid "" "# /etc/crontab - root's crontab for FreeBSD\n" @@ -327,7 +327,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:172 +#: documentation/content/en/books/handbook/config/_index.adoc:171 msgid "" "Lines that begin with the `+#+` character are comments. A comment can be " "placed in the file as a reminder of what and why a desired action is " @@ -337,7 +337,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:174 +#: documentation/content/en/books/handbook/config/_index.adoc:173 msgid "" "The equals (`=`) character is used to define any environment settings. In " "this example, it is used to define the `SHELL` and `PATH`. If the `SHELL` is " @@ -346,7 +346,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:176 +#: documentation/content/en/books/handbook/config/_index.adoc:175 msgid "" "This line defines the seven fields used in a system crontab: `minute`, " "`hour`, `mday`, `month`, `wday`, `who`, and `command`. The `minute` field is " @@ -360,7 +360,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:178 +#: documentation/content/en/books/handbook/config/_index.adoc:177 msgid "" "This entry defines the values for this cron job. The `\\*/5`, followed by " "several more `*` characters, specifies that `/usr/libexec/atrun` is invoked " @@ -371,24 +371,24 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/config/_index.adoc:180 +#: documentation/content/en/books/handbook/config/_index.adoc:179 #, no-wrap msgid "Creating a User Crontab" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:183 +#: documentation/content/en/books/handbook/config/_index.adoc:182 msgid "To create a user crontab, invoke `crontab` in editor mode:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:187 +#: documentation/content/en/books/handbook/config/_index.adoc:186 #, no-wrap msgid "% crontab -e\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:192 +#: documentation/content/en/books/handbook/config/_index.adoc:191 msgid "" "This will open the user's crontab using the default text editor. The first " "time a user runs this command, it will open an empty file. Once a user " @@ -396,7 +396,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:194 +#: documentation/content/en/books/handbook/config/_index.adoc:193 msgid "" "It is useful to add these lines to the top of the crontab file in order to " "set the environment variables and to remember the meanings of the fields in " @@ -404,7 +404,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:201 +#: documentation/content/en/books/handbook/config/_index.adoc:200 #, no-wrap msgid "" "SHELL=/bin/sh\n" @@ -414,7 +414,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:206 +#: documentation/content/en/books/handbook/config/_index.adoc:205 msgid "" "Then add a line for each command or script to run, specifying the time to " "run the command. This example runs the specified custom Bourne shell script " @@ -423,13 +423,13 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:210 +#: documentation/content/en/books/handbook/config/_index.adoc:209 #, no-wrap msgid "0\t14\t*\t*\t*\t/usr/home/dru/bin/mycustomscript.sh\n" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/config/_index.adoc:217 +#: documentation/content/en/books/handbook/config/_index.adoc:216 msgid "" "Before using a custom script, make sure it is executable and test it with " "the limited set of environment variables set by cron. To replicate the " @@ -437,13 +437,13 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:221 +#: documentation/content/en/books/handbook/config/_index.adoc:220 #, no-wrap msgid "env -i SHELL=/bin/sh PATH=/etc:/bin:/sbin:/usr/bin:/usr/sbin HOME=/home/dru LOGNAME=dru /usr/home/dru/bin/mycustomscript.sh\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:225 +#: documentation/content/en/books/handbook/config/_index.adoc:224 msgid "" "The environment set by cron is discussed in man:crontab[5]. Checking that " "scripts operate correctly in a cron environment is especially important if " @@ -451,7 +451,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/config/_index.adoc:230 +#: documentation/content/en/books/handbook/config/_index.adoc:229 msgid "" "When finished editing the crontab, save the file. It will automatically be " "installed and cron will read the crontab and run its cron jobs at their " @@ -459,7 +459,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:235 +#: documentation/content/en/books/handbook/config/_index.adoc:234 #, no-wrap msgid "" "% crontab -l\n" @@ -467,12 +467,12 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:238 +#: documentation/content/en/books/handbook/config/_index.adoc:237 msgid "To remove all of the cron jobs in a user crontab:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:243 +#: documentation/content/en/books/handbook/config/_index.adoc:242 #, no-wrap msgid "" "% crontab -r\n" @@ -480,13 +480,13 @@ msgid "" msgstr "" #. type: Title == -#: documentation/content/en/books/handbook/config/_index.adoc:246 +#: documentation/content/en/books/handbook/config/_index.adoc:245 #, no-wrap msgid "Managing Services in FreeBSD" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:251 +#: documentation/content/en/books/handbook/config/_index.adoc:250 msgid "" "FreeBSD uses the man:rc[8] system of startup scripts during system " "initialization and for managing services. The scripts listed in [." @@ -496,13 +496,13 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:255 +#: documentation/content/en/books/handbook/config/_index.adoc:254 #, no-wrap msgid "# service sshd restart\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:260 +#: documentation/content/en/books/handbook/config/_index.adoc:259 msgid "" "This procedure can be used to start services on a running system. Services " "will be started automatically at boot time as specified in man:rc.conf[5]. " @@ -511,13 +511,13 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:264 +#: documentation/content/en/books/handbook/config/_index.adoc:263 #, no-wrap msgid "natd_enable=\"YES\"\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:268 +#: documentation/content/en/books/handbook/config/_index.adoc:267 msgid "" "If a `natd_enable=\"NO\"` line is already present, change the `NO` to " "`YES`. The man:rc[8] scripts will automatically load any dependent services " @@ -525,7 +525,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:273 +#: documentation/content/en/books/handbook/config/_index.adoc:272 msgid "" "Since the man:rc[8] system is primarily intended to start and stop services " "at system startup and shutdown time, the `start`, `stop` and `restart` " @@ -539,13 +539,13 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:277 +#: documentation/content/en/books/handbook/config/_index.adoc:276 #, no-wrap msgid "# service sshd onerestart\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:281 +#: documentation/content/en/books/handbook/config/_index.adoc:280 msgid "" "To check if a service is enabled in [.filename]#/etc/rc.conf#, run the " "appropriate man:rc[8] script with `rcvar`. This example checks to see if " @@ -553,7 +553,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:289 +#: documentation/content/en/books/handbook/config/_index.adoc:288 #, no-wrap msgid "" "# service sshd rcvar\n" @@ -564,20 +564,20 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/config/_index.adoc:294 +#: documentation/content/en/books/handbook/config/_index.adoc:293 msgid "" "The `# sshd` line is output from the above command, not a `root` console." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:298 +#: documentation/content/en/books/handbook/config/_index.adoc:297 msgid "" "To determine whether or not a service is running, use `status`. For " "instance, to verify that man:sshd[8] is running:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:303 +#: documentation/content/en/books/handbook/config/_index.adoc:302 #, no-wrap msgid "" "# service sshd status\n" @@ -585,7 +585,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:309 +#: documentation/content/en/books/handbook/config/_index.adoc:308 msgid "" "In some cases, it is also possible to `reload` a service. This attempts to " "send a signal to an individual service, forcing the service to reload its " @@ -594,7 +594,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:312 +#: documentation/content/en/books/handbook/config/_index.adoc:311 msgid "" "The man:rc[8] system is used for network services and it also contributes to " "most of the system initialization. For instance, when the [.filename]#/etc/" @@ -602,20 +602,20 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:316 +#: documentation/content/en/books/handbook/config/_index.adoc:315 #, no-wrap msgid "Starting background file system checks in 60 seconds.\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:319 +#: documentation/content/en/books/handbook/config/_index.adoc:318 msgid "" "This script is used for background file system checks, which occur only " "during system initialization." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:324 +#: documentation/content/en/books/handbook/config/_index.adoc:323 msgid "" "Many system services depend on other services to function properly. For " "example, man:yp[8] and other RPC-based services may fail to start until " @@ -627,40 +627,40 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:326 +#: documentation/content/en/books/handbook/config/_index.adoc:325 msgid "" "The following key word must be included in all startup scripts as it is " "required by man:rc.subr[8] to \"enable\" the startup script:" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:328 +#: documentation/content/en/books/handbook/config/_index.adoc:327 msgid "`PROVIDE`: Specifies the services this file provides." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:331 +#: documentation/content/en/books/handbook/config/_index.adoc:330 msgid "" "The following key words may be included at the top of each startup script. " "They are not strictly necessary, but are useful as hints to man:rcorder[8]:" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:333 +#: documentation/content/en/books/handbook/config/_index.adoc:332 msgid "" "`REQUIRE`: Lists services which are required for this service. The script " "containing this key word will run _after_ the specified services." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:334 +#: documentation/content/en/books/handbook/config/_index.adoc:333 msgid "" "`BEFORE`: Lists services which depend on this service. The script containing " "this key word will run _before_ the specified services." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:336 +#: documentation/content/en/books/handbook/config/_index.adoc:335 msgid "" "By carefully setting these keywords for each startup script, an " "administrator has a fine-grained level of control of the startup order of " @@ -669,7 +669,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:339 +#: documentation/content/en/books/handbook/config/_index.adoc:338 msgid "" "Additional information can be found in man:rc[8] and man:rc.subr[8]. Refer " "to extref:{rc-scripting}[this article] for instructions on how to create " @@ -677,13 +677,13 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/config/_index.adoc:341 +#: documentation/content/en/books/handbook/config/_index.adoc:340 #, no-wrap msgid "Managing System-Specific Configuration" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:346 +#: documentation/content/en/books/handbook/config/_index.adoc:345 msgid "" "The principal location for system configuration information is [.filename]#/" "etc/rc.conf#. This file contains a wide range of configuration information " @@ -692,7 +692,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:350 +#: documentation/content/en/books/handbook/config/_index.adoc:349 msgid "" "The entries in [.filename]#/etc/rc.conf# override the default settings in [." "filename]#/etc/defaults/rc.conf#. The file containing the default settings " @@ -701,7 +701,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:354 +#: documentation/content/en/books/handbook/config/_index.adoc:353 msgid "" "A number of strategies may be applied in clustered applications to separate " "site-wide configuration from system-specific configuration in order to " @@ -711,7 +711,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:360 +#: documentation/content/en/books/handbook/config/_index.adoc:359 #, no-wrap msgid "" "sshd_enable=\"YES\"\n" @@ -720,14 +720,14 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:363 +#: documentation/content/en/books/handbook/config/_index.adoc:362 msgid "" "Whereas these entries in [.filename]#/etc/rc.conf.local# apply to this " "system only:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:368 +#: documentation/content/en/books/handbook/config/_index.adoc:367 #, no-wrap msgid "" "hostname=\"node1.example.org\"\n" @@ -735,7 +735,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:371 +#: documentation/content/en/books/handbook/config/_index.adoc:370 msgid "" "Distribute [.filename]#/etc/rc.conf# to every system using an application " "such as rsync or puppet, while [.filename]#/etc/rc.conf.local# remains " @@ -743,14 +743,14 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:373 +#: documentation/content/en/books/handbook/config/_index.adoc:372 msgid "" "Upgrading the system will not overwrite [.filename]#/etc/rc.conf#, so system " "configuration information will not be lost." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/config/_index.adoc:380 +#: documentation/content/en/books/handbook/config/_index.adoc:379 msgid "" "Both [.filename]#/etc/rc.conf# and [.filename]#/etc/rc.conf.local# are " "parsed by man:sh[1]. This allows system operators to create complex " @@ -759,26 +759,26 @@ msgid "" msgstr "" #. type: Title == -#: documentation/content/en/books/handbook/config/_index.adoc:383 +#: documentation/content/en/books/handbook/config/_index.adoc:382 #, no-wrap msgid "Setting Up Network Interface Cards" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:386 +#: documentation/content/en/books/handbook/config/_index.adoc:385 msgid "" "Adding and configuring a network interface card (NIC) is a common task for " "any FreeBSD administrator." msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/config/_index.adoc:387 +#: documentation/content/en/books/handbook/config/_index.adoc:386 #, no-wrap msgid "Locating the Correct Driver" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:392 +#: documentation/content/en/books/handbook/config/_index.adoc:391 msgid "" "First, determine the model of the NIC and the chip it uses. FreeBSD " "supports a wide variety of NICs. Check the Hardware Compatibility List for " @@ -786,7 +786,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:396 +#: documentation/content/en/books/handbook/config/_index.adoc:395 msgid "" "If the NIC is supported, determine the name of the FreeBSD driver for the " "NIC. Refer to [.filename]#/usr/src/sys/conf/NOTES# and [.filename]#/usr/src/" @@ -797,7 +797,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:400 +#: documentation/content/en/books/handbook/config/_index.adoc:399 msgid "" "The drivers for common NICs are already present in the [.filename]#GENERIC# " "kernel, meaning the NIC should be probed during boot. The system's boot " @@ -807,7 +807,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:417 +#: documentation/content/en/books/handbook/config/_index.adoc:416 #, no-wrap msgid "" "dc0: <82c169 PNIC 10/100BaseTX> port 0xa000-0xa0ff mem 0xd3800000-0xd38\n" @@ -827,7 +827,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:421 +#: documentation/content/en/books/handbook/config/_index.adoc:420 msgid "" "If the driver for the NIC is not present in [.filename]#GENERIC#, but a " "driver is available, the driver will need to be loaded before the NIC can be " @@ -835,7 +835,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:423 +#: documentation/content/en/books/handbook/config/_index.adoc:422 msgid "" "The easiest way is to load a kernel module for the NIC using man:kldload[8]. " "To also automatically load the driver at boot time, add the appropriate line " @@ -844,7 +844,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:424 +#: documentation/content/en/books/handbook/config/_index.adoc:423 msgid "" "Alternatively, statically compile support for the NIC into a custom kernel. " "Refer to [.filename]#/usr/src/sys/conf/NOTES#, [.filename]#/usr/src/sys/arch/" @@ -856,13 +856,13 @@ msgid "" msgstr "" #. type: Title ==== -#: documentation/content/en/books/handbook/config/_index.adoc:426 +#: documentation/content/en/books/handbook/config/_index.adoc:425 #, no-wrap msgid "Using Windows(R) NDIS Drivers" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:430 +#: documentation/content/en/books/handbook/config/_index.adoc:429 msgid "" "Unfortunately, there are still many vendors that do not provide schematics " "for their drivers to the open source community because they regard such " @@ -873,7 +873,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:435 +#: documentation/content/en/books/handbook/config/_index.adoc:434 msgid "" "FreeBSD provides \"native\" support for the Network Driver Interface " "Specification (NDIS). It includes man:ndisgen[8] which can be used to " @@ -884,28 +884,28 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:437 +#: documentation/content/en/books/handbook/config/_index.adoc:436 msgid "To use man:ndisgen[8], three things are needed:" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:439 +#: documentation/content/en/books/handbook/config/_index.adoc:438 msgid "FreeBSD kernel sources." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:440 +#: documentation/content/en/books/handbook/config/_index.adoc:439 msgid "A Windows(R) XP driver binary with a [.filename]#.SYS# extension." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:441 +#: documentation/content/en/books/handbook/config/_index.adoc:440 msgid "" "A Windows(R) XP driver configuration file with a [.filename]#.INF# extension." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:445 +#: documentation/content/en/books/handbook/config/_index.adoc:444 msgid "" "Download the [.filename]#.SYS# and [.filename]#.INF# files for the specific " "NIC. Generally, these can be found on the driver CD or at the vendor's " @@ -914,7 +914,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:449 +#: documentation/content/en/books/handbook/config/_index.adoc:448 msgid "" "The driver bit width must match the version of FreeBSD. For FreeBSD/i386, " "use a Windows(R) 32-bit driver. For FreeBSD/amd64, a Windows(R) 64-bit " @@ -922,20 +922,20 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:452 +#: documentation/content/en/books/handbook/config/_index.adoc:451 msgid "" "The next step is to compile the driver binary into a loadable kernel " "module. As `root`, use man:ndisgen[8]:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:456 +#: documentation/content/en/books/handbook/config/_index.adoc:455 #, no-wrap msgid "# ndisgen /path/to/W32DRIVER.INF /path/to/W32DRIVER.SYS\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:461 +#: documentation/content/en/books/handbook/config/_index.adoc:460 msgid "" "This command is interactive and prompts for any extra information it " "requires. A new kernel module will be generated in the current directory. " @@ -943,13 +943,13 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:465 +#: documentation/content/en/books/handbook/config/_index.adoc:464 #, no-wrap msgid "# kldload ./W32DRIVER_SYS.ko\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:470 +#: documentation/content/en/books/handbook/config/_index.adoc:469 msgid "" "In addition to the generated kernel module, the [.filename]#ndis.ko# and [." "filename]#if_ndis.ko# modules must be loaded. This should happen " @@ -958,7 +958,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:475 +#: documentation/content/en/books/handbook/config/_index.adoc:474 #, no-wrap msgid "" "# kldload ndis\n" @@ -966,21 +966,21 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:478 +#: documentation/content/en/books/handbook/config/_index.adoc:477 msgid "" "The first command loads the man:ndis[4] miniport driver wrapper and the " "second loads the generated NIC driver." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:481 +#: documentation/content/en/books/handbook/config/_index.adoc:480 msgid "" "Check man:dmesg[8] to see if there were any load errors. If all went well, " "the output should be similar to the following:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:489 +#: documentation/content/en/books/handbook/config/_index.adoc:488 #, no-wrap msgid "" "ndis0: <Wireless-G PCI Adapter> mem 0xf4100000-0xf4101fff irq 3 at device 8.0 on pci1\n" @@ -991,12 +991,12 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:492 +#: documentation/content/en/books/handbook/config/_index.adoc:491 msgid "From here, [.filename]#ndis0# can be configured like any other NIC." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:495 +#: documentation/content/en/books/handbook/config/_index.adoc:494 msgid "" "To configure the system to load the man:ndis[4] modules at boot time, copy " "the generated module, [.filename]#W32DRIVER_SYS.ko#, to [.filename]#/boot/" @@ -1004,19 +1004,19 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:499 +#: documentation/content/en/books/handbook/config/_index.adoc:498 #, no-wrap msgid "W32DRIVER_SYS_load=\"YES\"\n" msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/config/_index.adoc:501 +#: documentation/content/en/books/handbook/config/_index.adoc:500 #, no-wrap msgid "Configuring the Network Card" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:505 +#: documentation/content/en/books/handbook/config/_index.adoc:504 msgid "" "Once the right driver is loaded for the NIC, the card needs to be " "configured. It may have been configured at installation time by man:" @@ -1024,12 +1024,12 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:507 +#: documentation/content/en/books/handbook/config/_index.adoc:506 msgid "To display the NIC configuration, enter the following command:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:529 +#: documentation/content/en/books/handbook/config/_index.adoc:528 #, no-wrap msgid "" "% ifconfig\n" @@ -1054,27 +1054,27 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:532 +#: documentation/content/en/books/handbook/config/_index.adoc:531 msgid "In this example, the following devices were displayed:" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:534 +#: documentation/content/en/books/handbook/config/_index.adoc:533 msgid "[.filename]#dc0#: The first Ethernet interface." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:535 +#: documentation/content/en/books/handbook/config/_index.adoc:534 msgid "[.filename]#dc1#: The second Ethernet interface." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:536 +#: documentation/content/en/books/handbook/config/_index.adoc:535 msgid "[.filename]#lo0#: The loopback device." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:539 +#: documentation/content/en/books/handbook/config/_index.adoc:538 msgid "" "FreeBSD uses the driver name followed by the order in which the card is " "detected at boot to name the NIC. For example, [.filename]#sis2# is the " @@ -1082,40 +1082,40 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:542 +#: documentation/content/en/books/handbook/config/_index.adoc:541 msgid "" "In this example, [.filename]#dc0# is up and running. The key indicators are:" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:544 +#: documentation/content/en/books/handbook/config/_index.adoc:543 msgid "`UP` means that the card is configured and ready." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:545 +#: documentation/content/en/books/handbook/config/_index.adoc:544 msgid "The card has an Internet (`inet`) address, `192.168.1.3`." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:546 +#: documentation/content/en/books/handbook/config/_index.adoc:545 msgid "" "It has a valid subnet mask (`netmask`), where `0xffffff00` is the same as " "`255.255.255.0`." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:547 +#: documentation/content/en/books/handbook/config/_index.adoc:546 msgid "It has a valid broadcast address, `192.168.1.255`." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:548 +#: documentation/content/en/books/handbook/config/_index.adoc:547 msgid "The MAC address of the card (`ether`) is `00:a0:cc:da:da:da`." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:549 +#: documentation/content/en/books/handbook/config/_index.adoc:548 msgid "" "The physical media selection is on autoselection mode (`media: Ethernet " "autoselect (100baseTX <full-duplex>)`). In this example, [.filename]#dc1# is " @@ -1124,7 +1124,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:550 +#: documentation/content/en/books/handbook/config/_index.adoc:549 msgid "" "The status of the link (`status`) is `active`, indicating that the carrier " "signal is detected. For [.filename]#dc1#, the `status: no carrier` status is " @@ -1132,12 +1132,12 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:552 +#: documentation/content/en/books/handbook/config/_index.adoc:551 msgid "If the man:ifconfig[8] output had shown something similar to:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:560 +#: documentation/content/en/books/handbook/config/_index.adoc:559 #, no-wrap msgid "" "dc0: flags=8843<BROADCAST,SIMPLEX,MULTICAST> metric 0 mtu 1500\n" @@ -1148,12 +1148,12 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:563 +#: documentation/content/en/books/handbook/config/_index.adoc:562 msgid "it would indicate the card has not been configured." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:567 +#: documentation/content/en/books/handbook/config/_index.adoc:566 msgid "" "The card must be configured as `root`. The NIC configuration can be " "performed from the command line with man:ifconfig[8] but will not persist " @@ -1162,25 +1162,25 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:571 +#: documentation/content/en/books/handbook/config/_index.adoc:570 #, no-wrap msgid "ifconfig_dc0=\"DHCP\"\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:574 +#: documentation/content/en/books/handbook/config/_index.adoc:573 msgid "Replace _dc0_ with the correct value for the system." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:576 +#: documentation/content/en/books/handbook/config/_index.adoc:575 msgid "" "The line added, then, follow the instructions given in <<config-network-" "testing>>." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/config/_index.adoc:581 +#: documentation/content/en/books/handbook/config/_index.adoc:580 msgid "" "If the network was configured during installation, some entries for the " "NIC(s) may be already present. Double check [.filename]#/etc/rc.conf# " @@ -1188,14 +1188,14 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:585 +#: documentation/content/en/books/handbook/config/_index.adoc:584 msgid "" "If there is no DHCP server, the NIC(s) must be configured manually. Add a " "line for each NIC present on the system, as seen in this example:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:590 +#: documentation/content/en/books/handbook/config/_index.adoc:589 #, no-wrap msgid "" "ifconfig_dc0=\"inet 192.168.1.3 netmask 255.255.255.0\"\n" @@ -1203,7 +1203,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:594 +#: documentation/content/en/books/handbook/config/_index.adoc:593 msgid "" "Replace [.filename]#dc0# and [.filename]#dc1# and the IP address information " "with the correct values for the system. Refer to the man page for the " @@ -1212,7 +1212,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:597 +#: documentation/content/en/books/handbook/config/_index.adoc:596 msgid "" "If the network is not using DNS, edit [.filename]#/etc/hosts# to add the " "names and IP addresses of the hosts on the LAN, if they are not already " @@ -1221,14 +1221,14 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/config/_index.adoc:601 +#: documentation/content/en/books/handbook/config/_index.adoc:600 msgid "" "If there is no DHCP server and access to the Internet is needed, manually " "configure the default gateway and the nameserver:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:606 +#: documentation/content/en/books/handbook/config/_index.adoc:605 #, no-wrap msgid "" "# sysrc defaultrouter=\"your_default_router\"\n" @@ -1236,13 +1236,13 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/config/_index.adoc:611 +#: documentation/content/en/books/handbook/config/_index.adoc:610 #, no-wrap msgid "Testing and Troubleshooting" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/config/_index.adoc:615 +#: documentation/content/en/books/handbook/config/_index.adoc:614 msgid "" "Once the necessary changes to [.filename]#/etc/rc.conf# are saved, a reboot " "can be used to test the network configuration and to verify that the system " @@ -1251,44 +1251,44 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:619 +#: documentation/content/en/books/handbook/config/_index.adoc:618 #, no-wrap msgid "# service netif restart\n" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/config/_index.adoc:624 +#: documentation/content/en/books/handbook/config/_index.adoc:623 msgid "" "If a default gateway has been set in [.filename]#/etc/rc.conf#, also issue " "this command:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:628 +#: documentation/content/en/books/handbook/config/_index.adoc:627 #, no-wrap msgid "# service routing restart\n" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/config/_index.adoc:633 +#: documentation/content/en/books/handbook/config/_index.adoc:632 msgid "Once the networking system has been relaunched, test the NICs." msgstr "" #. type: Title ==== -#: documentation/content/en/books/handbook/config/_index.adoc:634 +#: documentation/content/en/books/handbook/config/_index.adoc:633 #, no-wrap msgid "Testing the Ethernet Card" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/config/_index.adoc:637 +#: documentation/content/en/books/handbook/config/_index.adoc:636 msgid "" "To verify that an Ethernet card is configured correctly, man:ping[8] the " "interface itself, and then man:ping[8] another machine on the LAN:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:647 +#: documentation/content/en/books/handbook/config/_index.adoc:646 #, no-wrap msgid "" "% ping -c5 192.168.1.3\n" @@ -1301,7 +1301,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:651 +#: documentation/content/en/books/handbook/config/_index.adoc:650 #, no-wrap msgid "" "--- 192.168.1.3 ping statistics ---\n" @@ -1310,7 +1310,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:662 +#: documentation/content/en/books/handbook/config/_index.adoc:661 #, no-wrap msgid "" "% ping -c5 192.168.1.2\n" @@ -1323,7 +1323,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:666 +#: documentation/content/en/books/handbook/config/_index.adoc:665 #, no-wrap msgid "" "--- 192.168.1.2 ping statistics ---\n" @@ -1332,7 +1332,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:672 +#: documentation/content/en/books/handbook/config/_index.adoc:671 msgid "" "To test network resolution, use the host name instead of the IP address. If " "there is no DNS server on the network, [.filename]#/etc/hosts# must first be " @@ -1343,13 +1343,13 @@ msgid "" msgstr "" #. type: Title ==== -#: documentation/content/en/books/handbook/config/_index.adoc:673 +#: documentation/content/en/books/handbook/config/_index.adoc:672 #, no-wrap msgid "Troubleshooting" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:677 +#: documentation/content/en/books/handbook/config/_index.adoc:676 msgid "" "When troubleshooting hardware and software configurations, check the simple " "things first. Is the network cable plugged in? Are the network services " @@ -1360,7 +1360,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:680 +#: documentation/content/en/books/handbook/config/_index.adoc:679 msgid "" "If the card works, yet performance is poor, read through man:tuning[7]. " "Also, check the network configuration as incorrect network settings can " @@ -1368,7 +1368,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:685 +#: documentation/content/en/books/handbook/config/_index.adoc:684 msgid "" "Some users experience one or two `device timeout` messages, which is normal " "for some cards. If they continue, or are bothersome, determine if the " @@ -1377,7 +1377,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:690 +#: documentation/content/en/books/handbook/config/_index.adoc:689 msgid "" "To resolve `watchdog timeout` errors, first check the network cable. Many " "cards require a PCI slot which supports bus mastering. On some old " @@ -1386,7 +1386,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:695 +#: documentation/content/en/books/handbook/config/_index.adoc:694 msgid "" "`No route to host` messages occur if the system is unable to route a packet " "to the destination host. This can happen if no default route is specified " @@ -1396,7 +1396,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:699 +#: documentation/content/en/books/handbook/config/_index.adoc:698 msgid "" "`ping: sendto: Permission denied` error messages are often caused by a " "misconfigured firewall. If a firewall is enabled on FreeBSD but no rules " @@ -1406,7 +1406,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:704 +#: documentation/content/en/books/handbook/config/_index.adoc:703 msgid "" "Sometimes performance of the card is poor or below average. In these cases, " "try setting the media selection mode from `autoselect` to the correct media " @@ -1416,13 +1416,13 @@ msgid "" msgstr "" #. type: Title == -#: documentation/content/en/books/handbook/config/_index.adoc:706 +#: documentation/content/en/books/handbook/config/_index.adoc:705 #, no-wrap msgid "Virtual Hosts" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:710 +#: documentation/content/en/books/handbook/config/_index.adoc:709 msgid "" "A common use of FreeBSD is virtual site hosting, where one server appears to " "the network as many servers. This is achieved by assigning multiple network " @@ -1430,7 +1430,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:713 +#: documentation/content/en/books/handbook/config/_index.adoc:712 msgid "" "A given network interface has one \"real\" address, and may have any number " "of \"alias\" addresses. These aliases are normally added by placing alias " @@ -1438,13 +1438,13 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:717 +#: documentation/content/en/books/handbook/config/_index.adoc:716 #, no-wrap msgid "ifconfig_fxp0_alias0=\"inet xxx.xxx.xxx.xxx netmask xxx.xxx.xxx.xxx\"\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:721 +#: documentation/content/en/books/handbook/config/_index.adoc:720 msgid "" "Alias entries must start with `alias__0__` using a sequential number such as " "`alias0`, `alias1`, and so on. The configuration process will stop at the " @@ -1452,7 +1452,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:725 +#: documentation/content/en/books/handbook/config/_index.adoc:724 msgid "" "The calculation of alias netmasks is important. For a given interface, " "there must be one address which correctly represents the network's netmask. " @@ -1461,7 +1461,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:730 +#: documentation/content/en/books/handbook/config/_index.adoc:729 msgid "" "For example, consider the case where the [.filename]#fxp0# interface is " "connected to two networks: `10.1.1.0` with a netmask of `255.255.255.0` and " @@ -1474,14 +1474,14 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:732 +#: documentation/content/en/books/handbook/config/_index.adoc:731 msgid "" "The following [.filename]#/etc/rc.conf# entries configure the adapter " "correctly for this scenario:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:744 +#: documentation/content/en/books/handbook/config/_index.adoc:743 #, no-wrap msgid "" "ifconfig_fxp0=\"inet 10.1.1.1 netmask 255.255.255.0\"\n" @@ -1496,7 +1496,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:748 +#: documentation/content/en/books/handbook/config/_index.adoc:747 msgid "" "A simpler way to express this is with a space-separated list of IP address " "ranges. The first address will be given the indicated subnet mask and the " @@ -1504,19 +1504,19 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:752 +#: documentation/content/en/books/handbook/config/_index.adoc:751 #, no-wrap msgid "ifconfig_fxp0_aliases=\"inet 10.1.1.1-5/24 inet 202.0.75.17-20/28\"\n" msgstr "" #. type: Title == -#: documentation/content/en/books/handbook/config/_index.adoc:755 +#: documentation/content/en/books/handbook/config/_index.adoc:754 #, no-wrap msgid "Configuring System Logging" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:761 +#: documentation/content/en/books/handbook/config/_index.adoc:760 msgid "" "Generating and reading system logs is an important aspect of system " "administration. The information in system logs can be used to detect " @@ -1527,7 +1527,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:767 +#: documentation/content/en/books/handbook/config/_index.adoc:766 msgid "" "FreeBSD provides a system logger, syslogd, to manage logging. By default, " "syslogd is started when the system boots. This is controlled by the " @@ -1538,20 +1538,20 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:769 +#: documentation/content/en/books/handbook/config/_index.adoc:768 msgid "" "This section describes how to configure the FreeBSD system logger for both " "local and remote logging and how to perform log rotation and log management." msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/config/_index.adoc:770 +#: documentation/content/en/books/handbook/config/_index.adoc:769 #, no-wrap msgid "Configuring Local Logging" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:777 +#: documentation/content/en/books/handbook/config/_index.adoc:776 msgid "" "The configuration file, [.filename]#/etc/syslog.conf#, controls what syslogd " "does with log entries as they are received. There are several parameters to " @@ -1565,7 +1565,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:785 +#: documentation/content/en/books/handbook/config/_index.adoc:784 msgid "" "This configuration file contains one line per action, where the syntax for " "each line is a selector field followed by an action field. The syntax of " @@ -1580,7 +1580,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:823 +#: documentation/content/en/books/handbook/config/_index.adoc:822 #, no-wrap msgid "" "# $FreeBSD$\n" @@ -1621,12 +1621,12 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:826 +#: documentation/content/en/books/handbook/config/_index.adoc:825 msgid "In this example:" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:828 +#: documentation/content/en/books/handbook/config/_index.adoc:827 msgid "" "Line 8 matches all messages with a level of `err` or higher, as well as " "`kern.warning`, `auth.notice` and `mail.crit`, and sends these log messages " @@ -1634,21 +1634,21 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:829 +#: documentation/content/en/books/handbook/config/_index.adoc:828 msgid "" "Line 12 matches all messages from the `mail` facility at level `info` or " "above and logs the messages to [.filename]#/var/log/maillog#." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:830 +#: documentation/content/en/books/handbook/config/_index.adoc:829 msgid "" "Line 17 uses a comparison flag (`=`) to only match messages at level `debug` " "and logs them to [.filename]#/var/log/debug.log#." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:831 +#: documentation/content/en/books/handbook/config/_index.adoc:830 msgid "" "Line 33 is an example usage of a program specification. This makes the rules " "following it only valid for the specified program. In this case, only the " @@ -1656,14 +1656,14 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:833 +#: documentation/content/en/books/handbook/config/_index.adoc:832 msgid "" "The available levels, in order from most to least critical are `emerg`, " "`alert`, `crit`, `err`, `warning`, `notice`, `info`, and `debug`." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:836 +#: documentation/content/en/books/handbook/config/_index.adoc:835 msgid "" "The facilities, in no particular order, are `auth`, `authpriv`, `console`, " "`cron`, `daemon`, `ftp`, `kern`, `lpr`, `mail`, `mark`, `news`, `security`, " @@ -1672,20 +1672,20 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:838 +#: documentation/content/en/books/handbook/config/_index.adoc:837 msgid "" "To log everything of level `notice` and higher to [.filename]#/var/log/" "daemon.log#, add the following entry:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:842 +#: documentation/content/en/books/handbook/config/_index.adoc:841 #, no-wrap msgid "daemon.notice /var/log/daemon.log\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:846 +#: documentation/content/en/books/handbook/config/_index.adoc:845 msgid "" "For more information about the different levels and facilities, refer to man:" "syslog[3] and man:syslogd[8]. For more information about [.filename]#/etc/" @@ -1694,13 +1694,13 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/config/_index.adoc:847 +#: documentation/content/en/books/handbook/config/_index.adoc:846 #, no-wrap msgid "Log Management and Rotation" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:856 +#: documentation/content/en/books/handbook/config/_index.adoc:855 msgid "" "Log files can grow quickly, taking up disk space and making it more " "difficult to locate useful information. Log management attempts to mitigate " @@ -1713,7 +1713,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:861 +#: documentation/content/en/books/handbook/config/_index.adoc:860 msgid "" "To know which actions to take, newsyslog reads its configuration file, [." "filename]#/etc/newsyslog.conf#. This file contains one line for each log " @@ -1724,7 +1724,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:903 +#: documentation/content/en/books/handbook/config/_index.adoc:902 #, no-wrap msgid "" "# configuration file for newsyslog\n" @@ -1769,7 +1769,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:912 +#: documentation/content/en/books/handbook/config/_index.adoc:911 msgid "" "Each line starts with the name of the log to be rotated, optionally followed " "by an owner and group for both rotated and newly created files. The `mode` " @@ -1785,7 +1785,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:915 +#: documentation/content/en/books/handbook/config/_index.adoc:914 msgid "" "For more information on all fields, valid flags, and how to specify the " "rotation time, refer to man:newsyslog.conf[5]. Since newsyslog is run from " @@ -1794,13 +1794,13 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/config/_index.adoc:917 +#: documentation/content/en/books/handbook/config/_index.adoc:916 #, no-wrap msgid "Configuring Remote Logging" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:921 +#: documentation/content/en/books/handbook/config/_index.adoc:920 msgid "" "Monitoring the log files of multiple hosts can become unwieldy as the number " "of systems increases. Configuring centralized logging can reduce some of " @@ -1808,7 +1808,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:925 +#: documentation/content/en/books/handbook/config/_index.adoc:924 msgid "" "In FreeBSD, centralized log file aggregation, merging, and rotation can be " "configured using syslogd and newsyslog. This section demonstrates an " @@ -1819,13 +1819,13 @@ msgid "" msgstr "" #. type: Title ==== -#: documentation/content/en/books/handbook/config/_index.adoc:926 +#: documentation/content/en/books/handbook/config/_index.adoc:925 #, no-wrap msgid "Log Server Configuration" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:930 +#: documentation/content/en/books/handbook/config/_index.adoc:929 msgid "" "A log server is a system that has been configured to accept logging " "information from other hosts. Before configuring a log server, check the " @@ -1833,7 +1833,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:932 +#: documentation/content/en/books/handbook/config/_index.adoc:931 msgid "" "If there is a firewall between the logging server and any logging clients, " "ensure that the firewall ruleset allows UDP port 514 for both the clients " @@ -1841,7 +1841,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:933 +#: documentation/content/en/books/handbook/config/_index.adoc:932 msgid "" "The logging server and all client machines must have forward and reverse " "entries in the local DNS. If the network does not have a DNS server, create " @@ -1850,7 +1850,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:936 +#: documentation/content/en/books/handbook/config/_index.adoc:935 msgid "" "On the log server, edit [.filename]#/etc/syslog.conf# to specify the name of " "the client to receive log entries from, the logging facility to be used, and " @@ -1860,13 +1860,13 @@ msgid "" msgstr "" #. type: Block title -#: documentation/content/en/books/handbook/config/_index.adoc:937 +#: documentation/content/en/books/handbook/config/_index.adoc:936 #, no-wrap msgid "Sample Log Server Configuration" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:945 +#: documentation/content/en/books/handbook/config/_index.adoc:944 #, no-wrap msgid "" "+logclient.example.com\n" @@ -1874,7 +1874,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/config/_index.adoc:951 +#: documentation/content/en/books/handbook/config/_index.adoc:950 msgid "" "When adding multiple log clients, add a similar two-line entry for each " "client. More information about the available facilities may be found in man:" @@ -1882,12 +1882,12 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/config/_index.adoc:953 +#: documentation/content/en/books/handbook/config/_index.adoc:952 msgid "Next, configure [.filename]#/etc/rc.conf#:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:958 +#: documentation/content/en/books/handbook/config/_index.adoc:957 #, no-wrap msgid "" "syslogd_enable=\"YES\"\n" @@ -1895,7 +1895,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:964 +#: documentation/content/en/books/handbook/config/_index.adoc:963 msgid "" "The first entry starts syslogd at system boot. The second entry allows log " "entries from the specified client. The `-v -v` increases the verbosity of " @@ -1904,7 +1904,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:968 +#: documentation/content/en/books/handbook/config/_index.adoc:967 msgid "" "Multiple `-a` options may be specified to allow logging from multiple " "clients. IP addresses and whole netblocks may also be specified. Refer to " @@ -1912,23 +1912,23 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:970 +#: documentation/content/en/books/handbook/config/_index.adoc:969 msgid "Finally, create the log file:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:974 +#: documentation/content/en/books/handbook/config/_index.adoc:973 #, no-wrap msgid "# touch /var/log/logclient.log\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:977 +#: documentation/content/en/books/handbook/config/_index.adoc:976 msgid "At this point, syslogd should be restarted and verified:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:982 +#: documentation/content/en/books/handbook/config/_index.adoc:981 #, no-wrap msgid "" "# service syslogd restart\n" @@ -1936,7 +1936,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:986 +#: documentation/content/en/books/handbook/config/_index.adoc:985 msgid "" "If a PID is returned, the server restarted successfully, and client " "configuration can begin. If the server did not restart, consult [." @@ -1944,27 +1944,27 @@ msgid "" msgstr "" #. type: Title ==== -#: documentation/content/en/books/handbook/config/_index.adoc:987 +#: documentation/content/en/books/handbook/config/_index.adoc:986 #, no-wrap msgid "Log Client Configuration" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:991 +#: documentation/content/en/books/handbook/config/_index.adoc:990 msgid "" "A logging client sends log entries to a logging server on the network. The " "client also keeps a local copy of its own logs." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:993 +#: documentation/content/en/books/handbook/config/_index.adoc:992 msgid "" "Once a logging server has been configured, edit [.filename]#/etc/rc.conf# on " "the logging client:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:998 +#: documentation/content/en/books/handbook/config/_index.adoc:997 #, no-wrap msgid "" "syslogd_enable=\"YES\"\n" @@ -1972,7 +1972,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1002 +#: documentation/content/en/books/handbook/config/_index.adoc:1001 msgid "" "The first entry enables syslogd on boot up. The second entry prevents logs " "from being accepted by this client from other hosts (`-s`) and increases the " @@ -1980,7 +1980,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1005 +#: documentation/content/en/books/handbook/config/_index.adoc:1004 msgid "" "Next, define the logging server in the client's [.filename]#/etc/syslog." "conf#. In this example, all logged facilities are sent to a remote system, " @@ -1988,51 +1988,51 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:1009 +#: documentation/content/en/books/handbook/config/_index.adoc:1008 #, no-wrap msgid "*.*\t\t@logserv.example.com\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1012 +#: documentation/content/en/books/handbook/config/_index.adoc:1011 msgid "After saving the edit, restart syslogd for the changes to take effect:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:1016 -#: documentation/content/en/books/handbook/config/_index.adoc:1046 +#: documentation/content/en/books/handbook/config/_index.adoc:1015 +#: documentation/content/en/books/handbook/config/_index.adoc:1045 #, no-wrap msgid "# service syslogd restart\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1019 +#: documentation/content/en/books/handbook/config/_index.adoc:1018 msgid "" "To test that log messages are being sent across the network, use man:" "logger[1] on the client to send a message to syslogd:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:1023 +#: documentation/content/en/books/handbook/config/_index.adoc:1022 #, no-wrap msgid "# logger \"Test message from logclient\"\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1026 +#: documentation/content/en/books/handbook/config/_index.adoc:1025 msgid "" "This message should now exist both in [.filename]#/var/log/messages# on the " "client and [.filename]#/var/log/logclient.log# on the log server." msgstr "" #. type: Title ==== -#: documentation/content/en/books/handbook/config/_index.adoc:1027 +#: documentation/content/en/books/handbook/config/_index.adoc:1026 #, no-wrap msgid "Debugging Log Servers" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1033 +#: documentation/content/en/books/handbook/config/_index.adoc:1032 msgid "" "If no messages are being received on the log server, the cause is most " "likely a network connectivity issue, a hostname resolution issue, or a typo " @@ -2045,7 +2045,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1037 +#: documentation/content/en/books/handbook/config/_index.adoc:1036 msgid "" "If the `ping` succeeds on both hosts but log messages are still not being " "received, temporarily increase logging verbosity to narrow down the " @@ -2057,20 +2057,20 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:1041 +#: documentation/content/en/books/handbook/config/_index.adoc:1040 #, no-wrap msgid "syslogd_flags=\"-d -a logclient.example.com -v -v\"\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1049 +#: documentation/content/en/books/handbook/config/_index.adoc:1048 msgid "" "Debugging data similar to the following will flash on the console " "immediately after the restart:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:1060 +#: documentation/content/en/books/handbook/config/_index.adoc:1059 #, no-wrap msgid "" "logmsg: pri 56, flags 4, from logserv.example.com, msg syslogd: restart\n" @@ -2084,7 +2084,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1065 +#: documentation/content/en/books/handbook/config/_index.adoc:1064 msgid "" "In this example, the log messages are being rejected due to a typo which " "results in a hostname mismatch. The client's hostname should be " @@ -2093,7 +2093,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:1081 +#: documentation/content/en/books/handbook/config/_index.adoc:1080 #, no-wrap msgid "" "# service syslogd restart\n" @@ -2112,20 +2112,20 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1084 +#: documentation/content/en/books/handbook/config/_index.adoc:1083 msgid "" "At this point, the messages are being properly received and placed in the " "correct file." msgstr "" #. type: Title ==== -#: documentation/content/en/books/handbook/config/_index.adoc:1085 +#: documentation/content/en/books/handbook/config/_index.adoc:1084 #, no-wrap msgid "Security Considerations" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1091 +#: documentation/content/en/books/handbook/config/_index.adoc:1090 msgid "" "As with any network service, security requirements should be considered " "before implementing a logging server. Log files may contain sensitive data " @@ -2137,7 +2137,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1099 +#: documentation/content/en/books/handbook/config/_index.adoc:1098 msgid "" "Local security is also an issue. Log files are not encrypted during use or " "after log rotation. Local users may access log files to gain additional " @@ -2149,175 +2149,175 @@ msgid "" msgstr "" #. type: Title == -#: documentation/content/en/books/handbook/config/_index.adoc:1101 +#: documentation/content/en/books/handbook/config/_index.adoc:1100 #, no-wrap msgid "Configuration Files" msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/config/_index.adoc:1103 +#: documentation/content/en/books/handbook/config/_index.adoc:1102 #, no-wrap msgid "[.filename]#/etc# Layout" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1107 +#: documentation/content/en/books/handbook/config/_index.adoc:1106 msgid "" "There are a number of directories in which configuration information is " "kept. These include:" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/config/_index.adoc:1113 +#: documentation/content/en/books/handbook/config/_index.adoc:1112 #, no-wrap msgid "[.filename]#/etc#" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/config/_index.adoc:1115 +#: documentation/content/en/books/handbook/config/_index.adoc:1114 #, no-wrap msgid "Generic system-specific configuration information." msgstr "" #. type: Table -#: documentation/content/en/books/handbook/config/_index.adoc:1116 +#: documentation/content/en/books/handbook/config/_index.adoc:1115 #, no-wrap msgid "[.filename]#/etc/defaults#" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/config/_index.adoc:1118 +#: documentation/content/en/books/handbook/config/_index.adoc:1117 #, no-wrap msgid "Default versions of system configuration files." msgstr "" #. type: Table -#: documentation/content/en/books/handbook/config/_index.adoc:1119 +#: documentation/content/en/books/handbook/config/_index.adoc:1118 #, no-wrap msgid "[.filename]#/etc/mail#" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/config/_index.adoc:1121 +#: documentation/content/en/books/handbook/config/_index.adoc:1120 #, no-wrap msgid "Extra man:sendmail[8] configuration and other MTA configuration files." msgstr "" #. type: Table -#: documentation/content/en/books/handbook/config/_index.adoc:1122 +#: documentation/content/en/books/handbook/config/_index.adoc:1121 #, no-wrap msgid "[.filename]#/etc/ppp#" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/config/_index.adoc:1124 +#: documentation/content/en/books/handbook/config/_index.adoc:1123 #, no-wrap msgid "Configuration for both user- and kernel-ppp programs." msgstr "" #. type: Table -#: documentation/content/en/books/handbook/config/_index.adoc:1125 +#: documentation/content/en/books/handbook/config/_index.adoc:1124 #, no-wrap msgid "[.filename]#/usr/local/etc#" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/config/_index.adoc:1127 +#: documentation/content/en/books/handbook/config/_index.adoc:1126 #, no-wrap msgid "Configuration files for installed applications. May contain per-application subdirectories." msgstr "" #. type: Table -#: documentation/content/en/books/handbook/config/_index.adoc:1128 +#: documentation/content/en/books/handbook/config/_index.adoc:1127 #, no-wrap msgid "[.filename]#/usr/local/etc/rc.d#" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/config/_index.adoc:1130 +#: documentation/content/en/books/handbook/config/_index.adoc:1129 #, no-wrap msgid "man:rc[8] scripts for installed applications." msgstr "" #. type: Table -#: documentation/content/en/books/handbook/config/_index.adoc:1131 +#: documentation/content/en/books/handbook/config/_index.adoc:1130 #, no-wrap msgid "[.filename]#/var/db#" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/config/_index.adoc:1132 +#: documentation/content/en/books/handbook/config/_index.adoc:1131 #, no-wrap msgid "Automatically generated system-specific database files, such as the package database and the man:locate[1] database." msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/config/_index.adoc:1134 +#: documentation/content/en/books/handbook/config/_index.adoc:1133 #, no-wrap msgid "Hostnames" msgstr "" #. type: Title ==== -#: documentation/content/en/books/handbook/config/_index.adoc:1136 +#: documentation/content/en/books/handbook/config/_index.adoc:1135 #, no-wrap msgid "[.filename]#/etc/resolv.conf#" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1139 +#: documentation/content/en/books/handbook/config/_index.adoc:1138 msgid "" "How a FreeBSD system accesses the Internet Domain Name System (DNS) is " "controlled by man:resolv.conf[5]." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1141 +#: documentation/content/en/books/handbook/config/_index.adoc:1140 msgid "The most common entries to [.filename]#/etc/resolv.conf# are:" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/config/_index.adoc:1147 +#: documentation/content/en/books/handbook/config/_index.adoc:1146 #, no-wrap msgid "`nameserver`" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/config/_index.adoc:1149 +#: documentation/content/en/books/handbook/config/_index.adoc:1148 #, no-wrap msgid "The IP address of a name server the resolver should query. The servers are queried in the order listed with a maximum of three." msgstr "" #. type: Table -#: documentation/content/en/books/handbook/config/_index.adoc:1150 +#: documentation/content/en/books/handbook/config/_index.adoc:1149 #, no-wrap msgid "`search`" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/config/_index.adoc:1152 +#: documentation/content/en/books/handbook/config/_index.adoc:1151 #, no-wrap msgid "Search list for hostname lookup. This is normally determined by the domain of the local hostname." msgstr "" #. type: Table -#: documentation/content/en/books/handbook/config/_index.adoc:1153 +#: documentation/content/en/books/handbook/config/_index.adoc:1152 #, no-wrap msgid "`domain`" msgstr "" #. type: Table -#: documentation/content/en/books/handbook/config/_index.adoc:1154 +#: documentation/content/en/books/handbook/config/_index.adoc:1153 #, no-wrap msgid "The local domain name." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1157 +#: documentation/content/en/books/handbook/config/_index.adoc:1156 msgid "A typical [.filename]#/etc/resolv.conf# looks like this:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:1163 +#: documentation/content/en/books/handbook/config/_index.adoc:1162 #, no-wrap msgid "" "search example.com\n" @@ -2326,25 +2326,25 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/config/_index.adoc:1168 +#: documentation/content/en/books/handbook/config/_index.adoc:1167 msgid "Only one of the `search` and `domain` options should be used." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1171 +#: documentation/content/en/books/handbook/config/_index.adoc:1170 msgid "" "When using DHCP, man:dhclient[8] usually rewrites [.filename]#/etc/resolv." "conf# with information received from the DHCP server." msgstr "" #. type: Title ==== -#: documentation/content/en/books/handbook/config/_index.adoc:1172 +#: documentation/content/en/books/handbook/config/_index.adoc:1171 #, no-wrap msgid "[.filename]#/etc/hosts#" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1177 +#: documentation/content/en/books/handbook/config/_index.adoc:1176 msgid "" "[.filename]#/etc/hosts# is a simple text database which works in conjunction " "with DNS and NIS to provide host name to IP address mappings. Entries for " @@ -2356,7 +2356,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:1212 +#: documentation/content/en/books/handbook/config/_index.adoc:1211 #, no-wrap msgid "" "# $FreeBSD$\n" @@ -2394,40 +2394,40 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1215 +#: documentation/content/en/books/handbook/config/_index.adoc:1214 msgid "The format of [.filename]#/etc/hosts# is as follows:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:1219 +#: documentation/content/en/books/handbook/config/_index.adoc:1218 #, no-wrap msgid "[Internet address] [official hostname] [alias1] [alias2] ...\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1222 +#: documentation/content/en/books/handbook/config/_index.adoc:1221 msgid "For example:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:1226 +#: documentation/content/en/books/handbook/config/_index.adoc:1225 #, no-wrap msgid "10.0.0.1 myRealHostname.example.com myRealHostname foobar1 foobar2\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1229 +#: documentation/content/en/books/handbook/config/_index.adoc:1228 msgid "Consult man:hosts[5] for more information." msgstr "" #. type: Title == -#: documentation/content/en/books/handbook/config/_index.adoc:1231 +#: documentation/content/en/books/handbook/config/_index.adoc:1230 #, no-wrap msgid "Tuning with man:sysctl[8]" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1236 +#: documentation/content/en/books/handbook/config/_index.adoc:1235 msgid "" "man:sysctl[8] is used to make changes to a running FreeBSD system. This " "includes many advanced options of the TCP/IP stack and virtual memory system " @@ -2437,30 +2437,30 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1238 +#: documentation/content/en/books/handbook/config/_index.adoc:1237 msgid "" "At its core, man:sysctl[8] serves two functions: to read and to modify " "system settings." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1240 +#: documentation/content/en/books/handbook/config/_index.adoc:1239 msgid "To view all readable variables:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:1244 +#: documentation/content/en/books/handbook/config/_index.adoc:1243 #, no-wrap msgid "% sysctl -a\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1247 +#: documentation/content/en/books/handbook/config/_index.adoc:1246 msgid "To read a particular variable, specify its name:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:1252 +#: documentation/content/en/books/handbook/config/_index.adoc:1251 #, no-wrap msgid "" "% sysctl kern.maxproc\n" @@ -2468,12 +2468,12 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1255 +#: documentation/content/en/books/handbook/config/_index.adoc:1254 msgid "To set a particular variable, use the _variable_=_value_ syntax:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:1260 +#: documentation/content/en/books/handbook/config/_index.adoc:1259 #, no-wrap msgid "" "# sysctl kern.maxfiles=5000\n" @@ -2481,14 +2481,14 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1263 +#: documentation/content/en/books/handbook/config/_index.adoc:1262 msgid "" "Settings of sysctl variables are usually either strings, numbers, or " "booleans, where a boolean is `1` for yes or `0` for no." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1266 +#: documentation/content/en/books/handbook/config/_index.adoc:1265 msgid "" "To automatically set some variables each time the machine boots, add them to " "[.filename]#/etc/sysctl.conf#. For more information, refer to man:sysctl." @@ -2496,13 +2496,13 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/config/_index.adoc:1268 +#: documentation/content/en/books/handbook/config/_index.adoc:1267 #, no-wrap msgid "[.filename]#sysctl.conf#" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1274 +#: documentation/content/en/books/handbook/config/_index.adoc:1273 msgid "" "The configuration file for man:sysctl[8], [.filename]#/etc/sysctl.conf#, " "looks much like [.filename]#/etc/rc.conf#. Values are set in a " @@ -2511,7 +2511,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1276 +#: documentation/content/en/books/handbook/config/_index.adoc:1275 msgid "" "For example, to turn off logging of fatal signal exits and prevent users " "from seeing processes started by other users, the following tunables can be " @@ -2519,7 +2519,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:1281 +#: documentation/content/en/books/handbook/config/_index.adoc:1280 #, no-wrap msgid "" "# Do not log fatal signal exits (e.g., sig 11)\n" @@ -2527,7 +2527,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:1285 +#: documentation/content/en/books/handbook/config/_index.adoc:1284 #, no-wrap msgid "" "# Prevent users from seeing information about processes that\n" @@ -2536,27 +2536,27 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/config/_index.adoc:1288 +#: documentation/content/en/books/handbook/config/_index.adoc:1287 #, no-wrap msgid "man:sysctl[8] Read-only" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1291 +#: documentation/content/en/books/handbook/config/_index.adoc:1290 msgid "" "In some cases it may be desirable to modify read-only man:sysctl[8] values, " "which will require a reboot of the system." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1293 +#: documentation/content/en/books/handbook/config/_index.adoc:1292 msgid "" "For instance, on some laptop models the man:cardbus[4] device will not probe " "memory ranges and will fail with errors similar to:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:1298 +#: documentation/content/en/books/handbook/config/_index.adoc:1297 #, no-wrap msgid "" "cbb0: Could not map register memory\n" @@ -2564,7 +2564,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1303 +#: documentation/content/en/books/handbook/config/_index.adoc:1302 msgid "" "The fix requires the modification of a read-only man:sysctl[8] setting. Add " "`hw.pci.allow_unsupported_io_range=1` to [.filename]#/boot/loader.conf# and " @@ -2572,13 +2572,13 @@ msgid "" msgstr "" #. type: Title == -#: documentation/content/en/books/handbook/config/_index.adoc:1305 +#: documentation/content/en/books/handbook/config/_index.adoc:1304 #, no-wrap msgid "Tuning Disks" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1312 +#: documentation/content/en/books/handbook/config/_index.adoc:1311 msgid "" "The following section will discuss various tuning mechanisms and options " "which may be applied to disk devices. In many cases, disks with mechanical " @@ -2592,19 +2592,19 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/config/_index.adoc:1313 +#: documentation/content/en/books/handbook/config/_index.adoc:1312 #, no-wrap msgid "Sysctl Variables" msgstr "" #. type: Title ==== -#: documentation/content/en/books/handbook/config/_index.adoc:1315 +#: documentation/content/en/books/handbook/config/_index.adoc:1314 #, no-wrap msgid "`vfs.vmiodirenable`" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1326 +#: documentation/content/en/books/handbook/config/_index.adoc:1325 msgid "" "The `vfs.vmiodirenable` man:sysctl[8] variable may be set to either `0` " "(off) or `1` (on). It is set to `1` by default. This variable controls how " @@ -2624,13 +2624,13 @@ msgid "" msgstr "" #. type: Title ==== -#: documentation/content/en/books/handbook/config/_index.adoc:1327 +#: documentation/content/en/books/handbook/config/_index.adoc:1326 #, no-wrap msgid "`vfs.write_behind`" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1333 +#: documentation/content/en/books/handbook/config/_index.adoc:1332 msgid "" "The `vfs.write_behind` man:sysctl[8] variable defaults to `1` (on). This " "tells the file system to issue media writes as full clusters are collected, " @@ -2641,13 +2641,13 @@ msgid "" msgstr "" #. type: Title ==== -#: documentation/content/en/books/handbook/config/_index.adoc:1334 +#: documentation/content/en/books/handbook/config/_index.adoc:1333 #, no-wrap msgid "`vfs.hirunningspace`" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1340 +#: documentation/content/en/books/handbook/config/_index.adoc:1339 msgid "" "The `vfs.hirunningspace` man:sysctl[8] variable determines how much " "outstanding write I/O may be queued to disk controllers system-wide at any " @@ -2659,7 +2659,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1343 +#: documentation/content/en/books/handbook/config/_index.adoc:1342 msgid "" "There are various other buffer cache and VM page cache related man:sysctl[8] " "values. Modifying these values is not recommended as the VM system does a " @@ -2667,13 +2667,13 @@ msgid "" msgstr "" #. type: Title ==== -#: documentation/content/en/books/handbook/config/_index.adoc:1344 +#: documentation/content/en/books/handbook/config/_index.adoc:1343 #, no-wrap msgid "`vm.swap_idle_enabled`" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1352 +#: documentation/content/en/books/handbook/config/_index.adoc:1351 msgid "" "The `vm.swap_idle_enabled` man:sysctl[8] variable is useful in large multi-" "user systems with many active login users and lots of idle processes. Such " @@ -2691,13 +2691,13 @@ msgid "" msgstr "" #. type: Title ==== -#: documentation/content/en/books/handbook/config/_index.adoc:1353 +#: documentation/content/en/books/handbook/config/_index.adoc:1352 #, no-wrap msgid "`hw.ata.wc`" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1361 +#: documentation/content/en/books/handbook/config/_index.adoc:1360 msgid "" "Turning off IDE write caching reduces write bandwidth to IDE disks, but may " "sometimes be necessary due to data consistency issues introduced by hard " @@ -2712,18 +2712,18 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1363 +#: documentation/content/en/books/handbook/config/_index.adoc:1362 msgid "For more information, refer to man:ata[4]." msgstr "" #. type: Title ==== -#: documentation/content/en/books/handbook/config/_index.adoc:1364 +#: documentation/content/en/books/handbook/config/_index.adoc:1363 #, no-wrap msgid "`SCSI_DELAY` (`kern.cam.scsi_delay`)" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1371 +#: documentation/content/en/books/handbook/config/_index.adoc:1370 msgid "" "The `SCSI_DELAY` kernel configuration option may be used to reduce system " "boot times. The defaults are fairly high and can be responsible for `15` " @@ -2734,20 +2734,20 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/config/_index.adoc:1373 +#: documentation/content/en/books/handbook/config/_index.adoc:1372 #, no-wrap msgid "Soft Updates" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1378 +#: documentation/content/en/books/handbook/config/_index.adoc:1377 msgid "" "To fine-tune a file system, use man:tunefs[8]. This program has many " "different options. To toggle Soft Updates on and off, use:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:1383 +#: documentation/content/en/books/handbook/config/_index.adoc:1382 #, no-wrap msgid "" "# tunefs -n enable /filesystem\n" @@ -2755,7 +2755,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1387 +#: documentation/content/en/books/handbook/config/_index.adoc:1386 msgid "" "A file system cannot be modified with man:tunefs[8] while it is mounted. A " "good time to enable Soft Updates is before any partitions have been mounted, " @@ -2763,7 +2763,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1394 +#: documentation/content/en/books/handbook/config/_index.adoc:1393 msgid "" "Soft Updates is recommended for UFS file systems as it drastically improves " "meta-data performance, mainly file creation and deletion, through the use of " @@ -2778,13 +2778,13 @@ msgid "" msgstr "" #. type: Title ==== -#: documentation/content/en/books/handbook/config/_index.adoc:1395 +#: documentation/content/en/books/handbook/config/_index.adoc:1394 #, no-wrap msgid "More Details About Soft Updates" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1399 +#: documentation/content/en/books/handbook/config/_index.adoc:1398 msgid "" "Meta-data updates are updates to non-content data like inodes or " "directories. There are two traditional approaches to writing a file " @@ -2792,7 +2792,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1412 +#: documentation/content/en/books/handbook/config/_index.adoc:1411 msgid "" "Historically, the default behavior was to write out meta-data updates " "synchronously. If a directory changed, the system waited until the change " @@ -2813,7 +2813,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1423 +#: documentation/content/en/books/handbook/config/_index.adoc:1422 msgid "" "The second approach is to use asynchronous meta-data updates. This is the " "default for a UFS file system mounted with `mount -o async`. Since all meta-" @@ -2838,7 +2838,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1431 +#: documentation/content/en/books/handbook/config/_index.adoc:1430 msgid "" "The usual solution for this problem is to implement _dirty region logging_, " "which is also referred to as _journaling_. Meta-data updates are still " @@ -2857,7 +2857,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1447 +#: documentation/content/en/books/handbook/config/_index.adoc:1446 msgid "" "Kirk McKusick, the developer of Berkeley FFS, solved this problem with Soft " "Updates. All pending meta-data updates are kept in memory and written out " @@ -2887,7 +2887,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1454 +#: documentation/content/en/books/handbook/config/_index.adoc:1453 msgid "" "The advantage is that meta-data operations are nearly as fast as " "asynchronous updates and are faster than _logging_, which has to write the " @@ -2904,25 +2904,25 @@ msgid "" msgstr "" #. type: Title == -#: documentation/content/en/books/handbook/config/_index.adoc:1456 +#: documentation/content/en/books/handbook/config/_index.adoc:1455 #, no-wrap msgid "Tuning Kernel Limits" msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/config/_index.adoc:1459 +#: documentation/content/en/books/handbook/config/_index.adoc:1458 #, no-wrap msgid "File/Process Limits" msgstr "" #. type: Title ==== -#: documentation/content/en/books/handbook/config/_index.adoc:1462 +#: documentation/content/en/books/handbook/config/_index.adoc:1461 #, no-wrap msgid "`kern.maxfiles`" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1467 +#: documentation/content/en/books/handbook/config/_index.adoc:1466 msgid "" "The `kern.maxfiles` man:sysctl[8] variable can be raised or lowered based " "upon system requirements. This variable indicates the maximum number of " @@ -2932,7 +2932,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1470 +#: documentation/content/en/books/handbook/config/_index.adoc:1469 msgid "" "Each open file, socket, or fifo uses one file descriptor. A large-scale " "production server may easily require many thousands of file descriptors, " @@ -2940,7 +2940,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1476 +#: documentation/content/en/books/handbook/config/_index.adoc:1475 msgid "" "In older FreeBSD releases, the default value of `kern.maxfiles` is derived " "from `maxusers` in the kernel configuration file. `kern.maxfiles` grows " @@ -2952,7 +2952,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1482 +#: documentation/content/en/books/handbook/config/_index.adoc:1481 msgid "" "The read-only man:sysctl[8] variable `kern.maxusers` is automatically sized " "at boot based on the amount of memory available in the system, and may be " @@ -2967,7 +2967,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1490 +#: documentation/content/en/books/handbook/config/_index.adoc:1489 msgid "" "In older releases, the system will auto-tune `maxusers` if it is set to `0`. " "footnote:[The auto-tuning algorithm sets maxusers equal to the amount of " @@ -2987,7 +2987,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/config/_index.adoc:1495 +#: documentation/content/en/books/handbook/config/_index.adoc:1494 msgid "" "`maxusers` does _not_ limit the number of users which can log into the " "machine. It instead sets various table sizes to reasonable values " @@ -2996,13 +2996,13 @@ msgid "" msgstr "" #. type: Title ==== -#: documentation/content/en/books/handbook/config/_index.adoc:1497 +#: documentation/content/en/books/handbook/config/_index.adoc:1496 #, no-wrap msgid "`kern.ipc.soacceptqueue`" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1504 +#: documentation/content/en/books/handbook/config/_index.adoc:1503 msgid "" "The `kern.ipc.soacceptqueue` man:sysctl[8] variable limits the size of the " "listen queue for accepting new `TCP` connections. The default value of " @@ -3015,13 +3015,13 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/config/_index.adoc:1506 +#: documentation/content/en/books/handbook/config/_index.adoc:1505 #, no-wrap msgid "Network Limits" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1517 +#: documentation/content/en/books/handbook/config/_index.adoc:1516 msgid "" "The `NMBCLUSTERS` kernel configuration option dictates the amount of network " "Mbufs available to the system. A heavily-trafficked server with a low " @@ -3039,7 +3039,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1520 +#: documentation/content/en/books/handbook/config/_index.adoc:1519 msgid "" "The `kern.ipc.nmbclusters` loader tunable should be used to tune this at " "boot time. Only older versions of FreeBSD will require the use of the " @@ -3047,7 +3047,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1525 +#: documentation/content/en/books/handbook/config/_index.adoc:1524 msgid "" "For busy servers that make extensive use of the man:sendfile[2] system call, " "it may be necessary to increase the number of man:sendfile[2] buffers via " @@ -3060,7 +3060,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/config/_index.adoc:1529 +#: documentation/content/en/books/handbook/config/_index.adoc:1528 msgid "" "Even though a socket has been marked as non-blocking, calling man:" "sendfile[2] on the non-blocking socket may result in the man:sendfile[2] " @@ -3068,13 +3068,13 @@ msgid "" msgstr "" #. type: Title ==== -#: documentation/content/en/books/handbook/config/_index.adoc:1531 +#: documentation/content/en/books/handbook/config/_index.adoc:1530 #, no-wrap msgid "`net.inet.ip.portrange.*`" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1543 +#: documentation/content/en/books/handbook/config/_index.adoc:1542 msgid "" "The `net.inet.ip.portrange.*` man:sysctl[8] variables control the port " "number ranges automatically bound to `TCP` and `UDP` sockets. There are " @@ -3097,19 +3097,19 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/config/_index.adoc:1544 +#: documentation/content/en/books/handbook/config/_index.adoc:1543 #, no-wrap msgid "Virtual Memory" msgstr "" #. type: Title ==== -#: documentation/content/en/books/handbook/config/_index.adoc:1546 +#: documentation/content/en/books/handbook/config/_index.adoc:1545 #, no-wrap msgid "`kern.maxvnodes`" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1553 +#: documentation/content/en/books/handbook/config/_index.adoc:1552 msgid "" "A vnode is the internal representation of a file or directory. Increasing " "the number of vnodes available to the operating system reduces disk I/O. " @@ -3120,12 +3120,12 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1555 +#: documentation/content/en/books/handbook/config/_index.adoc:1554 msgid "To see the current number of vnodes in use:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:1560 +#: documentation/content/en/books/handbook/config/_index.adoc:1559 #, no-wrap msgid "" "# sysctl vfs.numvnodes\n" @@ -3133,12 +3133,12 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1563 +#: documentation/content/en/books/handbook/config/_index.adoc:1562 msgid "To see the maximum vnodes:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:1568 +#: documentation/content/en/books/handbook/config/_index.adoc:1567 #, no-wrap msgid "" "# sysctl kern.maxvnodes\n" @@ -3146,7 +3146,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1574 +#: documentation/content/en/books/handbook/config/_index.adoc:1573 msgid "" "If the current vnode usage is near the maximum, try increasing `kern." "maxvnodes` by a value of `1000`. Keep an eye on the number of `vfs." @@ -3156,13 +3156,13 @@ msgid "" msgstr "" #. type: Title == -#: documentation/content/en/books/handbook/config/_index.adoc:1576 +#: documentation/content/en/books/handbook/config/_index.adoc:1575 #, no-wrap msgid "Adding Swap Space" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1580 +#: documentation/content/en/books/handbook/config/_index.adoc:1579 msgid "" "Sometimes a system requires more swap space. This section describes two " "methods to increase swap space: adding swap to an existing partition or new " @@ -3170,7 +3170,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1582 +#: documentation/content/en/books/handbook/config/_index.adoc:1581 msgid "" "For information on how to encrypt swap space, which options exist, and why " "it should be done, refer to crossref:disks[swap-encrypting,“Encrypting " @@ -3178,13 +3178,13 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/config/_index.adoc:1584 +#: documentation/content/en/books/handbook/config/_index.adoc:1583 #, no-wrap msgid "Swap on a New Hard Drive or Existing Partition" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1588 +#: documentation/content/en/books/handbook/config/_index.adoc:1587 msgid "" "Adding a new hard drive for swap gives better performance than using a " "partition on an existing drive. Setting up partitions and hard drives is " @@ -3194,18 +3194,18 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1591 +#: documentation/content/en/books/handbook/config/_index.adoc:1590 msgid "Use `swapon` to add a swap partition to the system. For example:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:1595 +#: documentation/content/en/books/handbook/config/_index.adoc:1594 #, no-wrap msgid "# swapon /dev/ada1s1b\n" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/config/_index.adoc:1603 +#: documentation/content/en/books/handbook/config/_index.adoc:1602 msgid "" "It is possible to use any partition not currently mounted, even if it " "already contains data. Using `swapon` on a partition that contains data " @@ -3214,41 +3214,41 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1606 +#: documentation/content/en/books/handbook/config/_index.adoc:1605 msgid "" "To automatically add this swap partition on boot, add an entry to [." "filename]#/etc/fstab#:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:1610 +#: documentation/content/en/books/handbook/config/_index.adoc:1609 #, no-wrap msgid "/dev/ada1s1b\tnone\tswap\tsw\t0\t0\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1614 +#: documentation/content/en/books/handbook/config/_index.adoc:1613 msgid "" "See man:fstab[5] for an explanation of the entries in [.filename]#/etc/" "fstab#. More information about `swapon` can be found in man:swapon[8]." msgstr "" #. type: Block title -#: documentation/content/en/books/handbook/config/_index.adoc:1616 -#: documentation/content/en/books/handbook/config/_index.adoc:1624 +#: documentation/content/en/books/handbook/config/_index.adoc:1615 +#: documentation/content/en/books/handbook/config/_index.adoc:1623 #, no-wrap msgid "Creating a Swap File" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1619 +#: documentation/content/en/books/handbook/config/_index.adoc:1618 msgid "" "These examples create a 512M swap file called [.filename]#/usr/swap0# " "instead of using a partition." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1622 +#: documentation/content/en/books/handbook/config/_index.adoc:1621 msgid "" "Using swap files requires that the module needed by man:md[4] has either " "been built into the kernel or has been loaded before swap is enabled. See " @@ -3257,61 +3257,61 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/config/_index.adoc:1629 +#: documentation/content/en/books/handbook/config/_index.adoc:1628 msgid "Create the swap file:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:1633 +#: documentation/content/en/books/handbook/config/_index.adoc:1632 #, no-wrap msgid "# dd if=/dev/zero of=/usr/swap0 bs=1m count=512\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1636 +#: documentation/content/en/books/handbook/config/_index.adoc:1635 msgid "Set the proper permissions on the new file:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:1640 +#: documentation/content/en/books/handbook/config/_index.adoc:1639 #, no-wrap msgid "# chmod 0600 /usr/swap0\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1643 +#: documentation/content/en/books/handbook/config/_index.adoc:1642 msgid "" "Inform the system about the swap file by adding a line to [.filename]#/etc/" "fstab#:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:1647 +#: documentation/content/en/books/handbook/config/_index.adoc:1646 #, no-wrap msgid "md\tnone\tswap\tsw,file=/usr/swap0,late\t0\t0\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1650 +#: documentation/content/en/books/handbook/config/_index.adoc:1649 msgid "" "Swap space will be added on system startup. To add swap space immediately, " "use man:swapon[8]:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:1654 +#: documentation/content/en/books/handbook/config/_index.adoc:1653 #, no-wrap msgid "# swapon -aL\n" msgstr "" #. type: Title == -#: documentation/content/en/books/handbook/config/_index.adoc:1659 +#: documentation/content/en/books/handbook/config/_index.adoc:1658 #, no-wrap msgid "Power and Resource Management" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/config/_index.adoc:1669 +#: documentation/content/en/books/handbook/config/_index.adoc:1668 msgid "" "It is important to utilize hardware resources in an efficient manner. Power " "and resource management allows the operating system to monitor system limits " @@ -3328,7 +3328,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/config/_index.adoc:1677 +#: documentation/content/en/books/handbook/config/_index.adoc:1676 msgid "" "There are four major problems in APM. First, power management is done by " "the vendor-specific BIOS, separate from the operating system. For example, " @@ -3346,7 +3346,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/config/_index.adoc:1682 +#: documentation/content/en/books/handbook/config/_index.adoc:1681 msgid "" "The Plug and Play BIOS (PNPBIOS) was unreliable in many situations. PNPBIOS " "is 16-bit technology, so the operating system has to use 16-bit emulation in " @@ -3356,7 +3356,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/config/_index.adoc:1686 +#: documentation/content/en/books/handbook/config/_index.adoc:1685 msgid "" "The successor to APM is the Advanced Configuration and Power Interface " "(ACPI). ACPI is a standard written by an alliance of vendors to provide an " @@ -3366,7 +3366,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/config/_index.adoc:1689 +#: documentation/content/en/books/handbook/config/_index.adoc:1688 msgid "" "This chapter demonstrates how to configure ACPI on FreeBSD. It then offers " "some tips on how to debug ACPI and how to submit a problem report containing " @@ -3374,13 +3374,13 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/config/_index.adoc:1691 +#: documentation/content/en/books/handbook/config/_index.adoc:1690 #, no-wrap msgid "Configuring ACPI" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/config/_index.adoc:1696 +#: documentation/content/en/books/handbook/config/_index.adoc:1695 msgid "" "In FreeBSD the man:acpi[4] driver is loaded by default at system boot and " "should _not_ be compiled into the kernel. This driver cannot be unloaded " @@ -3392,14 +3392,14 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1701 +#: documentation/content/en/books/handbook/config/_index.adoc:1700 msgid "" "ACPI and APM cannot coexist and should be used separately. The last one to " "load will terminate if the driver notices the other is running." msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/config/_index.adoc:1706 +#: documentation/content/en/books/handbook/config/_index.adoc:1705 msgid "" "ACPI can be used to put the system into a sleep mode with `acpiconf`, the `-" "s` flag, and a number from `1` to `5`. Most users only need `1` (quick " @@ -3408,7 +3408,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/config/_index.adoc:1711 +#: documentation/content/en/books/handbook/config/_index.adoc:1710 msgid "" "The man:acpi_video[4] driver uses link:https://uefi.org/specs/ACPI/6.4/" "Apx_B_Video_Extensions/Apx_B_Video_Extensions.html[ACPI Video Extensions] to " @@ -3419,7 +3419,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/config/_index.adoc:1719 +#: documentation/content/en/books/handbook/config/_index.adoc:1718 msgid "" "... # cat /var/run/devd.pipe !system=ACPI subsystem=Video type=brightness " "notify=62 !system=ACPI subsystem=Video type=brightness notify=63 !" @@ -3427,20 +3427,20 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/config/_index.adoc:1722 +#: documentation/content/en/books/handbook/config/_index.adoc:1721 msgid "" "Other options are available using `sysctl`. Refer to man:acpi[4] and man:" "acpiconf[8] for more information." msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/config/_index.adoc:1724 +#: documentation/content/en/books/handbook/config/_index.adoc:1723 #, no-wrap msgid "Common Problems" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/config/_index.adoc:1731 +#: documentation/content/en/books/handbook/config/_index.adoc:1730 msgid "" "ACPI is present in all modern computers that conform to the ia32 (x86) and " "amd64 (AMD) architectures. The full standard has many features including " @@ -3453,7 +3453,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/config/_index.adoc:1735 +#: documentation/content/en/books/handbook/config/_index.adoc:1734 msgid "" "An ACPI-compliant system has various components. The BIOS and chipset " "vendors provide various fixed tables, such as FADT, in memory that specify " @@ -3464,7 +3464,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/config/_index.adoc:1741 +#: documentation/content/en/books/handbook/config/_index.adoc:1740 msgid "" "The ACPI driver must parse the fixed tables, implement an interpreter for " "the bytecode, and modify device drivers and the kernel to accept information " @@ -3477,7 +3477,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/config/_index.adoc:1745 +#: documentation/content/en/books/handbook/config/_index.adoc:1744 msgid "" "For ACPI to work correctly, all the parts have to work correctly. Here are " "some common problems, in order of frequency of appearance, and some possible " @@ -3486,13 +3486,13 @@ msgid "" msgstr "" #. type: Title ==== -#: documentation/content/en/books/handbook/config/_index.adoc:1746 +#: documentation/content/en/books/handbook/config/_index.adoc:1745 #, no-wrap msgid "Mouse Issues" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/config/_index.adoc:1750 +#: documentation/content/en/books/handbook/config/_index.adoc:1749 msgid "" "In some cases, resuming from a suspend operation will cause the mouse to " "fail. A known work around is to add `hint.psm.0.flags=\"0x3000\"` to [." @@ -3500,13 +3500,13 @@ msgid "" msgstr "" #. type: Title ==== -#: documentation/content/en/books/handbook/config/_index.adoc:1751 +#: documentation/content/en/books/handbook/config/_index.adoc:1750 #, no-wrap msgid "Suspend/Resume" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/config/_index.adoc:1757 +#: documentation/content/en/books/handbook/config/_index.adoc:1756 msgid "" "ACPI has three suspend to RAM (STR) states, `S1`-`S3`, and one suspend to " "disk state (STD), called `S4`. STD can be implemented in two separate " @@ -3516,14 +3516,14 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/config/_index.adoc:1760 +#: documentation/content/en/books/handbook/config/_index.adoc:1759 msgid "" "Use `sysctl hw.acpi` to check for the suspend-related items. These example " "results are from a Thinkpad:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:1765 +#: documentation/content/en/books/handbook/config/_index.adoc:1764 #, no-wrap msgid "" "hw.acpi.supported_sleep_state: S3 S4 S5\n" @@ -3531,14 +3531,14 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1769 +#: documentation/content/en/books/handbook/config/_index.adoc:1768 msgid "" "Use `acpiconf -s` to test `S3`, `S4`, and `S5`. An `s4bios` of one (`1`) " "indicates ``S4``BIOS support instead of `S4` operating system support." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1775 +#: documentation/content/en/books/handbook/config/_index.adoc:1774 msgid "" "When testing suspend/resume, start with `S1`, if supported. This state is " "most likely to work since it does not require much driver support. No one " @@ -3548,7 +3548,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1778 +#: documentation/content/en/books/handbook/config/_index.adoc:1777 msgid "" "A common problem with suspend/resume is that many device drivers do not " "save, restore, or reinitialize their firmware, registers, or device memory " @@ -3556,7 +3556,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:1784 +#: documentation/content/en/books/handbook/config/_index.adoc:1783 #, no-wrap msgid "" "# sysctl debug.bootverbose=1\n" @@ -3565,7 +3565,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1789 +#: documentation/content/en/books/handbook/config/_index.adoc:1788 msgid "" "This test emulates the suspend/resume cycle of all device drivers without " "actually going into `S3` state. In some cases, problems such as losing " @@ -3576,7 +3576,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1791 +#: documentation/content/en/books/handbook/config/_index.adoc:1790 msgid "" "If the previous test worked, on a laptop it is possible to configure the " "system to suspend into `S3` on lid close and resume when it is open back " @@ -3584,24 +3584,24 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:1795 +#: documentation/content/en/books/handbook/config/_index.adoc:1794 #, no-wrap msgid "# sysctl hw.acpi.lid_switch_state=S3\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1798 +#: documentation/content/en/books/handbook/config/_index.adoc:1797 msgid "This change can be made persistent across reboots:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:1802 +#: documentation/content/en/books/handbook/config/_index.adoc:1801 #, no-wrap msgid "# echo 'hw.acpi.lid_switch_state=S3' >> /etc/sysctl.conf\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1805 +#: documentation/content/en/books/handbook/config/_index.adoc:1804 msgid "" "Harder cases require additional hardware, such as a serial port and cable " "for debugging through a serial console, a Firewire port and cable for using " @@ -3609,7 +3609,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1812 +#: documentation/content/en/books/handbook/config/_index.adoc:1811 msgid "" "To help isolate the problem, unload as many drivers as possible. If it " "works, narrow down which driver is the problem by loading drivers until it " @@ -3623,7 +3623,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1818 +#: documentation/content/en/books/handbook/config/_index.adoc:1817 msgid "" "Try loading a recent Linux(R) distribution to see if suspend/resume works on " "the same hardware. If it works on Linux(R), it is likely a FreeBSD driver " @@ -3636,7 +3636,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1822 +#: documentation/content/en/books/handbook/config/_index.adoc:1821 msgid "" "Finally, try disabling ACPI and enabling APM instead. If suspend/resume " "works with APM, stick with APM, especially on older hardware (pre-2000). It " @@ -3645,13 +3645,13 @@ msgid "" msgstr "" #. type: Title ==== -#: documentation/content/en/books/handbook/config/_index.adoc:1823 +#: documentation/content/en/books/handbook/config/_index.adoc:1822 #, no-wrap msgid "System Hangs" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1827 +#: documentation/content/en/books/handbook/config/_index.adoc:1826 msgid "" "Most system hangs are a result of lost interrupts or an interrupt storm. " "Chipsets may have problems based on boot, how the BIOS configures interrupts " @@ -3660,7 +3660,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1831 +#: documentation/content/en/books/handbook/config/_index.adoc:1830 msgid "" "Interrupt storms can be distinguished from lost interrupts by checking the " "output of `vmstat -i` and looking at the line that has `acpi0`. If the " @@ -3670,20 +3670,20 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1833 +#: documentation/content/en/books/handbook/config/_index.adoc:1832 msgid "" "When dealing with interrupt problems, try disabling APIC support with `hint." "apic.0.disabled=\"1\"` in [.filename]#/boot/loader.conf#." msgstr "" #. type: Title ==== -#: documentation/content/en/books/handbook/config/_index.adoc:1834 +#: documentation/content/en/books/handbook/config/_index.adoc:1833 #, no-wrap msgid "Panics" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1841 +#: documentation/content/en/books/handbook/config/_index.adoc:1840 msgid "" "Panics are relatively rare for ACPI and are the top priority to be fixed. " "The first step is to isolate the steps to reproduce the panic, if possible, " @@ -3695,7 +3695,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1845 +#: documentation/content/en/books/handbook/config/_index.adoc:1844 msgid "" "Then, try to isolate the problem by booting with ACPI disabled. If that " "works, isolate the ACPI subsystem by using various values of `debug.acpi." @@ -3703,13 +3703,13 @@ msgid "" msgstr "" #. type: Title ==== -#: documentation/content/en/books/handbook/config/_index.adoc:1846 +#: documentation/content/en/books/handbook/config/_index.adoc:1845 #, no-wrap msgid "System Powers Up After Suspend or Shutdown" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1852 +#: documentation/content/en/books/handbook/config/_index.adoc:1851 msgid "" "First, try setting `hw.acpi.disable_on_poweroff=\"0\"` in [.filename]#/boot/" "loader.conf#. This keeps ACPI from disabling various events during the " @@ -3719,20 +3719,20 @@ msgid "" msgstr "" #. type: Title ==== -#: documentation/content/en/books/handbook/config/_index.adoc:1854 +#: documentation/content/en/books/handbook/config/_index.adoc:1853 #, no-wrap msgid "BIOS Contains Buggy Bytecode" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1858 +#: documentation/content/en/books/handbook/config/_index.adoc:1857 msgid "" "Some BIOS vendors provide incorrect or buggy bytecode. This is usually " "manifested by kernel console messages like this:" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:1863 +#: documentation/content/en/books/handbook/config/_index.adoc:1862 #, no-wrap msgid "" "ACPI-1287: *** Error: Method execution failed [\\\\_SB_.PCI0.LPC0.FIGD._STA] \\\\\n" @@ -3740,7 +3740,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1867 +#: documentation/content/en/books/handbook/config/_index.adoc:1866 msgid "" "Often, these problems may be resolved by updating the BIOS to the latest " "revision. Most console messages are harmless, but if there are other " @@ -3749,13 +3749,13 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/config/_index.adoc:1868 +#: documentation/content/en/books/handbook/config/_index.adoc:1867 #, no-wrap msgid "Overriding the Default AML" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1872 +#: documentation/content/en/books/handbook/config/_index.adoc:1871 msgid "" "The BIOS bytecode, known as ACPI Machine Language (AML), is compiled from a " "source language called ACPI Source Language (ASL). The AML is found in the " @@ -3763,7 +3763,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1877 +#: documentation/content/en/books/handbook/config/_index.adoc:1876 msgid "" "The goal of FreeBSD is for everyone to have working ACPI without any user " "intervention. Workarounds are still being developed for common mistakes " @@ -3776,7 +3776,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1880 +#: documentation/content/en/books/handbook/config/_index.adoc:1879 msgid "" "To help identify buggy behavior and possibly fix it manually, a copy can be " "made of the system's ASL. To copy the system's ASL to a specified file " @@ -3785,13 +3785,13 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:1884 +#: documentation/content/en/books/handbook/config/_index.adoc:1883 #, no-wrap msgid "# acpidump -td > my.asl\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1888 +#: documentation/content/en/books/handbook/config/_index.adoc:1887 msgid "" "Some AML versions assume the user is running Windows(R). To override this, " "set `hw.acpi.osname=_\"Windows 2009\"_` in [.filename]#/boot/loader.conf#, " @@ -3799,7 +3799,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1892 +#: documentation/content/en/books/handbook/config/_index.adoc:1891 msgid "" "Other workarounds may require [.filename]#my.asl# to be customized. If this " "file is edited, compile the new ASL using the following command. Warnings " @@ -3808,13 +3808,13 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:1896 +#: documentation/content/en/books/handbook/config/_index.adoc:1895 #, no-wrap msgid "# iasl -f my.asl\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1900 +#: documentation/content/en/books/handbook/config/_index.adoc:1899 msgid "" "Including `-f` forces creation of the AML, even if there are errors during " "compilation. Some errors, such as missing return statements, are " @@ -3822,7 +3822,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1903 +#: documentation/content/en/books/handbook/config/_index.adoc:1902 msgid "" "The default output filename for `iasl` is [.filename]#DSDT.aml#. Load this " "file instead of the BIOS's buggy copy, which is still present in flash " @@ -3830,7 +3830,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:1908 +#: documentation/content/en/books/handbook/config/_index.adoc:1907 #, no-wrap msgid "" "acpi_dsdt_load=\"YES\"\n" @@ -3838,7 +3838,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1912 +#: documentation/content/en/books/handbook/config/_index.adoc:1911 msgid "" "Be sure to copy [.filename]#DSDT.aml# to [.filename]#/boot#, then reboot the " "system. If this fixes the problem, send a man:diff[1] of the old and new " @@ -3847,13 +3847,13 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/config/_index.adoc:1914 +#: documentation/content/en/books/handbook/config/_index.adoc:1913 #, no-wrap msgid "Getting and Submitting Debugging Info" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1922 +#: documentation/content/en/books/handbook/config/_index.adoc:1921 msgid "" "The ACPI driver has a flexible debugging facility. A set of subsystems and " "the level of verbosity can be specified. The subsystems to debug are " @@ -3868,7 +3868,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1926 +#: documentation/content/en/books/handbook/config/_index.adoc:1925 msgid "" "Debugging output is not enabled by default. To enable it, add `options " "ACPI_DEBUG` to the custom kernel configuration file if ACPI is compiled into " @@ -3878,13 +3878,13 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:1930 +#: documentation/content/en/books/handbook/config/_index.adoc:1929 #, no-wrap msgid "# cd /sys/modules/acpi/acpi && make clean && make ACPI_DEBUG=1\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1934 +#: documentation/content/en/books/handbook/config/_index.adoc:1933 msgid "" "Copy the compiled [.filename]#acpi.ko# to [.filename]#/boot/kernel# and add " "the desired level and layer to [.filename]#/boot/loader.conf#. The entries " @@ -3893,7 +3893,7 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:1939 +#: documentation/content/en/books/handbook/config/_index.adoc:1938 #, no-wrap msgid "" "debug.acpi.layer=\"ACPI_ALL_COMPONENTS ACPI_ALL_DRIVERS\"\n" @@ -3901,7 +3901,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1944 +#: documentation/content/en/books/handbook/config/_index.adoc:1943 msgid "" "If the required information is triggered by a specific event, such as a " "suspend and then resume, do not modify [.filename]#/boot/loader.conf#. " @@ -3912,7 +3912,7 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1946 +#: documentation/content/en/books/handbook/config/_index.adoc:1945 msgid "" "Once the debugging information is gathered, it can be sent to {freebsd-acpi} " "so that it can be used by the FreeBSD ACPI maintainers to identify the root " @@ -3920,7 +3920,7 @@ msgid "" msgstr "" #. type: delimited block = 4 -#: documentation/content/en/books/handbook/config/_index.adoc:1950 +#: documentation/content/en/books/handbook/config/_index.adoc:1949 msgid "" "Before submitting debugging information to this mailing list, ensure the " "latest BIOS version is installed and, if available, the embedded controller " @@ -3928,12 +3928,12 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1953 +#: documentation/content/en/books/handbook/config/_index.adoc:1952 msgid "When submitting a problem report, include the following information:" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1955 +#: documentation/content/en/books/handbook/config/_index.adoc:1954 msgid "" "Description of the buggy behavior, including system type, model, and " "anything that causes the bug to appear. Note as accurately as possible when " @@ -3941,27 +3941,27 @@ msgid "" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1956 +#: documentation/content/en/books/handbook/config/_index.adoc:1955 msgid "" "The output of `dmesg` after running `boot -v`, including any error messages " "generated by the bug." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1957 +#: documentation/content/en/books/handbook/config/_index.adoc:1956 msgid "" "The `dmesg` output from `boot -v` with ACPI disabled, if disabling ACPI " "helps to fix the problem." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1958 +#: documentation/content/en/books/handbook/config/_index.adoc:1957 msgid "" "Output from `sysctl hw.acpi`. This lists which features the system offers." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1959 +#: documentation/content/en/books/handbook/config/_index.adoc:1958 msgid "" "The URL to a pasted version of the system's ASL. Do _not_ send the ASL " "directly to the list as it can be very large. Generate a copy of the ASL by " @@ -3969,20 +3969,20 @@ msgid "" msgstr "" #. type: delimited block . 4 -#: documentation/content/en/books/handbook/config/_index.adoc:1963 +#: documentation/content/en/books/handbook/config/_index.adoc:1962 #, no-wrap msgid "# acpidump -dt > name-system.asl\n" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1967 +#: documentation/content/en/books/handbook/config/_index.adoc:1966 msgid "" "Substitute the login name for _name_ and manufacturer/model for _system_. " "For example, use [.filename]#njl-FooCo6000.asl#." msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1974 +#: documentation/content/en/books/handbook/config/_index.adoc:1973 msgid "" "Most FreeBSD developers watch the {freebsd-current}, but one should submit " "problems to {freebsd-acpi} to be sure it is seen. Be patient when waiting " @@ -3994,32 +3994,32 @@ msgid "" msgstr "" #. type: Title === -#: documentation/content/en/books/handbook/config/_index.adoc:1976 +#: documentation/content/en/books/handbook/config/_index.adoc:1975 #, no-wrap msgid "References" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1979 +#: documentation/content/en/books/handbook/config/_index.adoc:1978 msgid "More information about ACPI may be found in the following locations:" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1981 +#: documentation/content/en/books/handbook/config/_index.adoc:1980 msgid "" "The FreeBSD ACPI Mailing List Archives (https://lists.freebsd.org/pipermail/" "freebsd-acpi/[https://lists.freebsd.org/pipermail/freebsd-acpi/])" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1982 +#: documentation/content/en/books/handbook/config/_index.adoc:1981 msgid "" "The ACPI 2.0 Specification (http://acpi.info/spec.htm[http://acpi.info/spec." "htm])" msgstr "" #. type: Plain text -#: documentation/content/en/books/handbook/config/_index.adoc:1982 +#: documentation/content/en/books/handbook/config/_index.adoc:1981 msgid "" "man:acpi[4], man:acpi_thermal[4], man:acpidump[8], man:iasl[8], and man:" "acpidb[8]" |