It turned out this one needed a bit more tweaking: - a SYNOPSIS entry - one place to mention it in the DESCRIPTION - a brief hint how to create rc.firsttime (because that's indeed non-obvious)
Regarding FILES, i took oga@'s wording. While nicm@'s bikeshed is more yellow, it doesn't fit on the line. OK? Index: rc.8 =================================================================== RCS file: /cvs/src/share/man/man8/rc.8,v retrieving revision 1.25 diff -u -r1.25 rc.8 --- rc.8 31 May 2007 19:19:59 -0000 1.25 +++ rc.8 22 Sep 2010 21:55:22 -0000 @@ -37,6 +37,7 @@ .Nd command scripts for system startup .Sh SYNOPSIS .Nm /etc/rc +.Nm /etc/rc.firsttime .Nm /etc/rc.local .Nm /etc/rc.securelevel .Sh DESCRIPTION @@ -51,12 +52,13 @@ .Xr netstart 8 script, which runs commands and daemons pertaining to the network. The -.Nm rc.securelevel +.Nm rc.securelevel , +.Nm rc.firsttime and .Nm rc.local scripts hold commands which are pertinent only to a specific site. .Pp -All four of these startup scripts are (or can be) controlled to some +All five of these startup scripts are (or can be) controlled to some extent by variables defined in .Xr rc.conf 8 and @@ -125,6 +127,19 @@ .Xr securelevel 7 for the effects of setting the security level. .Pp +If +.Nm rc.firsttime +exists, it is executed once and then deleted. +Any output is mailed to root. +When writing to +.Nm rc.firsttime +at system install time using +.Pa siteXX.tgz , +append to it using the +.Pa install.site +script. +Do not replace it, since the installer may write to it, too. +.Pp .Nm rc.local is executed towards the end of .Nm rc @@ -186,21 +201,23 @@ .Xr login.conf 5 . .Sh FILES .Bl -tag -width "/etc/rc.securelevelXX" -compact -.It /etc/rc +.It Pa /etc/rc Command scripts for system startup. -.It /etc/rc.local +.It Pa /etc/rc.local Site specific command scripts for system startup. -.It /etc/rc.conf +.It Pa /etc/rc.conf System daemon configuration database. -.It /etc/rc.conf.local +.It Pa /etc/rc.conf.local Site specific daemon configuration database. -.It /etc/rc.securelevel +.It Pa /etc/rc.firsttime +Commands run on the first boot after creation. +.It Pa /etc/rc.securelevel Commands run before the security level changes. -.It /etc/rc.shutdown +.It Pa /etc/rc.shutdown Commands run at system shutdown. -.It /etc/login.conf +.It Pa /etc/login.conf Login class capability database. -.It /etc/netstart +.It Pa /etc/netstart Command script for network startup. .It Pa /fastboot Tells
