1.\" $OpenBSD: intro.8,v 1.27 2015/11/04 12:03:54 jmc Exp $ 2.\" $NetBSD: intro.8,v 1.3 1994/11/30 19:36:24 jtc Exp $ 3.\" 4.\" Copyright (c) 1983, 1991, 1993 5.\" The Regents of the University of California. All rights reserved. 6.\" 7.\" Redistribution and use in source and binary forms, with or without 8.\" modification, are permitted provided that the following conditions 9.\" are met: 10.\" 1. Redistributions of source code must retain the above copyright 11.\" notice, this list of conditions and the following disclaimer. 12.\" 2. Redistributions in binary form must reproduce the above copyright 13.\" notice, this list of conditions and the following disclaimer in the 14.\" documentation and/or other materials provided with the distribution. 15.\" 3. Neither the name of the University nor the names of its contributors 16.\" may be used to endorse or promote products derived from this software 17.\" without specific prior written permission. 18.\" 19.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND 20.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 21.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 22.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 23.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 24.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 25.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 26.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 27.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 28.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 29.\" SUCH DAMAGE. 30.\" 31.\" @(#)intro.8 8.2 (Berkeley) 12/11/93 32.\" 33.Dd $Mdocdate: November 4 2015 $ 34.Dt INTRO 8 35.Os 36.Sh NAME 37.Nm intro 38.Nd introduction to system maintenance and operation commands 39.Sh DESCRIPTION 40The manual pages in section 8 contain information related to 41system operation and maintenance. 42They describe commands concerning file systems, 43such as 44.Xr edquota 8 , 45.Xr fsck 8 , 46.Xr mount 8 , 47and 48.Xr newfs 8 . 49They also cover commands concerning system backup/recovery, such as 50.Xr dump 8 51and 52.Xr restore 8 . 53.Pp 54There are pages which document the running of the system, such as 55.Xr afterboot 8 , 56.Xr ifconfig 8 , 57.Xr security 8 , 58and the configuration files located in 59.Pa /etc . 60Procedures concerning system failure are documented in 61.Xr crash 8 . 62.Pp 63Section 8 pages also describe network services and daemons. 64The rest of this page discusses some of the main daemons 65available on the 66.Ox 67system, 68and how to enable/disable them. 69.Pp 70System daemons are controlled by the script 71.Xr rc 8 , 72which is in turn configured by 73.Xr rc.conf 8 . 74For example the HTTP daemon 75.Xr httpd 8 76is controlled by the following line from 77.Xr rc.conf 8 : 78.Bd -literal -offset indent 79httpd_flags=NO 80.Ed 81.Pp 82Thus it is not started by default. 83To enable or disable daemon processes, 84administrators should edit the file 85.Xr rc.conf.local 8 86or use the rcctl(8) utility. 87The 88.Xr rc.conf.local 8 89file overrides variable assignments in 90.Xr rc.conf 8 . 91So to enable 92.Xr httpd 8 , 93the following line might be added to 94.Pa /etc/rc.conf.local : 95.Bd -literal -offset indent 96httpd_flags="-v" 97.Ed 98.Pp 99As can be seen above, 100this method is also used to specify additional options. 101.Pp 102Below is a list of some of the daemons available. 103For further information, see 104.Xr rc 8 105and the individual pages for the utilities. 106.Ss Automounter daemon (amd) 107If using the 108.Xr amd 8 109daemon, 110go into the 111.Pa /etc/amd 112directory and set it up by 113renaming 114.Pa master.sample 115to 116.Pa master 117and editing it and creating other maps as needed. 118Alternatively, you can get your maps with YP. 119.Pp 120Relevant 121.Xr rc.conf 8 122variables: 123.Va amd_flags 124and 125.Va amd_master . 126.Ss DNS server 127If you are using a name server, check the 128.Pa /etc/resolv.conf 129file. 130It may look something like: 131.Bd -literal -offset indent 132domain nts.umn.edu 133nameserver 128.101.101.101 134nameserver 134.84.84.84 135search nts.umn.edu. umn.edu. 136lookup file bind 137.Ed 138.Pp 139If using a caching name server, add the line "nameserver 127.0.0.1" first. 140.Pp 141Relevant 142.Xr rc.conf 8 143variables: 144.Va nsd_flags 145and 146.Va unbound_flags . 147.Ss Clock synchronisation 148In order to make sure the system clock is correct, 149it may be synchronised with a number of external sources. 150The utilities available are: 151.Xr ntpd 8 152and 153.Xr rdate 8 . 154.Pp 155Relevant 156.Xr rc.conf 8 157variables: 158.Va ntpd_flags . 159.Ss BOOTP/DHCP server 160If this is a 161BOOTP or DHCP 162server, edit 163.Pa /etc/dhcpd.conf 164as needed. 165See also 166.Xr diskless 8 . 167.Pp 168Relevant 169.Xr rc.conf 8 170variables: 171.Va bootparamd_flags , 172.Va dhcpd_flags , 173and 174.Va dhcrelay_flags . 175.Ss HP remote boot server 176Edit 177.Pa /etc/rbootd.conf 178if needed for remote booting. 179If you do not have HP computers doing remote booting, do not enable this. 180See also 181.Xr diskless 8 . 182.Pp 183Relevant 184.Xr rc.conf 8 185variables: 186.Va rbootd_flags . 187.Ss httpd web server (HTTP) 188On 189.Ox 190it will 191.Xr chroot 2 192to 193.Pa /var/www . 194Detailed information is available in 195.Xr httpd 8 196and 197.Xr httpd.conf 5 . 198.Pp 199Relevant 200.Xr rc.conf 8 201variables: 202.Va httpd_flags . 203.Ss NFS server 204If this is an NFS server, 205edit 206.Pa /etc/exports . 207.Pp 208Relevant 209.Xr rc.conf 8 210variables: 211.Va mountd_flags 212and 213.Va nfsd_flags . 214.Ss Relay Daemon 215A relay daemon, 216.Xr relayd 8 , 217able to run as a 218load-balancer, application layer gateway, or transparent proxy. 219.Pp 220Relevant 221.Xr rc.conf 8 222variables: 223.Va relayd_flags . 224.Ss Routing Daemons 225Various daemons for managing routing tables are available: 226.Xr bgpd 8 , 227.Xr eigrpd 8 , 228.Xr ospfd 8 , 229and 230.Xr ripd 8 . 231.Pp 232Relevant 233.Xr rc.conf 8 234variables: 235.Va bgpd_flags , 236.Va eigrpd_flags , 237.Va ospfd_flags , 238and 239.Va ripd_flags . 240.Ss RPC-based network services 241Several services depend on the RPC portmapper, 242.Xr portmap 8 , 243being running for proper operation. 244This includes YP and NFS exports, among other services. 245.Pp 246Relevant 247.Xr rc.conf 8 248variables: 249.Va portmap_flags . 250.Ss YP setup 251Check the YP domain name with the 252.Xr domainname 1 253command. 254If necessary, correct it by editing the 255.Pa /etc/defaultdomain 256file (see 257.Xr defaultdomain 5 ) . 258The 259.Pa /etc/netstart 260script reads this file on boot to determine and set the domain name. 261You may also set the running system's domain name with the 262.Xr domainname 1 263command. 264.Pp 265Relevant 266.Xr rc.conf 8 267variables: 268.Va ypbind_flags . 269.Pp 270After starting YP client services, perform the remaining YP activation 271as described in 272.Xr passwd 5 273and 274.Xr group 5 . 275.Pp 276In particular, to enable YP passwd support, you'll need to add the following 277line to 278.Pa /etc/master.passwd : 279.Pp 280.Dl +:*:::::::: 281.Pp 282You do this by using 283.Xr vipw 8 . 284.Pp 285There are many more YP man pages available to help you. 286You can find more information by starting with 287.Xr yp 8 . 288.Sh SEE ALSO 289.Xr afterboot 8 , 290.Xr rc 8 , 291.Xr rc.conf 8 , 292.Xr rcctl 8 293.Sh HISTORY 294The 295.Nm intro 296section manual page appeared in 297.Bx 4.2 . 298