diff --git a/share/man/man5/Makefile b/share/man/man5/Makefile index 15b6d62b7..a6fb01b63 100644 --- a/share/man/man5/Makefile +++ b/share/man/man5/Makefile @@ -5,24 +5,18 @@ # MINIX: MAN= \ - \ - \ - hosts.5 ifconfig.if.5 \ + ifconfig.if.5 \ locale.alias.5 \ \ \ \ - nsswitch.conf.5 \ - rc.conf.5 \ - resolv.conf.5 route.conf.5 \ + resolv.conf.5 \ \ \ - #MLINKS+=capfile.5 termcap.5 #MLINKS+=daily.5 daily.conf.5 #MLINKS+=fs.5 inode.5 -#MLINKS+=hosts.equiv.5 rhosts.5 #MLINKS+=monthly.5 monthly.conf.5 MLINKS+=resolv.conf.5 resolver.5 #MLINKS+=utmp.5 wtmp.5 utmp.5 lastlog.5 passwd.5 master.passwd.5 diff --git a/share/man/man5/hosts.5 b/share/man/man5/hosts.5 deleted file mode 100644 index 3e76ff418..000000000 --- a/share/man/man5/hosts.5 +++ /dev/null @@ -1,129 +0,0 @@ -.\" $NetBSD: hosts.5,v 1.13 2003/08/07 10:31:17 agc Exp $ -.\" -.\" Copyright (c) 1983, 1991, 1993 -.\" The Regents of the University of California. All rights reserved. -.\" -.\" Redistribution and use in source and binary forms, with or without -.\" modification, are permitted provided that the following conditions -.\" are met: -.\" 1. Redistributions of source code must retain the above copyright -.\" notice, this list of conditions and the following disclaimer. -.\" 2. Redistributions in binary form must reproduce the above copyright -.\" notice, this list of conditions and the following disclaimer in the -.\" documentation and/or other materials provided with the distribution. -.\" 3. Neither the name of the University nor the names of its contributors -.\" may be used to endorse or promote products derived from this software -.\" without specific prior written permission. -.\" -.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND -.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE -.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE -.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE -.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL -.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS -.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) -.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT -.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY -.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF -.\" SUCH DAMAGE. -.\" -.\" @(#)hosts.5 8.2 (Berkeley) 12/11/93 -.\" -.Dd November 17, 2000 -.Dt HOSTS 5 -.Os -.Sh NAME -.Nm hosts -.Nd host name data base -.Sh DESCRIPTION -The -.Nm hosts -file contains information regarding the known hosts on the network. -It can be used in conjunction with the DNS, and the -.Tn NIS -maps -.Sq hosts.byaddr , -and -.Sq hosts.byname , -as controlled by -.Xr nsswitch.conf 5 . -.Pp -For each host a single line should be present -with the following information: -.Dl address hostname [alias ...] -.Pp -These are: -.Bl -tag -width hostname -compact -offset indent -.It Em address -Internet address -.It Em hostname -Official host name -.It Em alias -Alias host name -.El -.Pp -Items are separated by any number of blanks and/or -tab characters. A hash sign -.Pq Dq \&# -indicates the beginning of -a comment; characters up to the end of the line are -not interpreted by routines which search the file. -.Pp -When using the name server -.Xr named 8 , -or -.Xr ypserv 8 , -this file provides a backup when the name server -is not running. -For the name server, it is suggested that only a few addresses -be included in this file. -These include address for the local interfaces that -.Xr ifconfig 8 -needs at boot time and a few machines on the local network. -.Pp -This file may be created from the official host -data base maintained at the Network Information Control -Center -.Pq Tn NIC , -though local changes may be required -to bring it up to date regarding unofficial aliases -and/or unknown hosts. As the data base maintained at -.Tn NIC -is incomplete, use of the name server is recommended for -sites on the -.Tn DARPA -Internet. -.Pp -As network addresses, both IPv4 and IPv6 addresses are allowed. -IPv4 addresses are specified in the conventional dot -.Pq Dq \&. -notation using the -.Xr inet_pton 3 -routine -from the Internet address manipulation library, -.Xr inet 3 . -IPv6 addresses are specified in the standard hex-and-colon notation. -Host names may contain any printable -character other than a field delimiter, newline, -or comment character. -.Sh FILES -.Bl -tag -width /etc/hosts -compact -.It Pa /etc/hosts -The -.Nm hosts -file resides in -.Pa /etc . -.El -.Sh SEE ALSO -.Xr gethostbyname 3 , -.Xr nsswitch.conf 5 , -.Xr ifconfig 8 , -.Xr named 8 -.Rs -.%T "Name Server Operations Guide for BIND" -.Re -.Sh HISTORY -The -.Nm -file format appeared in -.Bx 4.2 . diff --git a/share/man/man5/nsswitch.conf.5 b/share/man/man5/nsswitch.conf.5 deleted file mode 100644 index 00bb59f18..000000000 --- a/share/man/man5/nsswitch.conf.5 +++ /dev/null @@ -1,272 +0,0 @@ -.\" $NetBSD: nsswitch.conf.5,v 1.28 2009/10/25 01:30:48 wiz Exp $ -.\" -.\" Copyright (c) 1997, 1998, 1999 The NetBSD Foundation, Inc. -.\" All rights reserved. -.\" -.\" This code is derived from software contributed to The NetBSD Foundation -.\" by Luke Mewburn. -.\" -.\" Redistribution and use in source and binary forms, with or without -.\" modification, are permitted provided that the following conditions -.\" are met: -.\" 1. Redistributions of source code must retain the above copyright -.\" notice, this list of conditions and the following disclaimer. -.\" 2. Redistributions in binary form must reproduce the above copyright -.\" notice, this list of conditions and the following disclaimer in the -.\" documentation and/or other materials provided with the distribution. -.\" -.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS -.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED -.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR -.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS -.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR -.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF -.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS -.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN -.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) -.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE -.\" POSSIBILITY OF SUCH DAMAGE. -.\" -.Dd October 25, 2009 -.Dt NSSWITCH.CONF 5 -.Os -.Sh NAME -.Nm nsswitch.conf -.Nd name-service switch configuration file -.Sh DESCRIPTION -The -.Nm -file specifies how the -.Xr nsdispatch 3 -(name-service switch dispatcher) routines in the C library should operate. -.Pp -The configuration file controls how a process looks up various databases -containing information regarding hosts, users (passwords), groups, -netgroups, etc. -Each database comes from a source (such as local files, DNS, and -.Tn NIS ) , -and the order to look up the sources is specified in -.Nm nsswitch.conf . -.Pp -Each entry in -.Nm -consists of a database name, and a space separated list of sources. -Each source can have an optional trailing criterion that determines -whether the next listed source is used, or the search terminates at -the current source. -Each criterion consists of one or more status codes, and actions to -take if that status code occurs. -.Ss Sources -The following sources are implemented: -.Bl -column "multicast_dns" -offset indent -compact -.It Sy Source Description -.It files Local files, such as -.Pa /etc/hosts , -and -.Pa /etc/passwd . -.It dns Internet Domain Name System. -.Dq hosts -and -.Dq networks -use -.Sy IN -class entries, all other databases use -.Sy HS -class (Hesiod) entries. -.It mdnsd Use -.Xr mdnsd 8 -for -.Dq hosts -lookups, acting as both a system-wide cache for normal unicast DNS -as well as providing multicast DNS -.Dq ( zeroconf ) -lookups. -.It multicast_dns Use -.Xr mdnsd 8 -only for multicast DNS -.Dq hosts -lookups. -This would normally be used in conjunction with -.Dq dns , -which would then provide unicast DNS resolver functions. -.It nis NIS (formerly YP) -.It compat support -.Sq +/- -in the -.Dq passwd -and -.Dq group -databases. -If this is present, it must be the only source for that entry. -.El -.Ss Databases -The following databases are used by the following C library functions: -.Bl -column "netgroup" -offset indent -compact -.It Sy Database Used by -.It group Ta Xr getgrent 3 -.It hosts Ta Xr gethostbyname 3 -.It netgroup Ta Xr getnetgrent 3 -.It networks Ta Xr getnetbyname 3 -.It passwd Ta Xr getpwent 3 -.It shells Ta Xr getusershell 3 -.El -.Ss Status codes -The following status codes are available: -.Bl -column "tryagain" -offset indent -compact -.It Sy Status Description -.It success The requested entry was found. -.It notfound The entry is not present at this source. -.It tryagain The source is busy, and may respond to retries. -.It unavail The source is not responding, or entry is corrupt. -.El -.Ss Actions -For each of the status codes, one of two actions is possible: -.Bl -column "continue" -offset indent -compact -.It Sy Action Description -.It continue Try the next source -.It return Return with the current result -.El -.Ss Format of file -A -.Tn BNF -description of the syntax of -.Nm -is: -.Bl -column "\*[Lt]criterion\*[Gt]" -offset indent -.It \*[Lt]entry\*[Gt] ::= -\*[Lt]database\*[Gt] ":" [\*[Lt]source\*[Gt] [\*[Lt]criteria\*[Gt]]]* -.It \*[Lt]criteria\*[Gt] ::= -"[" \*[Lt]criterion\*[Gt]+ "]" -.It \*[Lt]criterion\*[Gt] ::= -\*[Lt]status\*[Gt] "=" \*[Lt]action\*[Gt] -.It \*[Lt]status\*[Gt] ::= -"success" | "notfound" | "unavail" | "tryagain" -.It \*[Lt]action\*[Gt] ::= -"return" | "continue" -.El -.Pp -Each entry starts on a new line in the file. -A -.Sq # -delimits a comment to end of line. -Blank lines are ignored. -A -.Sq \e -at the end of a line escapes the newline, and causes the next line to -be a continuation of the current line. -All entries are case-insensitive. -.Pp -The default criteria is to return on -.Dq success , -and continue on anything else (i.e, -.Li [success=return notfound=continue unavail=continue tryagain=continue] -). -.Ss Compat mode: +/- syntax -In historical multi-source implementations, the -.Sq + -and -.Sq - -characters are used to specify the importing of user password and -group information from -.Tn NIS . -Although -.Nm -provides alternative methods of accessing distributed sources such as -.Tn NIS , -specifying a sole source of -.Dq compat -will provide the historical behaviour. -.Pp -An alternative source for the information accessed via -.Sq +/- -can be used by specifying -.Dq passwd_compat: source . -.Dq source -in this case can be -.Sq dns , -.Sq nis , -or -any other source except for -.Sq files -and -.Sq compat . -.Ss Notes -Historically, many of the databases had enumeration functions, often of -the form -.Fn getXXXent . -These made sense when the databases were in local files, but don't make -sense or have lesser relevance when there are possibly multiple sources, -each of an unknown size. -The interfaces are still provided for compatibility, but the source -may not be able to provide complete entries, or duplicate entries may -be retrieved if multiple sources that contain similar information are -specified. -.Pp -To ensure compatibility with previous and current implementations, the -.Dq compat -source must appear alone for a given database. -.Ss Default source lists -If, for any reason, -.Nm nsswitch.conf -doesn't exist, or it has missing or corrupt entries, -.Xr nsdispatch 3 -will default to an entry of -.Dq files -for the requested database. -Exceptions are: -.Bl -column passwd_compat "files dns" -offset indent -.It Sy Database Default source list -.It group compat -.It group_compat nis -.It hosts files dns -.It netgroup files [notfound=return] nis -.It passwd compat -.It passwd_compat nis -.El -.Sh FILES -.Bl -tag -width /etc/nsswitch.conf -compact -.It Pa /etc/nsswitch.conf -The file -.Nm -resides in -.Pa /etc . -.El -.Sh EXAMPLES -To lookup hosts in -.Pa /etc/hosts -and then from the DNS, and lookup user information from -.Tn NIS -then files, use: -.Bl -column "passwd:" -offset indent -.It hosts: files dns -.It passwd: nis [notfound=return] files -.It group: nis [notfound=return] files -.El -.Pp -The criteria -.Dq [notfound=return] -sets a policy of "if the user is notfound in nis, don't try files." -This treats nis as the authoritative source of information, except -when the server is down. -.Sh SEE ALSO -.Xr getent 1 , -.Xr nsdispatch 3 , -.Xr resolv.conf 5 , -.Xr named 8 , -.Xr ypbind 8 -.Sh HISTORY -The -.Nm -file format first appeared in -.Nx 1.4 . -.Sh AUTHORS -.An Luke Mewburn -.Aq lukem@NetBSD.org -wrote this freely distributable name-service switch implementation, -using ideas from the -.Tn ULTRIX -.Xr svc.conf 5 -and -.Tn Solaris -.Xr nsswitch.conf 4 -manual pages. diff --git a/share/man/man5/rc.conf.5 b/share/man/man5/rc.conf.5 deleted file mode 100644 index 8c6e941c4..000000000 --- a/share/man/man5/rc.conf.5 +++ /dev/null @@ -1,1556 +0,0 @@ -.\" $NetBSD: rc.conf.5,v 1.162 2015/10/09 19:49:25 plunky Exp $ -.\" -.\" Copyright (c) 1996 Matthew R. Green -.\" All rights reserved. -.\" -.\" Redistribution and use in source and binary forms, with or without -.\" modification, are permitted provided that the following conditions -.\" are met: -.\" 1. Redistributions of source code must retain the above copyright -.\" notice, this list of conditions and the following disclaimer. -.\" 2. Redistributions in binary form must reproduce the above copyright -.\" notice, this list of conditions and the following disclaimer in the -.\" documentation and/or other materials provided with the distribution. -.\" -.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR -.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES -.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. -.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, -.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, -.\" BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; -.\" LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED -.\" AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, -.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY -.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF -.\" SUCH DAMAGE. -.\" -.\" Copyright (c) 1997 Curt J. Sampson -.\" Copyright (c) 1997 Michael W. Long -.\" Copyright (c) 1998-2010 The NetBSD Foundation, Inc. -.\" All rights reserved. -.\" -.\" This document is derived from works contributed to The NetBSD Foundation -.\" by Luke Mewburn. -.\" -.\" Redistribution and use in source and binary forms, with or without -.\" modification, are permitted provided that the following conditions -.\" are met: -.\" 1. Redistributions of source code must retain the above copyright -.\" notice, this list of conditions and the following disclaimer. -.\" 2. Redistributions in binary form must reproduce the above copyright -.\" notice, this list of conditions and the following disclaimer in the -.\" documentation and/or other materials provided with the distribution. -.\" 3. The name of the author may not be used to endorse or promote products -.\" derived from this software without specific prior written permission. -.\" -.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR -.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES -.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. -.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, -.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, -.\" BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; -.\" LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED -.\" AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, -.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY -.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF -.\" SUCH DAMAGE. -.\" -.Dd July 9, 2015 -.Dt RC.CONF 5 -.Os -.Sh NAME -.Nm rc.conf -.Nd system startup configuration file -.Sh DESCRIPTION -The -.Nm -file specifies which services are enabled during system startup by -the startup scripts invoked by -.Pa /etc/rc -(see -.Xr rc 8 ) , -and the shutdown scripts invoked by -.Pa /etc/rc.shutdown . -The -.Nm -file is a shell script that is sourced by -.Xr rc 8 , -meaning that -.Nm -must contain valid shell commands. -.Pp -Listed below are the standard -.Nm -variables that may be set, the values to which each may be set, -a brief description of what each variable does, and a reference to -relevant manual pages. -Third party packages may test for additional variables. -.Pp -By default, -.Nm -reads -.Pa /etc/defaults/rc.conf -(if it is readable) -to obtain default values for various variables, and the end-user -may override these by appending appropriate entries to the end of -.Nm . -.Pp -.Xr rc.d 8 -scripts that use -.Ic load_rc_config -from -.Xr rc.subr 8 -also support sourcing an optional end-user provided per-script override -file -.Pa /etc/rc.conf.d/ Ns Ar service , -(where -.Ar service -is the contents of the -.Sy name -variable in the -.Xr rc.d 8 -script). -This may contain variable overrides, including allowing the end-user -to override various -.Ic run_rc_command -.Xr rc.d 8 -control variables, and thus changing the operation of the script -without requiring editing of the script. -.Ss Variable naming conventions and data types -Most variables are one of two types: enabling variables or flags -variables. -Enabling variables, such as -.Sy inetd , -are generally named after the program or the system they enable, -and have boolean values (specified using -.Sq Ic YES , -.Sq Ic TRUE , -.Sq Ic ON -or -.Sq Ic 1 -for true, and -.Sq Ic NO , -.Sq Ic FALSE , -.Sq Ic OFF -or -.Sq Ic 0 -for false, with the values being case insensitive). -Flags variables, such as -.Sy inetd_flags -have the same name with "_flags" appended, and determine what -arguments are passed to the program if it is enabled. -.Pp -If a variable that -.Xr rc 8 -expects to be set is not set, or the value is not one of the allowed -values, a warning will be printed. -.Ss Overall control -.Bl -tag -width net_interfaces -.It Sy do_rcshutdown -Boolean value. -If false, -.Xr shutdown 8 -will not run -.Pa /etc/rc.shutdown . -.It Sy rcshutdown_rcorder_flags -A string. -Extra arguments to the -.Xr rcorder 8 -run by -.Pa /etc/rc.shutdown . -.It Sy rcshutdown_timeout -A number. -If non-blank, use this as the number of seconds to run a watchdog timer for -which will terminate -.Pa /etc/rc.shutdown -if the timer expires before the shutdown script completes. -.It Sy rc_configured -Boolean value. -If false then the system will drop into single-user mode during boot. -.It Sy rc_fast_and_loose -If set to a non-empty string, -each script in -.Pa /etc/rc.d -will be executed in the current shell rather than a sub shell. -This may be faster on slow machines that have an expensive -.Xr fork 2 -operation. -.Bl -hang -.It Em Note : -Use this at your own risk! -A rogue command or script may inadvertently prevent boot to multiuser. -.El -.It Sy rc_rcorder_flags -A string. -Extra arguments to the -.Xr rcorder 8 -run by -.Pa /etc/rc . -.It Sy rc_directories -A string. -Space separated list of directories searched for rc scripts. -The default is -.Pa /etc/rc.d . -All directories in -.Ev rc_directories -must be located in the root file system, otherwise they will be silently -skipped. -.It Sy rc_silent -Boolean value. -If true then the usual output is suppressed, and -.Xr rc 8 -invokes the command specified in the -.Va rc_silent_cmd -variable once for each line of suppressed output. -The default value of -.Va rc_silent -is set from the -.Dv AB_SILENT -flag in the kernel's -.Va boothowto -variable (see -.Xr boot 8 , -.Xr reboot 2 ) . -.It Sy rc_silent_cmd -A command to be executed once per line of suppressed output, when -.Va rc_silent -is true. -The default value of -.Va rc_silent_cmd -is -.Dq twiddle , -which will display a spinning symbol instead of each line of output. -Another useful value is -.Dq \&: , -which will display nothing at all. -.El -.Ss Basic network configuration -.Bl -tag -width net_interfaces -.It Sy defaultroute -A string. -Default IPv4 network route. -If empty or not set, then the contents of -.Pa /etc/mygate -(if it exists) are used. -.It Sy defaultroute6 -A string. -Default IPv6 network route. -If empty or not set, then the contents of -.Pa /etc/mygate6 -(if it exists) are used. -.It Sy domainname -A string. -.Tn NIS -(YP) domain of host. -If empty or not set, then the contents of -.Pa /etc/defaultdomain -(if it exists) are used. -.It Sy force_down_interfaces -A space separated list of interface names. -These interfaces will be configured down when going from multiuser to single-user -mode or on system shutdown. -.Pp -This is important for some stateful interfaces, for example PPP over ISDN -connections that cost money by connection time or PPPoE interfaces which -have no direct means of noticing -.Dq disconnect -events. -.Pp -All active -.Xr pppoe 4 -and -.Xr ippp 4 -interfaces will be automatically added to this list. -.It Sy hostname -A string. -Name of host. -If empty or not set, then the contents of -.Pa /etc/myname -(if it exists) are used. -.El -.Ss Boottime file-system and swap configuration -.Bl -tag -width net_interfaces -.It Sy critical_filesystems_local -A string. -File systems mounted very early in the system boot before networking -services are available. -Usually -.Pa /var -is part of this, because it is needed by services such as -.Xr dhclient 8 -which may be required to get the network operational. -The default is -.Dq "OPTIONAL:/var" , -where the -.Dq "OPTIONAL:" -prefix means that it's not an error if the file system is not -present in -.Xr fstab 5 . -.It Sy critical_filesystems_remote -A string. -File systems such as -.Pa /usr -that may require network services to be available to mount, -that must be available early in the system boot for general services to use. -The default is -.Dq "OPTIONAL:/usr" , -where the -.Dq "OPTIONAL:" -prefix means that it is not an error if the file system is not -present in -.Xr fstab 5 . -.It Sy fsck_flags -A string. -A file system is checked with -.Xr fsck 8 -during boot before mounting it. -This option may be used to override the default command-line options -passed to the -.Xr fsck 8 -program. -.Pp -When set to -.Fl y , -.Xr fsck 8 -assumes yes as the answer to all operator questions during file system checks. -This might be important with hosts where the administrator does not have -access to the console and an unsuccessful shutdown must not make the host -unbootable even if the file system checks would fail in preen mode. -.It Sy no_swap -Boolean value. -Should be true if you have deliberately configured your system with no swap. -If false and no swap devices are configured, the system will warn you. -.It Sy resize_root -Boolean value. -Set to true to have the system resize the root file system to fill its -partition. -Will only attempt to resize the root file system if it is of type ffs and does -not have logging enabled. -Defaults to false. -.It Sy swapoff -Boolean value. -Remove block-type swap devices at shutdown time. -Useful if swapping onto RAIDframe devices. -.El -.Ss Block device subsystems -.Bl -tag -width net_interfaces -.It Sy ccd -Boolean value. -Configures concatenated disk devices according to -.Xr ccd.conf 5 . -.It Sy cgd -Boolean value. -Configures cryptographic disk devices. -Requires -.Pa /etc/cgd/cgd.conf . -See -.Xr cgdconfig 8 -for additional details. -.It Sy lvm -Boolean value. -Configures the logical volume manager. -See -.Xr lvm 8 -for additional details. -.It Sy raidframe -Boolean value. -Configures -.Xr raid 4 , -RAIDframe disk devices. -See -.Xr raidctl 8 -for additional details. -.El -.Ss One-time actions to perform or programs to run on boot-up -.Bl -tag -width net_interfaces -.It Sy accounting -Boolean value. -Enables process accounting with -.Xr accton 8 . -Requires -.Pa /var/account/acct -to exist. -.It Sy clear_tmp -Boolean value. -Clear -.Pa /tmp -after reboot. -.It Sy dmesg -Boolean value. -Create -.Pa /var/run/dmesg.boot -from the output of -.Xr dmesg 8 . -Passes -.Sy dmesg_flags . -.It Sy envsys -Boolean value. -Sets preferences for the environmental systems framework, -.Xr envsys 4 . -Requires -.Pa /etc/envsys.conf , -which is described in -.Xr envsys.conf 5 . -.It Sy gpio -Boolean value. -Configure -.Xr gpio 4 -devices. -See -.Xr gpio.conf 5 . -.It Sy ldconfig -Boolean value. -Configures -.Xr a.out 5 -runtime link editor directory cache. -.It Sy mixerctl -Boolean value. -Read -.Xr mixerctl.conf 5 -for how to set mixer values. -List in -.Sy mixerctl_mixers -the devices whose settings are to be saved at shutdown and -restored at start-up. -.It Sy newsyslog -Boolean value. -Run -.Nm newsyslog -to trim log files before syslogd starts. -Intended for laptop users. -Passes -.Sy newsyslog_flags . -.It Sy per_user_tmp -Boolean value. -Enables a per-user -.Pa /tmp -directory. -.Sy per_user_tmp_dir -can be used to override the default location of the -.Dq real -temporary directories, -.Dq Pa /private/tmp . -See -.Xr security 7 -for additional details. -.It Sy quota -Boolean value. -Checks and enables quotas by running -.Xr quotacheck 8 -and -.Xr quotaon 8 . -.It Sy random_seed -Boolean value. -During boot-up, runs the -.Xr rndctl 8 -utility with the -.Fl L -flag to seed the random number subsystem from an entropy file. -During shutdown, runs the -.Xr rndctl 8 -utility with the -.Fl S -flag to save some random information to the entropy file. -The entropy file name is specified by the -.Sy random_file -variable, and defaults to -.Pa /var/db/entropy-file . -The entropy file must be on a local file system that is writable early during -boot-up (just after the file systems specified in -.Sy critical_filesystems_local -have been mounted), and correspondingly late during shutdown. -.It Sy rndctl -Boolean value. -Runs the -.Xr rndctl 8 -utility one or more times according to the specification in -.Sy rndctl_flags . -.Pp -If -.Sy rndctl_flags -does not contain a semicolon -.Pq Ql \&; -then it is expected to contain zero or more flags, -followed by one or more device or type names. -The -.Xr rndctl 8 -command will be executed once for each device or type name. -If the specified flags do not include any of -.Fl c , C , e , -or -.Fl E , -then the flags -.Fl c -and -.Fl e -are added, to specify that entropy from the relevant device or type -should be both collected and estimated. -If the specified flags do not include either of -.Fl d -or -.Fl t , -then the flag -.Fl d -is added, to specify that the non-flag arguments are device names, -not type names. -.Pp -.Sy rndctl_flags -may contain multiple semicolon-separated segments, in which each -segment contains flags and device or type names as described above. -This allows different flags to be associated with different -device or type names. -For example, given -.Li rndctl_flags="wd0 wd1; -t tty; -c -t net" , -the following commands will be executed: -.Li "rndctl -c -e -d wd0" ; -.Li "rndctl -c -e -d wd1" ; -.Li "rndctl -c -e -t tty" ; -.Li "rndctl -c -t net" . -.It Sy rtclocaltime -Boolean value. -Sets the real time clock to local time by adjusting the -.Xr sysctl 7 -value of -.Pa kern.rtc_offset . -The offset from UTC is calculated automatically according -to the time zone information in the file -.Pa /etc/localtime . -.It Sy savecore -Boolean value. -Runs the -.Xr savecore 8 -utility. -Passes -.Sy savecore_flags . -The directory where crash dumps are stored is specified by -.Sy savecore_dir . -The default setting is -.Dq Pa /var/crash . -.It Sy sysdb -Boolean value. -Builds various system databases, including -.Pa /var/run/dev.cdb , -.Pa /etc/spwd.db , -.Pa /var/db/netgroup.db , -.Pa /var/db/services.cdb , -and entries for -.Xr utmp 5 . -.It Sy tpctl -Boolean value. -Run -.Xr tpctl 8 -to calibrate touch panel device. -Passes -.Sy tpctl_flags . -.It Sy update_motd -Boolean value. -Updates the -.Nx -version string in the -.Pa /etc/motd -file to reflect the version of the running kernel. -See -.Xr motd 5 . -.It Sy virecover -Boolean value. -Send notification mail to users if any recoverable files exist in -.Pa /var/tmp/vi.recover . -Read -.Xr virecover 8 -for more information. -.It Sy wdogctl -Boolean value. -Configures watchdog timers. -Passes -.Sy wdogctl_flags . -Refer to -.Xr wdogctl 8 -for information on how to configure a timer. -.El -.Ss System security settings -.Bl -tag -width net_interfaces -.It Sy securelevel -A number. -The system securelevel is set to the specified value early -in the boot process, before any external logins, or other programs -that run users job, are started. -If set to nothing, the default action is taken, as described in -.Xr init 8 -and -.Xr secmodel_securelevel 9 , -which contains definitive information about the system securelevel. -Note that setting -.Sy securelevel -to 0 in -.Nm -will actually result in the system booting with securelevel set to 1, as -.Xr init 8 -will raise the level when -.Xr rc 8 -completes. -.It Sy permit_nonalpha -Boolean value. -Allow passwords to include non-alpha characters, usually to allow -NIS/YP netgroups. -.It Sy veriexec -Boolean value. -Load Veriexec fingerprints during startup. -Read -.Xr veriexecctl 8 -for more information. -.It Sy veriexec_strict -A number. -Controls the strict level of Veriexec. -Level 0 is learning mode, used when building the signatures file. -It will only output messages but will not enforce anything. -Level 1 will only prevent access to files with a fingerprint -mismatch. -Level 2 will also deny writing to and removing of -monitored files, as well as enforce access type (as specified in -the signatures file). -Level 3 will take a step further and prevent -access to files that are not monitored. -.It Sy veriexec_verbose -A number. -Controls the verbosity of Veriexec. -Recommended operation is at level 0, verbose output (mostly used when -building the signatures file) is at level 1. -Level 2 is for debugging only and should not be used. -.It Sy veriexec_flags -A string. -Flags to pass to the -.Nm veriexecctl -command. -.El -.Ss Networking startup -.Bl -tag -width net_interfaces -.It Sy altqd -Boolean value. -ALTQ configuration/monitoring daemon. -Passes -.Sy altqd_flags . -.It Sy auto_ifconfig -Boolean value. -Sets the -.Sy net_interfaces -variable (see below) to the output of -.Xr ifconfig 8 -with the -.Dq Li -l -flag and suppresses warnings about interfaces in this list that -do not have an ifconfig file or variable. -.It Sy dhclient -Boolean value. -Set true to configure some or all network interfaces using -the ISC DHCP client. -If you set -.Sy dhclient -true, then -.Pa /var -must be in -.Sy critical_filesystems_local , -or -.Pa /var -must be on the root file system, -or you must modify the -.Sy dhclient_flags -variable to direct the DHCP client to store the leases file -in some other directory on the root file system. -You must not provide ifconfig information or ifaliases -information for any interface that is to be configured using the DHCP client. -Interface aliases can be set up in the DHCP client configuration -file if needed - see -.Xr dhclient.conf 5 -for details. -.Pp -Passes -.Sy dhclient_flags -to the DHCP client. -See -.Xr dhclient 8 -for complete documentation. -If you wish to configure all broadcast -network interfaces using the DHCP client, you can leave this blank. -To configure only specific interfaces, name the interfaces to be configured -on the command line. -.Pp -If you must run the DHCP client before mounting critical file systems, -then you should specify an alternate location for the DHCP client's lease -file in the -.Sy dhclient_flags -variable - for example, "-lf /tmp/dhclient.leases". -.It Sy dhcpcd -Boolean value. -Set true to configure some or all network interfaces using dhcpcd. -If you set -.Sy dhcpcd -true, then -.Pa /var -must be in -.Sy critical_filesystems_local , -or -.Pa /var -must be on the root file system. -If you need to restrict dhcpcd to one or a number of interfaces, -or need a separate configuration per interface, -then this should be done in the configuration file - see -.Xr dhcpcd.conf 5 -for details. -dhcpcd presently ignores the -.Sy wpa_supplicant -variable in rc.conf and will start wpa_supplicant if a suitable -wpa_supplicant.conf is found unless otherwise instructed in -.Xr dhcpcd.conf 5 . -.It Sy dhcpcd_flags -Passes -.Sy dhcpcd_flags -to dhcpcd. -See -.Xr dhcpcd 8 -for complete documentation. -.It Sy flushroutes -Boolean value. -Flushes the route table on networking startup. -Useful when coming up to multiuser mode after going down to -single-user mode. -.It Sy ftp_proxy -Boolean value. -Runs -.Xr ftp-proxy 8 , -the proxy daemon for the Internet File Transfer Protocol. -.It Sy hostapd -Boolean value. -Runs -.Xr hostapd 8 , -the authenticator for IEEE 802.11 networks. -.It Sy ifaliases_* -A string. -List of -.Sq Em "address netmask" -pairs to configure additional network addresses for the given -configured interface -.Dq * -(e.g. -.Sy ifaliases_le0 ) . -If -.Em netmask -is -.Dq - , -then use the default netmask for the interface. -.Pp -.Sy ifaliases_* -covers limited cases only and is considered unrecommended. -We recommend using -.Sy ifconfig_nnX -variables or -.Pa /etc/ifconfig.xxN -files with multiple lines instead. -.It Sy ifwatchd -Boolean value. -Monitor dynamic interfaces and perform actions upon address changes. -Passes -.Sy ifwatchd_flags . -.It Sy ip6mode -A string. -An IPv6 node can be a router -.Pq nodes that forward packet for others -or a host -.Pq nodes that do not forward . -A host can be autoconfigured -based on the information advertised by adjacent IPv6 routers. -By setting -.Sy ip6mode -to -.Dq Li router , -.Dq Li host , -or -.Dq Li autohost , -you can configure your node as a router, -a non-autoconfigured host, or an autoconfigured host. -Invalid values will be ignored, and the node will be configured as -a non-autoconfigured host. -You may want to check -.Sy rtsol -and -.Sy rtsold -as well, if you set the variable to -.Dq Li autohost . -.It Sy ip6uniquelocal -Boolean value. -If -.Sy ip6mode -is equal to -.Dq Li router , -and -.Sy ip6uniquelocal -is false, -a reject route will be installed on boot to avoid misconfiguration relating -to unique-local addresses. -If -.Sy ip6uniquelocal -is true, the reject route won't be installed. -.It Sy ipfilter -Boolean value. -Runs -.Xr ipf 8 -to load in packet filter specifications from -.Pa /etc/ipf.conf -at network boot time, before any interfaces are configured. -Passes -.Sy ipfilter_flags . -See -.Xr ipf.conf 5 . -.It Sy ipfs -Boolean value. -Runs -.Xr ipfs 8 -to save and restore information for ipnat and ipfilter state tables. -The information is stored in -.Pa /var/db/ipf/ipstate.ipf -and -.Pa /var/db/ipf/ipnat.ipf . -Passes -.Sy ipfs_flags . -.It Sy ipmon -Boolean value. -Runs -.Xr ipmon 8 -to read -.Xr ipf 8 -packet log information and log it to a file or the system log. -Passes -.Sy ipmon_flags . -.It Sy ipmon_flags -A string. -Specifies arguments to supply to -.Xr ipmon 8 . -Defaults to -.Dq Li -ns . -A typical example would be -.Dq Fl nD Pa /var/log/ipflog -to have -.Xr ipmon 8 -log directly to a file bypassing -.Xr syslogd 8 . -If the -.Dq -D -argument is used, remember to modify -.Pa /etc/newsyslog.conf -accordingly; for example: -.Bd -literal -/var/log/ipflog 640 10 100 * Z /var/run/ipmon.pid -.Ed -.It Sy ipnat -Boolean value. -Runs -.Xr ipnat 8 -to load in the IP network address translation (NAT) rules from -.Pa /etc/ipnat.conf -at network boot time, before any interfaces are configured. -See -.Xr ipnat.conf 5 . -.It Sy ipsec -Boolean value. -Runs -.Xr setkey 8 -to load in IPsec manual keys and policies from -.Pa /etc/ipsec.conf -at network boot time, before any interfaces are configured. -.It Sy net_interfaces -A string. -The list of network interfaces to be configured at boot time. -For each interface "xxN", the system first looks for ifconfig -parameters in the variable -.Sy ifconfig_xxN , -and then in the file -.Pa /etc/ifconfig.xxN . -If -.Sy auto_ifconfig -is false, and neither the variable nor the file is found, -a warning is printed. -Information in either the variable or the file is parsed identically, -except that, if an -.Sy ifconfig_xxN -variable contains a single line with embedded semicolons, -then the value is split into multiple lines prior to further parsing, -treating the semicolon as a line separator. -.Pp -One common case it to set the -.Sy ifconfig_xxN -variable to a set of arguments to be passed to an -.Xr ifconfig 8 -command after the interface name. -Refer to -.Xr ifconfig.if 5 -for more details on -.Pa /etc/ifconfig.xxN -files, and note that the information there also applies to -.Sy ifconfig_xxN -variables (after the variables are split into lines). -.It Sy ntpdate -Boolean value. -Runs -.Xr ntpdate 8 -to set the system time from one of the hosts in -.Sy ntpdate_hosts . -If -.Sy ntpdate_hosts -is empty, it will attempt to find a list of hosts in -.Pa /etc/ntp.conf . -Passes -.Sy ntpdate_flags . -.It Sy pf -Boolean value. -Enable -.Xr pf 4 -at network boot time: -Load the initial configuration -.Xr pf.boot.conf 5 -before the network is up. -After the network has been configured, then load the final rule set -.Xr pf.conf 5 . -.It Sy pf_rules -A string. -The path of the -.Xr pf.conf 5 -rule set that will be used when loading the final rule set. -.It Sy pflogd -Boolean value. -Run -.Xr pflogd 8 -for dumping packet filter logging information to a file. -.It Sy ppp -A boolean. -Toggles starting -.Xr pppd 8 -on startup. -See -.Sy ppp_peers -below. -.It Sy ppp_peers -A string. -If -.Sy ppp -is true and -.Sy ppp_peers -is not empty, then -.Pa /etc/rc.d/ppp -will check each word in -.Sy ppp_peers -for a corresponding ppp configuration file in -.Pa /etc/ppp/peers -and will call -.Xr pppd 8 -with the -.Dq call Sy peer -option. -.It Sy racoon -Boolean value. -Runs -.Xr racoon 8 , -the IKE (ISAKMP/Oakley) key management daemon. -.It Sy rtsol -Boolean value. -Run -.Xr rtsol 8 , -router solicitation command for IPv6 hosts. -On nomadic hosts like notebook computers, you may want to enable -.Sy rtsold -as well. -Passes -.Sy rtsol_flags . -This is only for autoconfigured IPv6 hosts, so set -.Sy ip6mode -to -.Dq Li autohost -if you use it. -.It Sy wpa_supplicant -Boolean value. -Run -.Xr wpa_supplicant 8 , -WPA/802.11i Supplicant for wireless network devices. -If you set -.Sy wpa_supplicant -true, then -.Pa /usr -must be in -.Sy critical_filesystems_local , -or -.Pa /usr -must be on the root file system. -dhcpcd ignores this variable, see the -.Sy dhcpcd -variable for details. -.El -.Ss Daemons required by other daemons -.Bl -tag -width net_interfaces -.It Sy inetd -Boolean value. -Runs the -.Xr inetd 8 -daemon to start network server processes (as listed in -.Pa /etc/inetd.conf ) -as necessary. -Passes -.Sy inetd_flags . -The -.Dq Li -l -flag turns on libwrap connection logging. -.It Sy rpcbind -Boolean value. -The -.Xr rpcbind 8 -daemon is required for any -.Xr rpc 3 -services. -These include NFS, -.Tn NIS , -.Xr rpc.bootparamd 8 , -.Xr rpc.rstatd 8 , -.Xr rpc.rusersd 8 , -and -.Xr rpc.rwalld 8 . -Passes -.Sy rpcbind_flags . -.El -.Ss Commonly used daemons -.Bl -tag -width net_interfaces -.It Sy cron -Boolean value. -Run -.Xr cron 8 . -.It Sy ftpd -Boolean value. -Runs the -.Xr ftpd 8 -daemon and passes -.Sy ftpd_flags . -.It Sy httpd -Boolean value. -Runs the -.Xr httpd 8 -daemon and passes -.Sy httpd_flags . -.It Sy httpd_wwwdir -A string. -The -.Xr httpd 8 -WWW root directory. -Used only if -.Sy httpd -is true. -The default setting is -.Dq Pa /var/www . -.It Sy httpd_wwwuser -A string. -If non-blank and -.Sy httpd -is true, run -.Xr httpd 8 -and cause it to switch to the specified user after initialization. -It is preferred to -.Sy httpd_user -because -.Xr httpd 8 -is requiring extra privileges to start listening on default port 80. -The default setting is -.Dq Dv _httpd . -.It Sy lpd -Boolean value. -Runs -.Xr lpd 8 -and passes -.Sy lpd_flags . -The -.Dq Li -l -flag will turn on extra logging. -.It Sy mdnsd -Boolean value. -Runs -.Xr mdnsd 8 . -.It Sy named -Boolean value. -Runs -.Xr named 8 -and passes -.Sy named_flags . -.It Sy named_chrootdir -A string. -If non-blank and -.Sy named -is true, run -.Xr named 8 -as the unprivileged user and group -.Sq named , -.Xr chroot 2 Ns ed -to -.Sy named_chrootdir . -.Sy named_chrootdir Ns Pa /var/run/log -will be added to the list of log sockets that -.Xr syslogd 8 -listens to. -.It Sy ntpd -Boolean value. -Runs -.Xr ntpd 8 -and passes -.Sy ntpd_flags . -.It Sy ntpd_chrootdir -A string. -If non-blank and -.Sy ntpd -is true, run -.Xr ntpd 8 -as the unprivileged user and group -.Sq ntpd , -.Xr chroot 2 Ns ed -to -.Sy ntpd_chrootdir . -.Sy ntpd_chrootdir Ns Pa /var/run/log -will be added to the list of log sockets that -.Xr syslogd 8 -listens to. -This option requires that the kernel has -.Dl pseudo-device clockctl -compiled in, and that -.Pa /dev/clockctl -is present. -.It Sy postfix -Boolean value. -Starts -.Xr postfix 1 -mail system. -.It Sy sshd -Boolean value. -Runs -.Xr sshd 8 -and passes -.Sy sshd_flags . -.It Sy syslogd -Boolean value. -Runs -.Xr syslogd 8 -and passes -.Sy syslogd_flags . -.It Sy timed -Boolean value. -Runs -.Xr timed 8 -and passes -.Sy timed_flags . -The -.Dq Li -M -option allows -.Xr timed 8 -to be a master time source as well as a slave. -If you are also running -.Xr ntpd 8 , -only one machine running both should have the -.Dq Li -M -flag given to -.Xr timed 8 . -.El -.Ss Routing daemons -.Bl -tag -width net_interfaces -.It Sy mrouted -Boolean value. -Runs -.Xr mrouted 8 , -the DVMRP multicast routing protocol daemon. -Passes -.Sy mrouted_flags . -.It Sy route6d -Boolean value. -Runs -.Xr route6d 8 , -the RIPng routing protocol daemon for IPv6. -Passes -.Sy route6d_flags . -.It Sy routed -Boolean value. -Runs -.Xr routed 8 , -the RIP routing protocol daemon. -Passes -.Sy routed_flags . -.\" This should be false -.\" if -.\" .Sy gated -.\" is true. -.It Sy rtsold -Boolean value. -Runs -.Xr rtsold 8 , -the IPv6 router solicitation daemon. -.Xr rtsold 8 -periodically transmits router solicitation packets -to find IPv6 routers on the network. -This configuration is mainly for nomadic hosts like notebook computers. -Stationary hosts should work fine with just -.Sy rtsol . -Passes -.Sy rtsold_flags . -This is only for autoconfigured IPv6 hosts, so set -.Sy ip6mode -to -.Dq Li autohost -if you use it. -.El -.Ss Daemons used to boot other hosts over a network -.Bl -tag -width net_interfaces -.It Sy bootparamd -Boolean value. -Runs -.Xr bootparamd 8 , -the boot parameter server, with -.Sy bootparamd_flags -as options. -Used to boot -.Nx -and -.Tn "SunOS 4.x" -systems. -.It Sy dhcpd -Boolean value. -Runs -.Xr dhcpd 8 , -the Dynamic Host Configuration Protocol (DHCP) daemon, -for assigning IP addresses to hosts and passing boot information. -Passes -.Sy dhcpd_flags . -.It Sy dhcrelay -Boolean value. -Runs -.Xr dhcrelay 8 . -Passes -.Sy dhcrelay_flags . -.It Sy mopd -Boolean value. -Runs -.Xr mopd 8 , -the -.Tn DEC -.Tn MOP -protocol daemon; used for booting -.Tn VAX -and other -.Tn DEC -machines. -Passes -.Sy mopd_flags . -.It Sy ndbootd -Boolean value. -Runs -.Xr ndbootd 8 , -the Sun Network Disk (ND) Protocol server. -Passes -.Sy ndbootd_flags . -.It Sy rarpd -Boolean value. -Runs -.Xr rarpd 8 , -the reverse ARP daemon, often used to boot -.Nx -and Sun workstations. -Passes -.Sy rarpd_flags . -.It Sy rbootd -Boolean value. -Runs -.Xr rbootd 8 , -the -.Tn HP -boot protocol daemon; used for booting -.Tn HP -workstations. -Passes -.Sy rbootd_flags . -.It Sy rtadvd -Boolean value. -Runs -.Xr rtadvd 8 , -the IPv6 router advertisement daemon, which is used to advertise -information about the subnet to IPv6 end hosts. -Passes -.Sy rtadvd_flags . -This is only for IPv6 routers, so set -.Sy ip6mode -to -.Dq Li router -if you use it. -.El -.Ss X Window System daemons -.Bl -tag -width net_interfaces -.It Sy xdm -Boolean value. -Runs the -.Xr xdm 1 -X display manager. -These X daemons are available only with the optional X distribution of -.Nx . -.It Sy xfs -Boolean value. -Runs the -.Xr xfs 1 -X11 font server, which supplies local X font files to X terminals. -.El -.Ss NIS (YP) daemons -.Bl -tag -width net_interfaces -.It Sy ypbind -Boolean value. -Runs -.Xr ypbind 8 , -which lets -.Tn NIS -(YP) clients use information from a -.Tn NIS -server. -Passes -.Sy ypbind_flags . -.It Sy yppasswdd -Boolean value. -Runs -.Xr yppasswdd 8 , -which allows remote -.Tn NIS -users to update password on master server. -Passes -.Sy yppasswdd_flags . -.It Sy ypserv -Boolean value. -Runs -.Xr ypserv 8 , -the -.Tn NIS -(YP) server for distributing information from certain files in -.Pa /etc . -Passes -.Sy ypserv_flags . -The -.Dq Li -d -flag causes it to use DNS for lookups in -.Pa /etc/hosts -that fail. -.El -.Ss NFS daemons and parameters -.Bl -tag -width net_interfaces -.It Sy amd -Boolean value. -Runs -.Xr amd 8 , -the automounter daemon, which automatically mounts NFS file systems -whenever a file or directory within that file system is accessed. -Passes -.Sy amd_flags . -.It Sy amd_dir -A string. -The -.Xr amd 8 -mount directory. -Used only if -.Sy amd -is true. -.It Sy lockd -Boolean value. -Runs -.Xr rpc.lockd 8 -if -.Sy nfs_server -and/or -.Sy nfs_client -are true. -Passes -.Sy lockd_flags . -.It Sy mountd -Boolean value. -Runs -.Xr mountd 8 -and passes -.Sy mountd_flags . -.It Sy nfs_client -Boolean value. -The number of local NFS asynchronous I/O server is now controlled via -.Xr sysctl 8 . -.It Sy nfs_server -Boolean value. -Sets up a host to be a NFS server by running -.Xr nfsd 8 -and passing -.Sy nfsd_flags . -.It Sy statd -Boolean value. -Runs -.Xr rpc.statd 8 , -a status monitoring daemon used when -.Xr rpc.lockd 8 -is running, if -.Sy nfs_server -and/or -.Sy nfs_client -are true. -Passes -.Sy statd_flags . -.El -.Ss Bluetooth support -.Bl -tag -width net_interfaces -.It Sy bluetooth -Boolean value. -Configure Bluetooth support, comprising the following tasks: -.Bl -dash -compact -.It -attach serial Bluetooth controllers as listed in the -.Pa /etc/bluetooth/btattach.conf -configuration file. -.It -enable Bluetooth controllers with useful defaults, plus -additional options as detailed below. -.It -optionally, start -.Xr bthcid 8 , -the Bluetooth Link Key/PIN Code manager, passing -.Sy bthcid_flags . -.It -configure local Bluetooth drivers as listed in the -.Pa /etc/bluetooth/btdevctl.conf -configuration file. -.It -optionally, start -.Xr sdpd 8 , -the Service Discovery server, passing -.Sy sdpd_flags . -.El -.It Sy btconfig_devices -A string. -An optional list of Bluetooth controllers to configure. -.It Sy btconfig_{dev} -A string. -Additional configuration options for specific Bluetooth controllers. -.It Sy btconfig_args -A string. -Additional configuration options for Bluetooth controllers without -specific options as above. -.It Sy bthcid -Boolean value. -If set to false, disable starting the Bluetooth Link Key/PIN Code manager. -.It Sy sdpd -Boolean value. -If set to false, disable starting the Bluetooth Service Discovery server. -.El -.Ss Other daemons -.Bl -tag -width net_interfaces -.It Sy identd -Boolean value. -Runs -.Xr identd 8 , -the daemon for the user identification protocol. -Passes -.Sy identd_flags . -.It Sy iscsi_target -Boolean value. -Runs the server for iSCSI requests, -.Xr iscsi-target 8 . -Passes -.Sy iscsi_target_flags . -.It Sy isdnd -Boolean value. -Runs -.Xr isdnd 8 , -the isdn4bsd ISDN connection management daemon. -Passes -.Sy isdnd_flags . -.It Sy isdn_autoupdown -Boolean value. -Set all configured ISDN interfaces to -.Dq up . -If -.Sy isdn_interfaces -is not blank, only the listed interfaces will be modified. -Used only if -.Sy isdnd -is true. -.It Sy kdc -Boolean value. -Runs the -.Xr kdc 8 -Kerberos v4 and v5 server. -This should be run on Kerberos master and slave servers. -.It Sy rwhod -Boolean value. -Runs -.Xr rwhod 8 -to support the -.Xr rwho 1 -and -.Xr ruptime 1 -commands. -.El -.Ss Hardware daemons -.Bl -tag -width net_interfaces -.It Sy apmd -Boolean value. -Runs -.Xr apmd 8 -and passes -.Sy apmd_flags . -.It Sy irdaattach -Boolean value. -Runs -.Xr irdaattach 8 -and passes -.Sy irdaattach_flags . -.It Sy moused -Boolean value. -Runs -.Xr moused 8 , -to pass serial mouse data to the wscons mouse mux. -Passes -.Sy moused_flags . -.It Sy screenblank -Boolean value. -Runs -.Xr screenblank 1 -and passes -.Sy screenblank_flags . -.It Sy wscons -Boolean value. -Configures the -.Xr wscons 4 -console driver, from the configuration file -.Pa /etc/wscons.conf . -.It Sy wsmoused -Boolean value. -Runs -.Xr wsmoused 8 , -to provide copy and paste text support in wscons displays. -Passes -.Sy wsmoused_flags . -.El -.Sh FILES -.Bl -tag -width /etc/defaults/rc.conf -compact -.It Pa /etc/rc.conf -The file -.Nm -resides in -.Pa /etc . -.It Pa /etc/defaults/rc.conf -Default settings for -.Nm , -sourced by -.Nm -before the end-user configuration section. -.It Pa /etc/rc.conf.d/ Ns Ar foo -.Ar foo Ns No -specific -.Nm -overrides. -.El -.Sh SEE ALSO -.Xr boot 8 , -.Xr rc 8 , -.Xr rc.d 8 , -.Xr rc.subr 8 , -.Xr rcorder 8 -.Sh HISTORY -The -.Nm -file appeared in -.Nx 1.3 . diff --git a/share/man/man5/route.conf.5 b/share/man/man5/route.conf.5 deleted file mode 100644 index b48884f2d..000000000 --- a/share/man/man5/route.conf.5 +++ /dev/null @@ -1,96 +0,0 @@ -.\" $NetBSD: route.conf.5,v 1.5 2012/05/02 22:38:31 wiz Exp $ -.\" -.\" Copyright (c) 2004 Thomas Klausner -.\" All rights reserved. -.\" -.\" Redistribution and use in source and binary forms, with or without -.\" modification, are permitted provided that the following conditions -.\" are met: -.\" 1. Redistributions of source code must retain the above copyright -.\" notice, this list of conditions and the following disclaimer. -.\" 2. Redistributions in binary form must reproduce the above copyright -.\" notice, this list of conditions and the following disclaimer in the -.\" documentation and/or other materials provided with the distribution. -.\" -.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR -.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES -.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. -.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, -.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT -.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, -.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY -.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT -.\" INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF -.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. -.\" -.Dd May 1, 2012 -.Dt ROUTE.CONF 5 -.Os -.Sh NAME -.Nm route.conf -.Nd static routes config file -.Sh DESCRIPTION -The -.Nm -file is read by the -.Pa staticroute -rc.d script during system start-up and shutdown, -and is intended for adding and removing static routes. -.Ss FILE FORMAT -Lines starting with a hash -.Pq Sq # -are comments and ignored. -Lines starting with a plus sign -.Pq Sq + -are run during start-up, -while lines starting with a minus sign -.Pq Sq \- -are run during system shutdown. -If a line starts with a -.Sq \&! , -the rest of the line will get evaluated as a shell script fragment. -All other lines are passed to -.Xr route 8 . -During start-up, they are passed behind a -.Dq Ic route add \- -command and during shutdown behind a -.Dq Ic route delete \- -command. -.Sh FILES -.Bl -tag -width XXetcXrouteXconfXX -.It Pa /etc/route.conf -The -.Nm -file resides in -.Pa /etc . -.It Pa /etc/rc.d/staticroute -.Xr rc.d 8 -script that parses -.Nm . -.El -.Sh EXAMPLES -In this example, the interface for the desired routing changes is set, -the IP address on that interface is determined, and a route is added -during startup, or deleted during system shutdown. -.Bd -literal -offset indent -# Set interface and determine current IP address for added route. -!ifname=bnx0 -!ipaddr=$(/sbin/ifconfig ${ifname} | awk '$1 == "inet" {print $2}') -net 10.10.1 -interface ${ipaddr} -.Ed -.Pp -In this example, -IP forwarding is turned on during -start-up, and a static route added for 192.168.2.0. -During system shutdown, the route is removed -and IP forwarding turned off. -.Bd -literal -offset indent -# Turn on/off IP forwarding. -+sysctl -w net.inet.ip.forwarding=1 --sysctl -w net.inet.ip.forwarding=0 -net 192.168.2.0 -netmask 255.255.255.0 192.168.150.2 -.Ed -.Sh SEE ALSO -.Xr rc.conf 5 , -.Xr rc 8 , -.Xr route 8 diff --git a/share/man/man7/Makefile b/share/man/man7/Makefile index eb96f7023..abe6feb38 100644 --- a/share/man/man7/Makefile +++ b/share/man/man7/Makefile @@ -4,13 +4,7 @@ .include # missing: eqnchar.7 man.7 ms.7 term.7 - -# MINIX: -MAN= \ - nls.7 \ - \ - - +MAN= .if !defined(__MINIX) CLEANFILES= tests.7 .if ${MKKYUA} != "no" diff --git a/share/man/man7/nls.7 b/share/man/man7/nls.7 deleted file mode 100644 index 7e57562c9..000000000 --- a/share/man/man7/nls.7 +++ /dev/null @@ -1,518 +0,0 @@ -.\" $NetBSD: nls.7,v 1.15 2009/04/09 02:51:54 joerg Exp $ -.\" -.\" Copyright (c) 2003 The NetBSD Foundation, Inc. -.\" All rights reserved. -.\" -.\" This code is derived from software contributed to The NetBSD Foundation -.\" by Gregory McGarry. -.\" -.\" Redistribution and use in source and binary forms, with or without -.\" modification, are permitted provided that the following conditions -.\" are met: -.\" 1. Redistributions of source code must retain the above copyright -.\" notice, this list of conditions and the following disclaimer. -.\" 2. Redistributions in binary form must reproduce the above copyright -.\" notice, this list of conditions and the following disclaimer in the -.\" documentation and/or other materials provided with the distribution. -.\" -.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS -.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED -.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR -.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS -.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR -.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF -.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS -.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN -.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) -.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE -.\" POSSIBILITY OF SUCH DAMAGE. -.\" -.Dd February 21, 2007 -.Dt NLS 7 -.Os -.Sh NAME -.Nm NLS -.Nd Native Language Support Overview -.Sh DESCRIPTION -Native Language Support (NLS) provides commands for a single -worldwide operating system base. -An internationalized system has no built-in assumptions or dependencies -on language-specific or cultural-specific conventions such as: -.Pp -.Bl -bullet -offset indent -compact -.It -Character classifications -.It -Character comparison rules -.It -Character collation order -.It -Numeric and monetary formatting -.It -Date and time formatting -.It -Message-text language -.It -Character sets -.El -.Pp -All information pertaining to cultural conventions and language is -obtained at program run time. -.Pp -.Dq Internationalization -(often abbreviated -.Dq i18n ) -refers to the operation by which system software is developed to support -multiple cultural-specific and language-specific conventions. -This is a generalization process by which the system is untied from -calling only English strings or other English-specific conventions. -.Dq Localization -(often abbreviated -.Dq l10n ) -refers to the operations by which the user environment is customized to -handle its input and output appropriate for specific language and cultural -conventions. -This is a specialization process, by which generic methods already -implemented in an internationalized system are used in specific ways. -The formal description of cultural conventions for some country, together -with all associated translations targeted to the native language, is -called the -.Dq locale . -.Pp -.Nx -provides extensive support to programmers and system developers to -enable internationalized software to be developed. -.Nx -also supplies a large variety of locales for system localization. -.Ss Localization of Information -All locale information is accessible to programs at run time so that -data is processed and displayed correctly for specific cultural -conventions and language. -.Pp -A locale is divided into categories. -A category is a group of language-specific and culture-specific conventions -as outlined in the list above. -ISO C specifies the following six standard categories supported by -.Nx : -.Pp -.Bl -tag -compact -width LC_MONETARYXX -.It Ev LC_COLLATE -string-collation order information -.It Ev LC_CTYPE -character classification, case conversion, and other character attributes -.It Ev LC_MESSAGES -the format for affirmative and negative responses -.It Ev LC_MONETARY -rules and symbols for formatting monetary numeric information -.It Ev LC_NUMERIC -rules and symbols for formatting nonmonetary numeric information -.It Ev LC_TIME -rules and symbols for formatting time and date information -.El -.Pp -Localization of the system is achieved by setting appropriate values -in environment variables to identify which locale should be used. -The environment variables have the same names as their respective -locale categories. -Additionally, the -.Ev LANG , -.Ev LC_ALL , -and -.Ev NLSPATH -environment variables are used. -The -.Ev NLSPATH -environment variable specifies a colon-separated list of directory names -where the message catalog files of the NLS database are located. -The -.Ev LC_ALL -and -.Ev LANG -environment variables also determine the current locale. -.Pp -The values of these environment variables contains a string format as: -.Pp -.Bd -literal - language[_territory][.codeset][@modifier] -.Ed -.Pp -Valid values for the language field come from the ISO639 standard which -defines two-character codes for many languages. -Some common language codes are: -.Pp -.Bl -column "PERSIAN (farsi)" "Sy Code" "OCEANIC/INDONESIAN" -.It Sy Language Name Ta Sy Code Ta Sy Language Family -.It ABKHAZIAN AB IBERO-CAUCASIAN -.It AFAN (OROMO) OM HAMITIC -.It AFAR AA HAMITIC -.It AFRIKAANS AF GERMANIC -.It ALBANIAN SQ INDO-EUROPEAN (OTHER) -.It AMHARIC AM SEMITIC -.It ARABIC AR SEMITIC -.It ARMENIAN HY INDO-EUROPEAN (OTHER) -.It ASSAMESE AS INDIAN -.It AYMARA AY AMERINDIAN -.It AZERBAIJANI AZ TURKIC/ALTAIC -.It BASHKIR BA TURKIC/ALTAIC -.It BASQUE EU BASQUE -.It BENGALI BN INDIAN -.It BHUTANI DZ ASIAN -.It BIHARI BH INDIAN -.It BISLAMA Ta BI Ta "" -.It BRETON BR CELTIC -.It BULGARIAN BG SLAVIC -.It BURMESE MY ASIAN -.It BYELORUSSIAN BE SLAVIC -.It CAMBODIAN KM ASIAN -.It CATALAN CA ROMANCE -.It CHINESE ZH ASIAN -.It CORSICAN CO ROMANCE -.It CROATIAN HR SLAVIC -.It CZECH CS SLAVIC -.It DANISH DA GERMANIC -.It DUTCH NL GERMANIC -.It ENGLISH EN GERMANIC -.It ESPERANTO EO INTERNATIONAL AUX. -.It ESTONIAN ET FINNO-UGRIC -.It FAROESE FO GERMANIC -.It FIJI FJ OCEANIC/INDONESIAN -.It FINNISH FI FINNO-UGRIC -.It FRENCH FR ROMANCE -.It FRISIAN FY GERMANIC -.It GALICIAN GL ROMANCE -.It GEORGIAN KA IBERO-CAUCASIAN -.It GERMAN DE GERMANIC -.It GREEK EL LATIN/GREEK -.It GREENLANDIC KL ESKIMO -.It GUARANI GN AMERINDIAN -.It GUJARATI GU INDIAN -.It HAUSA HA NEGRO-AFRICAN -.It HEBREW HE SEMITIC -.It HINDI HI INDIAN -.It HUNGARIAN HU FINNO-UGRIC -.It ICELANDIC IS GERMANIC -.It INDONESIAN ID OCEANIC/INDONESIAN -.It INTERLINGUA IA INTERNATIONAL AUX. -.It INTERLINGUE IE INTERNATIONAL AUX. -.It INUKTITUT Ta IU Ta "" -.It INUPIAK IK ESKIMO -.It IRISH GA CELTIC -.It ITALIAN IT ROMANCE -.It JAPANESE JA ASIAN -.It JAVANESE JV OCEANIC/INDONESIAN -.It KANNADA KN DRAVIDIAN -.It KASHMIRI KS INDIAN -.It KAZAKH KK TURKIC/ALTAIC -.It KINYARWANDA RW NEGRO-AFRICAN -.It KIRGHIZ KY TURKIC/ALTAIC -.It KURUNDI RN NEGRO-AFRICAN -.It KOREAN KO ASIAN -.It KURDISH KU IRANIAN -.It LAOTHIAN LO ASIAN -.It LATIN LA LATIN/GREEK -.It LATVIAN LV BALTIC -.It LINGALA LN NEGRO-AFRICAN -.It LITHUANIAN LT BALTIC -.It MACEDONIAN MK SLAVIC -.It MALAGASY MG OCEANIC/INDONESIAN -.It MALAY MS OCEANIC/INDONESIAN -.It MALAYALAM ML DRAVIDIAN -.It MALTESE MT SEMITIC -.It MAORI MI OCEANIC/INDONESIAN -.It MARATHI MR INDIAN -.It MOLDAVIAN MO ROMANCE -.It MONGOLIAN Ta MN Ta "" -.It NAURU Ta NA Ta "" -.It NEPALI NE INDIAN -.It NORWEGIAN NO GERMANIC -.It OCCITAN OC ROMANCE -.It ORIYA OR INDIAN -.It PASHTO PS IRANIAN -.It PERSIAN (farsi) FA IRANIAN -.It POLISH PL SLAVIC -.It PORTUGUESE PT ROMANCE -.It PUNJABI PA INDIAN -.It QUECHUA QU AMERINDIAN -.It RHAETO-ROMANCE RM ROMANCE -.It ROMANIAN RO ROMANCE -.It RUSSIAN RU SLAVIC -.It SAMOAN SM OCEANIC/INDONESIAN -.It SANGHO SG NEGRO-AFRICAN -.It SANSKRIT SA INDIAN -.It SCOTS GAELIC GD CELTIC -.It SERBIAN SR SLAVIC -.It SERBO-CROATIAN SH SLAVIC -.It SESOTHO ST NEGRO-AFRICAN -.It SETSWANA TN NEGRO-AFRICAN -.It SHONA SN NEGRO-AFRICAN -.It SINDHI SD INDIAN -.It SINGHALESE SI INDIAN -.It SISWATI SS NEGRO-AFRICAN -.It SLOVAK SK SLAVIC -.It SLOVENIAN SL SLAVIC -.It SOMALI SO HAMITIC -.It SPANISH ES ROMANCE -.It SUNDANESE SU OCEANIC/INDONESIAN -.It SWAHILI SW NEGRO-AFRICAN -.It SWEDISH SV GERMANIC -.It TAGALOG TL OCEANIC/INDONESIAN -.It TAJIK TG IRANIAN -.It TAMIL TA DRAVIDIAN -.It TATAR TT TURKIC/ALTAIC -.It TELUGU TE DRAVIDIAN -.It THAI TH ASIAN -.It TIBETAN BO ASIAN -.It TIGRINYA TI SEMITIC -.It TONGA TO OCEANIC/INDONESIAN -.It TSONGA TS NEGRO-AFRICAN -.It TURKISH TR TURKIC/ALTAIC -.It TURKMEN TK TURKIC/ALTAIC -.It TWI TW NEGRO-AFRICAN -.It UIGUR Ta UG Ta "" -.It UKRAINIAN UK SLAVIC -.It URDU UR INDIAN -.It UZBEK UZ TURKIC/ALTAIC -.It VIETNAMESE VI ASIAN -.It VOLAPUK VO INTERNATIONAL AUX. -.It WELSH CY CELTIC -.It WOLOF WO NEGRO-AFRICAN -.It XHOSA XH NEGRO-AFRICAN -.It YIDDISH YI GERMANIC -.It YORUBA YO NEGRO-AFRICAN -.It ZHUANG Ta ZA Ta "" -.It ZULU ZU NEGRO-AFRICAN -.El -.Pp -For example, the locale for the Danish language spoken in Denmark -using the ISO 8859-1 character set is da_DK.ISO8859-1. -The da stands for the Danish language and the DK stands for Denmark. -The short form of da_DK is sufficient to indicate this locale. -.Pp -The environment variable settings are queried by their priority level -in the following manner: -.Pp -.Bl -bullet -.It -If the -.Ev LC_ALL -environment variable is set, all six categories use the locale it -specifies. -.It -If the -.Ev LC_ALL -environment variable is not set, each individual category uses the -locale specified by its corresponding environment variable. -.It -If the -.Ev LC_ALL -environment variable is not set, and a value for a particular -.Ev LC_* -environment variable is not set, the value of the -.Ev LANG -environment variable specifies the default locale for all categories. -Only the -.Ev LANG -environment variable should be set in /etc/profile, since it makes it -most easy for the user to override the system default using the individual -.Ev LC_* -variables. -.It -If the -.Ev LC_ALL -environment variable is not set, a value for a particular -.Ev LC_* -environment variable is not set, and the value of the -.Ev LANG -environment variable is not set, the locale for that specific -category defaults to the C locale. -The C or POSIX locale assumes the ASCII character set and defines -information for the six categories. -.El -.Ss Character Sets -A character is any symbol used for the organization, control, or -representation of data. -A group of such symbols used to describe a -particular language make up a character set. -It is the encoding values in a character set that provide -the interface between the system and its input and output devices. -.Pp -The following character sets are supported in -.Nx : -.Bl -tag -width ISO_8859_family -.It ASCII -The American Standard Code for Information Exchange (ASCII) standard -specifies 128 Roman characters and control codes, encoded in a 7-bit -character encoding scheme. -.It ISO 8859 family -Industry-standard character sets specified by the ISO/IEC 8859 -standard. -The standard is divided into 15 numbered parts, with each -part specifying broad script similarities. -Examples include Western European, Central European, Arabic, Cyrillic, -Hebrew, Greek, and Turkish. -The character sets use an 8-bit character encoding scheme which is -compatible with the ASCII character set. -.It Unicode -The Unicode character set is the full set of known abstract characters of -all real-world scripts. It can be used in environments where multiple -scripts must be processed simultaneously. -Unicode is compatible with ISO 8859-1 (Western European) and ASCII. -Many character encoding schemes are available for Unicode, including UTF-8, -UTF-16 and UTF-32. -These encoding schemes are multi-byte encodings. -The UTF-8 encoding scheme uses 8-bit, variable-width encodings which is -compatible with ASCII. -The UTF-16 encoding scheme uses 16-bit, variable-width encodings. -The UTF-32 encoding scheme using 32-bit, fixed-width encodings. -.El -.Ss Font Sets -A font set contains the glyphs to be displayed on the screen for a -corresponding character in a character set. -A display must support a suitable font to display a character set. -If suitable fonts are available to the X server, then X clients can -include support for different character sets. -.Xr xterm 1 -includes support for Unicode with UTF-8 encoding. -.Xr xfd 1 -is useful for displaying all the characters in an X font. -.Pp -The -.Nx -.Xr wscons 4 -console provides support for loading fonts using the -.Xr wsfontload 8 -utility. -Currently, only fonts for the ISO8859-1 family of character sets are -supported. -.Ss Internationalization for Programmers -To facilitate translations of messages into various languages and to -make the translated messages available to the program based on a -user's locale, it is necessary to keep messages separate from the -programs and provide them in the form of message catalogs that a -program can access at run time. -.Pp -Access to locale information is provided through the -.Xr setlocale 3 -and -.Xr nl_langinfo 3 -interfaces. -See their respective man pages for further information. -.Pp -Message source files containing application messages are created by -the programmer and converted to message catalogs. -These catalogs are used by the application to retrieve and display -messages, as needed. -.Pp -.Nx -supports two message catalog interfaces: the X/Open -.Xr catgets 3 -interface and the Uniforum -.Xr gettext 3 -interface. -The -.Xr catgets 3 -interface has the advantage that it belongs to a standard which is -well supported. -Unfortunately the interface is complicated to use and -maintenance of the catalogs is difficult. -The implementation also doesn't support different character sets. -The -.Xr gettext 3 -interface has not been standardized yet, however it is being supported -by an increasing number of systems. -It also provides many additional tools which make programming and -catalog maintenance much easier. -.Ss Support for Multi-byte Encodings -Some character sets with multi-byte encodings may be difficult to decode, -or may contain state (i.e., adjacent characters are dependent). -ISO C specifies a set of functions using 'wide characters' which can handle -multi-byte encodings properly. -The behaviour of these functions is affected -by the -.Ev LC_CTYPE -category of the current locale. -.Pp -A wide character is specified in ISO C -as being a fixed number of bits wide and is stateless. -There are two types for wide characters: -.Em wchar_t -and -.Em wint_t . -.Em wchar_t -is a type which can contain one wide character and operates like 'char' -type does for one character. -.Em wint_t -can contain one wide character or WEOF (wide EOF). -.Pp -There are functions that operate on -.Em wchar_t , -and substitute for functions operating on 'char'. -See -.Xr wmemchr 3 -and -.Xr towlower 3 -for details. -There are some additional functions that operate on -.Em wchar_t . -See -.Xr wctype 3 -and -.Xr wctrans 3 -for details. -.Pp -Wide characters should be used for all I/O processing which may rely -on locale-specific strings. -The two primary issues requiring special use of wide characters are: -.Bl -bullet -offset indent -.It -All I/O is performed using multibyte characters. -Input data is converted into wide characters immediately after -reading and data for output is converted from wide characters to -multi-byte encoding immediately before writing. -Conversion is controlled by the -.Xr mbstowcs 3 , -.Xr mbsrtowcs 3 , -.Xr wcstombs 3 , -.Xr wcsrtombs 3 , -.Xr mblen 3 , -.Xr mbrlen 3 , -and -.Xr mbsinit 3 . -.It -Wide characters are used directly for I/O, using -.Xr getwchar 3 , -.Xr fgetwc 3 , -.Xr getwc 3 , -.Xr ungetwc 3 , -.Xr fgetws 3 , -.Xr putwchar 3 , -.Xr fputwc 3 , -.Xr putwc 3 , -and -.Xr fputws 3 . -They are also used for formatted I/O functions for wide characters -such as -.Xr fwscanf 3 , -.Xr wscanf 3 , -.Xr swscanf 3 , -.Xr fwprintf 3 , -.Xr wprintf 3 , -.Xr swprintf 3 , -.Xr vfwprintf 3 , -.Xr vwprintf 3 , -and -.Xr vswprintf 3 , -and wide character identifier of %lc, %C, %ls, %S for conventional -formatted I/O functions. -.El -.Sh SEE ALSO -.Xr gencat 1 , -.Xr xfd 1 , -.Xr xterm 1 , -.Xr catgets 3 , -.Xr gettext 3 , -.Xr nl_langinfo 3 , -.Xr setlocale 3 , -.Xr wsfontload 8 -.Sh BUGS -This man page is incomplete. diff --git a/share/man/man8/Makefile b/share/man/man8/Makefile index 9fff4d87e..d9039300a 100644 --- a/share/man/man8/Makefile +++ b/share/man/man8/Makefile @@ -2,12 +2,7 @@ # from: @(#)Makefile 8.1 (Berkeley) 6/5/93 # MINIX: -MAN= \ - \ - \ - \ - rc.8 rc.subr.8 \ - \ +MAN= #MLINKS+=MAKEDEV.8 makedev.8 #MLINKS+=MAKEDEV.local.8 makedev.local.8 @@ -17,9 +12,6 @@ MAN= \ #MLINKS+=compat_svr4.8 compat_xenix.8 #MLINKS+=compat_netbsd32.8 netbsd32.8 #MLINKS+=nis.8 yp.8 -MLINKS+=rc.8 rc.d.8 -MLINKS+=rc.8 rc.local.8 -MLINKS+=rc.8 rc.shutdown.8 .if !defined(__MINIX) SUBDIR= man8.acorn26 man8.acorn32 man8.alpha man8.amiga man8.atari \ diff --git a/share/man/man8/rc.8 b/share/man/man8/rc.8 deleted file mode 100644 index 55230309a..000000000 --- a/share/man/man8/rc.8 +++ /dev/null @@ -1,381 +0,0 @@ -.\" $NetBSD: rc.8,v 1.36 2010/05/14 16:19:58 jruoho Exp $ -.\" -.\" Copyright (c) 2000-2004 The NetBSD Foundation, Inc. -.\" All rights reserved. -.\" -.\" This code is derived from software contributed to The NetBSD Foundation -.\" by Luke Mewburn. -.\" -.\" Redistribution and use in source and binary forms, with or without -.\" modification, are permitted provided that the following conditions -.\" are met: -.\" 1. Redistributions of source code must retain the above copyright -.\" notice, this list of conditions and the following disclaimer. -.\" 2. Redistributions in binary form must reproduce the above copyright -.\" notice, this list of conditions and the following disclaimer in the -.\" documentation and/or other materials provided with the distribution. -.\" -.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS -.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED -.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR -.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS -.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR -.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF -.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS -.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN -.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) -.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE -.\" POSSIBILITY OF SUCH DAMAGE. -.\" -.Dd May 14, 2010 -.Dt RC 8 -.Os -.Sh NAME -.Nm rc , -.Nm rc.local , -.Nm rc.shutdown , -.Nm rc.d/ -.Nd startup and shutdown scripts -.Sh SYNOPSIS -.Nm rc -.Nm rc.local -.Nm rc.shutdown -.Nm rc.d/ -.Sh DESCRIPTION -.Nm -is the command script which controls the startup of various services, -and is invoked by -.Xr init 8 -as part of the process of entering the automatic reboot to multi-user startup, -or after the single user mode shell has exited. -If -.Xr init 8 -is starting the automatic reboot process, -.Nm -is invoked with the argument of -.Sq autoboot . -.Pp -.Nm rc.local -is a command script to which local boot-time actions can be added. -It is (nearly) the last thing invoked by -.Nm rc -during a normal boot. -.Pp -.Nm rc.shutdown -is the command script which shuts down various services, and is invoked by -.Xr shutdown 8 -as part of the process of shutting down the system. -.Pp -.Nm rc.d/ -is the directory which contains various -.Xr sh 1 -scripts, one for each service, -which are called by -.Nm -at startup, -.Nm rc.shutdown -at shutdown, -and as necessary during system operation to stop, start, restart, reload, -or otherwise control the service. -.Ss Operation of rc -.Bl -enum -.It -Source -.Pa /etc/rc.subr -to load various -.Xr rc.subr 8 -shell functions to use. -.It -If autobooting, set -.Sy autoboot=yes -and enable a flag -.Sy ( rc_fast=yes ) , -which prevents the -.Nm rc.d -scripts from performing the check for already running processes -(thus speeding up the boot process). -This -.Sy rc_fast=yes -speedup won't occur when -.Nm -is started up after exiting the single-user shell. -.It -Invoke -.Xr rcorder 8 -to order the files in -.Pa /etc/rc.d/ -that do not have a -.Dq nostart -keyword (refer to -.Xr rcorder 8 Ns 's -.Fl s -flag), -and assigns the result to a variable. -.It -Calls each script in turn using -.Fn run_rc_script -(from -.Xr rc.subr 8 ) , -which sets -.Dv $1 -to -.Sq start , -and sources the script in a subshell. -If the script has a -.Sq .sh -suffix then it is sourced directly into the current shell. -.It -The output from the above steps is sent to a post-processor. -If -.Sy rc_silent -is false, then the post-processor displays the output. -If -.Sy rc_silent -is true, then the post-processor invokes the command specified in -.Va rc_silent_cmd -once for each line, without otherwise displaying the output. -Useful values for -.Va rc_silent_cmd -include -.Dq \&: -to display nothing at all, and -.Dq twiddle -to display a spinning symbol on the console. -Regardless of the value of -.Sy rc_silent , -the post-processor saves the output in -.Pa /var/run/rc.log . -.El -.Ss Operation of rc.shutdown -.Bl -enum -.It -Source -.Pa /etc/rc.subr -to load various -.Xr rc.subr 8 -shell functions to use. -.It -Invoke -.Xr rcorder 8 -to order the files in -.Pa /etc/rc.d/ -that have a -.Dq shutdown -keyword (refer to -.Xr rcorder 8 Ns 's -.Fl k -flag), -reverses that order, and assigns the result to a variable. -.It -Calls each script in turn using -.Fn run_rc_script -(from -.Xr rc.subr 8 ) , -which sets -.Dv $1 -to -.Sq stop , -and sources the script in a subshell. -If the script has a -.Sq .sh -suffix then it is sourced directly into the current shell. -.El -.Ss Contents of rc.d/ -.Nm rc.d/ -is located in -.Pa /etc/rc.d . -The following file naming conventions are currently used in -.Nm rc.d/ : -.Bl -tag -width ALLUPPERCASExx -offset indent -.It Pa ALLUPPERCASE -Scripts that are -.Sq placeholders -to ensure that certain operations are performed before others. -In order of startup, these are: -.Bl -tag -width NETWORKINGxx -.It Pa NETWORKING -Ensure basic network services are running, including general -network configuration -.Pq Pa network -and -.Pa dhclient . -.It Pa SERVERS -Ensure basic services (such as -.Pa NETWORKING , -.Pa ppp , -.Pa syslogd , -and -.Pa kdc ) -exist for services that start early (such as -.Pa named ) , -because they're required by -.Pa DAEMON -below. -.It Pa DAEMON -Before all general purpose daemons such as -.Pa dhcpd , -.Pa lpd , -and -.Pa ntpd . -.It Pa LOGIN -Before user login services -.Pa ( inetd , -.Pa telnetd , -.Pa rshd , -.Pa sshd , -and -.Pa xdm ) , -as well as before services which might run commands as users -.Pa ( cron , -.Pa postfix , -and -.Pa sendmail ) . -.El -.It Pa foo.sh -Scripts that are to be sourced into the current shell rather than a subshell -have a -.Sq Pa .sh -suffix. -Extreme care must be taken in using this, as the startup sequence will -terminate if the script does. -.Pa /etc/rc.d/bootconf.sh -uses this behaviour to allow the user to select a different -configuration (including -.Pa /etc/rc.conf ) -early in the boot. -.It Pa bar -Scripts that are sourced in a subshell. -The boot does not stop if such a script terminates with a non-zero status, -but a script can stop the boot if necessary by invoking the -.Fn stop_boot -function (from -.Xr rc.subr 8 ) . -.El -.Pp -Each script should contain -.Xr rcorder 8 -keywords, especially an appropriate -.Dq PROVIDE -entry. -.Pp -The scripts are expected to support at least the following arguments: -.Bl -tag -width restart -offset indent -.It Sy start -Start the service. -This should check that the service is to be started as specified by -.Xr rc.conf 5 . -Also checks if the service is already running and refuses to start if -it is. -This latter check is not performed by standard -.Nx -scripts if the system is starting directly to multi-user mode, to -speed up the boot process. -.It Sy stop -If the service is to be started as specified by -.Xr rc.conf 5 , -stop the service. -This should check that the service is running and complain if it's not. -.It Sy restart -Perform a -.Sy stop -then a -.Sy start . -.It Sy status -If the script starts a process (rather than performing a one-off -operation), show the status of the process. -Otherwise it's not necessary to support this argument. -Defaults to displaying the process ID of the program (if running). -.It Sy poll -If the script starts a process (rather than performing a one-off -operation), wait for the command to exit. -Otherwise it's not necessary to support this argument. -.It Sy rcvar -Display which -.Xr rc.conf 5 -variables are used to control the startup of the service (if any). -.El -.Pp -Other arguments (such as -.Sq reload , -.Sq dumpdb , -etc) can be added if necessary. -.Pp -The argument may have one of the following prefixes to alter its operation: -.Bl -tag -width "force" -offset indent -.It Sy fast -Skip the check for an existing running process. -Sets -.Sy rc_fast=yes . -.It Sy force -Skips the -.Xr rc.conf 5 -check, ignores a failure result from any of the prerequisite checks, -executes the command, and always returns a zero exit status. -Sets -.Sy rc_force=yes . -.It Sy one -Skips the -.Xr rc.conf 5 -check, but performs all other prerequisite tests. -.El -.Pp -In order to simplify scripts, the -.Fn run_rc_command -function from -.Xr rc.subr 8 -may be used. -.Sh FILES -.Bl -tag -width /etc/rc.shutdown -compact -.It Pa /etc/rc -Startup script called by -.Xr init 8 . -.It Pa /etc/rc.d/ -Directory containing control scripts for each service. -.It Pa /etc/rc.local -Local startup script. -.It Pa /etc/rc.shutdown -Shutdown script called by -.Xr shutdown 8 . -.It Pa /etc/rc.subr -Contains -.Xr rc.subr 8 -functions used by various scripts. -.It Pa /etc/rc.conf -System startup configuration file. -.It Pa /var/run/rc.log -Log file created by -.Nm . -.El -.Sh SEE ALSO -.Xr rc.conf 5 , -.Xr init 8 , -.Xr rc.subr 8 , -.Xr rcorder 8 , -.Xr reboot 8 , -.Xr shutdown 8 -.Rs -.%A Luke Mewburn -.%T The Design and Implementation of the NetBSD rc.d system -.%I USENIX Association -.%B Proceedings of the FREENIX Track: 2001 USENIX Annual Technical Conference -.%D June 25-30, 2001 -.%U http://www.usenix.org/publications/library/proceedings/usenix01/freenix01/full_papers/mewburn/mewburn.pdf -.Re -.Sh HISTORY -The -.Nm -command appeared in -.Bx 4.0 . -The -.Pa /etc/rc.d -support was implemented in -.Nx 1.5 -by -.An Luke Mewburn -.Aq lukem@NetBSD.org . -The post-processor, support for -.Va rc_silent , -and saving output to a file, was implemented in -.Nx 6.0 -by -.An Alan Barrett . diff --git a/share/man/man8/rc.subr.8 b/share/man/man8/rc.subr.8 deleted file mode 100644 index 2fac9b80d..000000000 --- a/share/man/man8/rc.subr.8 +++ /dev/null @@ -1,865 +0,0 @@ -.\" $NetBSD: rc.subr.8,v 1.31 2012/12/18 13:14:34 wiz Exp $ -.\" -.\" Copyright (c) 2002-2011 The NetBSD Foundation, Inc. -.\" All rights reserved. -.\" -.\" This code is derived from software contributed to The NetBSD Foundation -.\" by Luke Mewburn. -.\" -.\" Redistribution and use in source and binary forms, with or without -.\" modification, are permitted provided that the following conditions -.\" are met: -.\" 1. Redistributions of source code must retain the above copyright -.\" notice, this list of conditions and the following disclaimer. -.\" 2. Redistributions in binary form must reproduce the above copyright -.\" notice, this list of conditions and the following disclaimer in the -.\" documentation and/or other materials provided with the distribution. -.\" -.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS -.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED -.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR -.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS -.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR -.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF -.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS -.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN -.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) -.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE -.\" POSSIBILITY OF SUCH DAMAGE. -.\" -.Dd December 17, 2012 -.Dt RC.SUBR 8 -.Os -.Sh NAME -.Nm rc.subr -.Nd functions used by system shell scripts -.Sh SYNOPSIS -.Bl -item -.It -.Li . /etc/rc.subr -.It -.Ic backup_file Ar action Ar file Ar current Ar backup -.It -.Ic basename Ar file Op Ar suffix -.It -.Ic checkyesno Ar var -.It -.Ic check_pidfile Ar pidfile Ar procname Op Ar interpreter -.It -.Ic check_process Ar procname Op Ar interpreter -.It -.Ic collapse_backslash_newline -.It -.Ic dirname Ar file -.It -.Ic err Ar exitval Ar message -.It -.Ic load_rc_config Ar command -.It -.Ic load_rc_config_var Ar command Ar var -.It -.Ic mount_critical_filesystems Ar type -.It -.Ic no_rc_postprocess Ar command Op Ar arguments -.It -.Ic print_rc_metadata Ar string -.It -.Ic print_rc_normal Oo Fl n Oc Ar string -.It -.Ic rc_usage Ar command Op Ar ... -.It -.Ic reverse_list Ar item Op Ar ... -.It -.Ic run_rc_command Ar argument [parameters] -.It -.Ic run_rc_script Ar file Ar argument -.It -.Ic stop_boot -.It -.Ic twiddle -.It -.Ic wait_for_pids Op Ar pid Op Ar ... -.It -.Ic warn Ar message -.It -.Ic yesno_to_truefalse Ar var -.El -.Sh DESCRIPTION -.Nm -contains commonly used shell script functions which are used by -various scripts such as -.Xr rc 8 , -and the periodic system services which are controlled by -.Xr daily.conf 5 , -.Xr monthly.conf 5 , -.Xr security.conf 5 , -and -.Xr weekly.conf 5 . -.Pp -The -.Nm -functions are accessed by sourcing -.Pa /etc/rc.subr -into the current shell. -.Pp -The following shell functions are available: -.Bl -tag -width 4n -.It Ic backup_file Ar action Ar file Ar current Ar backup -Make a backup copy of -.Ar file -into -.Ar current . -If the -.Xr rc.conf 5 -variable -.Sy backup_uses_rcs -is -.Sq YES , -use -.Xr rcs 1 -to archive the previous version of -.Ar current , -otherwise save the previous version of -.Ar current -as -.Ar backup . -.Pp -.Ar action -may be one of the following: -.Bl -tag -width remove -.It Sy add -.Ar file -is now being backed up by or possibly re-entered into this backup mechanism. -.Ar current -is created, and if necessary, the -.Xr rcs 1 -files are created as well. -.It Sy update -.Ar file -has changed and needs to be backed up. -If -.Ar current -exists, it is copied to -.Ar backup -or checked into -.Xr rcs 1 -(if the repository file is old), -and then -.Ar file -is copied to -.Ar current . -.It Sy remove -.Ar file -is no longer being tracked by this backup mechanism. -If -.Xr rcs 1 -is being used, an empty file is checked in and -.Ar current -is removed, -otherwise -.Ar current -is moved to -.Ar backup . -.El -.Ic basename Ar file Op Ar suffix -Just like -.Xr basename 1 , -except implemented using shell built-in commands, and usable before the -.Pa /usr/bin -direcory is available. -.It Ic checkyesno Ar var -Return 0 if -.Ar var -is defined to -.Sq YES , -.Sq TRUE , -.Sq ON , -or -.Sq 1 . -Return 1 if -.Ar var -is defined to -.Sq NO , -.Sq FALSE , -.Sq OFF , -or -.Sq 0 . -Otherwise, warn that -.Ar var -is not set correctly. -The values are case insensitive. -.Pp -Note that the warning message shown by this function when -.Ar var -is not set references a manual page where the user can find more information. -Its name is picked up from the -.Sy rcvar_manpage -variable. -.It Ic check_pidfile Ar pidfile Ar procname Op Ar interpreter -Parses the first word of the first line of -.Ar pidfile -for a PID, and ensures that the process with that PID -is running and its first argument matches -.Ar procname . -Prints the matching PID if successful, otherwise nothing. -If -.Ar interpreter -is provided, parse the first line of -.Ar procname , -ensure that the line is of the form -.Dl #! interpreter [...] -and use -.Ar interpreter -with its optional arguments and -.Ar procname -appended as the process string to search for. -.It Ic check_process Ar procname Op Ar interpreter -Prints the PIDs of any processes that are running with a first -argument that matches -.Ar procname . -.Ar interpreter -is handled as per -.Ic check_pidfile . -.It Ic collapse_backslash_newline -Copy input to output, collapsing -.Ao backslash Ac Ns Ao newline Ac -to nothing, but leaving other backslashes alone. -.Ic dirname Ar file -Just like -.Xr dirname 1 , -except implemented using shell built-in commands, and usable before the -.Pa /usr/bin -direcory is available. -.It Ic err Ar exitval Ar message -Display an error message to -.Em stderr , -log it to the system log -using -.Xr logger 1 , -and -.Cm exit -with an exit value of -.Ar exitval . -The error message consists of the script name -(from -.Sy $0 ) , -followed by -.Dq ": ERROR: " , -and then -.Ar message . -.It Ic load_rc_config Ar command -Source in the -.Xr rc.conf 5 -configuration files for -.Ar command . -First, -.Pa /etc/rc.conf -is sourced if it has not yet been read in. -Then, -.Pa /etc/rc.conf.d/ Ns Ar command -is sourced if it is an existing file. -The latter may also contain other variable assignments to override -.Ic run_rc_command -arguments defined by the calling script, to provide an easy -mechanism for an administrator to override the behaviour of a given -.Xr rc.d 8 -script without requiring the editing of that script. -.It Ic load_rc_config_var Ar command Ar var -Read the -.Xr rc.conf 5 -variable -.Ar var -for -.Ar command -and set in the current shell, using -.Ic load_rc_config -in a sub-shell to prevent unwanted side effects from other variable -assignments. -.It Ic mount_critical_filesystems Ar type -Go through a list of critical file systems, -as found in the -.Xr rc.conf 5 -variable -.Sy critical_filesystems_ Ns Ar type , -mounting each one that -is not currently mounted. -.It Ic no_rc_postprocess Ar command Op Ar arguments -Execute the specified command with the specified arguments, -in such a way that its output bypasses the post-processor that -.Xr rc 8 -uses for most commands. -This implies that the output will not appear in the -.Pa /var/run/rc.log -file, and will appear on the console regardless of the -value of -.Va rc_silent . -This is expected to be useful for interactive commands, -and this mechanism is automatically used by -.Ic run_rc_command -when a script contains the -.Xr rcorder 8 -keyword -.Dq interactive . -.Pp -If invoked from a context that does not appear to be under the control of -.Xr rc 8 , -then the command is executed without special treatment. -.It Ic print_rc_metadata Ar string -Print the specified -.Ar string -in such a way that it should be handled as meta-data by the -.Xr rc 8 -post-processor. -If invoked from a context that does not appear to be under the control of -.Xr rc 8 , -then the -.Ar string -is discarded. -.Pp -Any -.Xr rc.d 8 -script may invoke this function with an argument that begins with -.Dq note: , -followed by one line of arbitrary text; -the text will be logged by -.Xr rc 8 -but will not be displayed on the console. -.Pp -The use of arguments that do not begin with -.Dq note: -is reserved for internal use by -.Xr rc 8 -and -.Nm . -.It Ic print_rc_normal Oo Fl n Oc Ar string -Print the specified -.Ar string -in such a way that it should be handled as normal output by the -.Xr rc 8 -post-processor. -If invoked from a context that does not appear to be under the control of -.Xr rc 8 , -then the -.Ar string -is printed to standard output. -.Pp -If the -.Fl n -flag is specified, then the string is printed without a newline. -.Pp -Intended use cases include: -.Bl -bullet -.It -An rc.d script can use -.Dq Sy print_rc_normal Fl n -to print a partial line in such a way that it appears -immediately instead of being buffered by -.Xr rc 8 Ap s -post-processor. -.It -An rc.d script that is run via the -.Sy no_rc_postprocess -function (so most of its output is invisible to -.Xr rc 8 Ap s -post-processor) can use -.Sy print_rc_normal -to force some of its output to be seen by the post-processor. -.El -.It Ic rc_usage Ar command Op Ar ... -Print a usage message for -.Sy $0 , -with -.Ar commands -being the list of valid arguments -prefixed by -.Dq "[fast|force|one]" . -.It Ic reverse_list Ar item Op Ar ... -Print the list of -.Ar items -in reverse order. -.It Ic run_rc_command Ar argument Op Ar parameter ... -Run the -.Ar argument -method for the current -.Xr rc.d 8 -script, based on the settings of various shell variables. -.Ic run_rc_command -is extremely flexible, and allows fully functional -.Xr rc.d 8 -scripts to be implemented in a small amount of shell code. -The optional set of parameters is passed verbatim to the command, but not to its -pre/post hooks. -.Pp -.Ar argument -is searched for in the list of supported commands, which may be one -of: -.Bl -tag -width restart -offset indent -.It Sy start -Start the service. -This should check that the service is to be started as specified by -.Xr rc.conf 5 . -Also checks if the service is already running and refuses to start if -it is. -This latter check is not performed by standard -.Nx -scripts if the system is starting directly to multi-user mode, to -speed up the boot process. -.It Sy stop -If the service is to be started as specified by -.Xr rc.conf 5 , -stop the service. -This should check that the service is running and complain if it's not. -.It Sy restart -Perform a -.Sy stop -then a -.Sy start . -Defaults to displaying the process ID of the program (if running). -.It Sy rcvar -Display which -.Xr rc.conf 5 -variables are used to control the startup of the service (if any). -.El -.Pp -If -.Sy pidfile -or -.Sy procname -is set, also support: -.Bl -tag -width restart -offset indent -.It Sy poll -Wait for the command to exit. -.It Sy status -Show the status of the process. -.El -.Pp -Other supported commands are listed in the optional variable -.Sy extra_commands . -.Pp -.Ar argument -may have one of the following prefixes which alters its operation: -.Bl -tag -width "Prefix" -offset indent -.It Sy fast -Skip the check for an existing running process, -and sets -.Sy rc_fast=YES . -.It Sy force -Skip the checks for -.Sy rcvar -being set to yes, -and sets -.Sy rc_force=YES . -This ignores -.Ar argument Ns Sy _precmd -returning non-zero, and ignores any of the -.Sy required_* -tests failing, and always returns a zero exit status. -.It Sy one -Skip the checks for -.Sy rcvar -being set to yes, but performs all the other prerequisite tests. -.El -.Pp -.Ic run_rc_command -uses the following shell variables to control its behaviour. -Unless otherwise stated, these are optional. -.Bl -tag -width procname -offset indent -.It Sy name -The name of this script. -This is not optional. -.It Sy rcvar -The value of -.Sy rcvar -is checked with -.Ic checkyesno -to determine if this method should be run. -.It Sy rcvar_manpage -The manual page containing information about -.Sy rcvar . -It will be part of the warning message shown when -.Sy rcvar -is undefined. -Defaults to -.Xr rc.conf 5 . -.It Sy command -Full path to the command. -Not required if -.Ar argument Ns Sy _cmd -is defined for each supported keyword. -.It Sy command_args -Optional arguments and/or shell directives for -.Sy command . -.It Sy command_interpreter -.Sy command -is started with -.Dl #! command_interpreter [...] -which results in its -.Xr ps 1 -command being -.Dl command_interpreter [...] command -so use that string to find the PID(s) of the running command -rather than -.Ql command . -.It Sy extra_commands -Extra commands/keywords/arguments supported. -.It Sy pidfile -Path to pid file. -Used to determine the PID(s) of the running command. -If -.Sy pidfile -is set, use -.Dl check_pidfile $pidfile $procname -to find the PID. -Otherwise, if -.Sy command -is set, use -.Dl check_process $procname -to find the PID. -.It Sy procname -Process name to check for. -Defaults to the value of -.Sy command . -.It Sy required_dirs -Check for the existence of the listed directories -before running the default start method. -.It Sy required_files -Check for the readability of the listed files -before running the default start method. -.It Sy required_vars -Perform -.Ic checkyesno -on each of the list variables -before running the default start method. -.It Sy ${name}_chdir -Directory to -.Ic cd -to before running -.Sy command , -if -.Sy ${name}_chroot -is not provided. -.It Sy ${name}_chroot -Directory to -.Xr chroot 8 -to before running -.Sy command . -Only supported after -.Pa /usr -is mounted. -.It Sy ${name}_env -List of additional or modified environment variables to set -when starting -.Sy command . -.It Sy ${name}_flags -Arguments to call -.Sy command -with. -This is usually set in -.Xr rc.conf 5 , -and not in the -.Xr rc.d 8 -script. -The environment variable -.Sq Ev flags -can be used to override this. -.It Sy ${name}_nice -.Xr nice 1 -level to run -.Sy command -as. -Only supported after -.Pa /usr -is mounted. -.It Sy ${name}_user -User to run -.Sy command -as, using -.Xr chroot 8 . -if -.Sy ${name}_chroot -is set, otherwise -uses -.Xr su 1 . -Only supported after -.Pa /usr -is mounted. -.It Sy ${name}_group -Group to run the chrooted -.Sy command -as. -.It Sy ${name}_groups -Comma separated list of supplementary groups to run the chrooted -.Sy command -with. -.It Ar argument Ns Sy _cmd -Shell commands which override the default method for -.Ar argument . -.It Ar argument Ns Sy _precmd -Shell commands to run just before running -.Ar argument Ns Sy _cmd -or the default method for -.Ar argument . -If this returns a non-zero exit code, the main method is not performed. -If the default method is being executed, this check is performed after -the -.Sy required_* -checks and process (non-)existence checks. -.It Ar argument Ns Sy _postcmd -Shell commands to run if running -.Ar argument Ns Sy _cmd -or the default method for -.Ar argument -returned a zero exit code. -.It Sy sig_stop -Signal to send the processes to stop in the default -.Sy stop -method. -Defaults to -.Dv SIGTERM . -.It Sy sig_reload -Signal to send the processes to reload in the default -.Sy reload -method. -Defaults to -.Dv SIGHUP . -.El -.Pp -For a given method -.Ar argument , -if -.Ar argument Ns Sy _cmd -is not defined, then a default method is provided by -.Sy run_rc_command : -.Bl -tag -width "argument" -offset indent -.It Sy Argument -.Sy Default method -.It Sy start -If -.Sy command -is not running and -.Ic checkyesno Sy rcvar -succeeds, start -.Sy command . -.It Sy stop -Determine the PIDs of -.Sy command -with -.Ic check_pidfile -or -.Ic check_process -(as appropriate), -.Ic kill Sy sig_stop -those PIDs, and run -.Ic wait_for_pids -on those PIDs. -.It Sy reload -Similar to -.Sy stop , -except that it uses -.Sy sig_reload -instead, and doesn't run -.Ic wait_for_pids . -.It Sy restart -Runs the -.Sy stop -method, then the -.Sy start -method. -.It Sy status -Show the PID of -.Sy command , -or some other script specific status operation. -.It Sy poll -Wait for -.Sy command -to exit. -.It Sy rcvar -Display which -.Xr rc.conf 5 -variable is used (if any). -This method always works, even if the appropriate -.Xr rc.conf 5 -variable is set to -.Sq NO . -.El -.Pp -The following variables are available to the methods -(such as -.Ar argument Ns Sy _cmd ) -as well as after -.Ic run_rc_command -has completed: -.Bl -tag -width "rc_flags" -offset indent -.It Sy rc_arg -Argument provided to -.Sy run_rc_command , -after fast and force processing has been performed. -.It Sy rc_flags -Flags to start the default command with. -Defaults to -.Sy ${name}_flags , -unless overridden by the environment variable -.Sq Ev flags . -This variable may be changed by the -.Ar argument Ns Sy _precmd -method. -.It Sy rc_pid -PID of -.Sy command -(if appropriate). -.It Sy rc_fast -Not empty if -.Dq fast -prefix was used. -.It Sy rc_force -Not empty if -.Dq force -prefix was used. -.El -.It Ic run_rc_script Ar file Ar argument -Start the script -.Ar file -with an argument of -.Ar argument , -and handle the return value from the script. -.Pp -Various shell variables are unset before -.Ar file -is started: -.Bd -ragged -offset indent -.Sy name , -.Sy command , -.Sy command_args , -.Sy command_interpreter , -.Sy extra_commands , -.Sy pidfile , -.Sy rcvar , -.Sy required_dirs , -.Sy required_files , -.Sy required_vars , -.Ar argument Ns Sy _cmd , -.Ar argument Ns Sy _precmd . -.Ar argument Ns Sy _postcmd . -.Ed -.Pp -The startup behaviour of -.Ar file -depends upon the following checks: -.Bl -enum -.It -If -.Ar file -ends in -.Pa .sh , -it is sourced into the current shell. -.It -If -.Ar file -appears to be a backup or scratch file -(e.g., with a suffix of -.Sq ~ , -.Sq # , -.Sq .OLD , -or -.Sq .orig ) , -ignore it. -.It -If -.Ar file -is not executable, ignore it. -.It -If the -.Xr rc.conf 5 -variable -.Sy rc_fast_and_loose -is empty, -source -.Ar file -in a sub shell, -otherwise source -.Ar file -into the current shell. -.It -If -.Ar file -contains the -.Xr rcorder 8 -keyword -.Dq interactive , -then the command is executed using -.Ic no_rc_postprocess . -.El -.It Ic stop_boot -Prevent booting to multiuser mode. -If the -.Sy autoboot -variable is -.Sq yes , -then a -.Sy SIGTERM -signal is sent to the parent -process (which is assumed to be -.Xr rc 8 ) . -Otherwise, the shell exits with status -.Li 1 . -.It Ic twiddle -Display one of the characters -.Sq \&/ , \&- , \&\e , \&| , -followed by a backspace. -Repeated calls to this function will create the appearance of a spinning -symbol, as a different character is displayed on each call. -Output is to -.Pa /dev/tty , -so this function may be useful even inside a script whose output -has been redirected. -.It Ic wait_for_pids Op Ar pid Op Ar ... -Wait until all of the provided -.Ar pids -don't exist any more, printing the list of outstanding -.Ar pids -every two seconds. -.It Ic warn Ar message -Display a warning message to -.Em stderr -and log it to the system log -using -.Xr logger 1 . -The warning message consists of the script name -(from -.Sy $0 ) , -followed by -.Dq ": WARNING: " , -and then -.Ar message . -.It Ic yesno_to_truefalse Ar var -Change the value of the specified variable from any of the -forms acceptable to the -.Ic checkyesno -function, to -.Dq true -or -.Dq false . -.El -.Sh FILES -.Bl -tag -width /etc/rc.subr -compact -.It Pa /etc/rc.subr -The -.Nm -file resides in -.Pa /etc . -.El -.Sh SEE ALSO -.Xr rc.conf 5 , -.Xr rc 8 -.Sh HISTORY -.Nm -appeared in -.Nx 1.3 . -The -.Xr rc.d 8 -support functions appeared in -.Nx 1.5 . -Support for the -.Xr rc 8 -post-processor appeared in -.Nx 6.0 . diff --git a/share/nls/Makefile b/share/nls/Makefile deleted file mode 100644 index 1f00cbb38..000000000 --- a/share/nls/Makefile +++ /dev/null @@ -1,12 +0,0 @@ -# $NetBSD: Makefile,v 1.2 2002/09/18 07:50:31 lukem Exp $ - -NOOBJ= # defined - -.include - -.if ${MKNLS} != "no" -FILES= nls.alias -FILESDIR=/usr/share/nls # XXX use NLSDIR? - -.include -.endif diff --git a/share/nls/nls.alias b/share/nls/nls.alias deleted file mode 100644 index 912f031fe..000000000 --- a/share/nls/nls.alias +++ /dev/null @@ -1,74 +0,0 @@ -# $NetBSD: nls.alias,v 1.3 2003/04/14 05:21:51 salo Exp $ -# -# This file defines aliase names of nls catalogs. -# Syntax is similar to X11's locale.alias. -# (The first word is an alias name and the second -# one is nls catalog name.) - -ca_ES.ISO8859-1 ca -ca_ES.ISO8859-15 ca -cs_CZ.ISO8859-2 cs -#da_DK.ISO8859-1 da -#da_DK.ISO8859-15 da -de_AT.ISO8859-1 de -de_AT.ISO8859-15 de -de_CH.ISO8859-1 de -de_CH.ISO8859-15 de -de_DE.ISO8859-1 de -de_DE.ISO8859-15 de -#en_AU.ISO8859-1 en -#en_AU.ISO8859-15 en -#en_CA.ISO8859-1 en -#en_CA.ISO8859-15 en -#en_GB.ISO8859-1 en -#en_GB.ISO8859-15 en -#en_US.ISO8859-1 en -#en_US.ISO8859-15 en -#en_US.UTF-8 en -es_ES.ISO8859-1 es -es_ES.ISO8859-15 es -fi_FI.ISO8859-1 fi -fi_FI.ISO8859-15 fi -fr_BE.ISO8859-1 fr -fr_BE.ISO8859-15 fr -fr_CA.ISO8859-1 fr -fr_CA.ISO8859-15 fr -fr_CH.ISO8859-1 fr -fr_CH.ISO8859-15 fr -fr_FR.ISO8859-1 fr -fr_FR.ISO8859-15 fr -#hr_HR.ISO8859-2 hr -#hu_HU.ISO8859-2 hu -#is_IS.ISO8859-1 is -#is_IS.ISO8859-15 is -#it_CH.ISO8859-1 it -#it_CH.ISO8859-15 it -#it_IT.ISO8859-1 it -#it_IT.ISO8859-15 it -#ja_JP.ISO2022-JP ja -#ja_JP.ISO2022-JP2 ja -#ja_JP.SJIS ja -#ja_JP.ct ja -#ja_JP.eucJP ja -#ko_KR.eucKR ko -#lt_LT.ISO8859-4 lt -nl_BE.ISO8859-1 nl -nl_BE.ISO8859-15 nl -nl_NL.ISO8859-1 nl -nl_NL.ISO8859-15 nl -no_NO.ISO8859-1 no -no_NO.ISO8859-15 no -pl_PL.ISO8859-2 pl -#pt_PT.ISO8859-1 pt -#pt_PT.ISO8859-15 pt -#ru_RU.CP866 ru -#ru_RU.ISO8859-5 ru -#ru_RU.KOI8-R ru -#sl_SI.ISO8859-2 sl -sk_SK.ISO8859-2 sk -sv_SE.ISO8859-1 sv -sv_SE.ISO8859-15 sv -#uk_UA.KOI8-U uk -#zh_CN.eucCN zh -#zh_TW.Big5 zh -#zh_TW.eucTW zh