Bug 303635

Summary:	Initscripts Documentation does not mention local.start and local.stop as options
Product:	[OLD] Docs on www.gentoo.org	Reporter:	slaughters
Component:	Installation Handbook	Assignee:	Docs Team <docs-team>
Status:	RESOLVED LATER
Severity:	normal
Priority:	High
Version:	unspecified
Hardware:	All
OS:	Linux
Whiteboard:
Package list:		Runtime testing required:	---

Description slaughters 2010-02-05 21:07:46 UTC

section 4 of the Gentoo handbook contains a section on writing init scripts which I have included below. There is no mention of the intermediate option of using local.start and local.stop as alternatives. 

I suggest the following paragraph be added after the first paragraph included below (or something similar):

[begin new verbiage]
In addition, if there is simply something to run a startup and/or shutdown, the item can be added to /etc/conf.d/local.start and/or /etc/conf.d/local.stop files. These configuration files contain instructions for their use. 
[end new verbiage]

4.d. Writing Init Scripts

Do I Have To?

No, writing an init script is usually not necessary as Gentoo provides ready-to-use init scripts for all provided services. However, you might have installed a service without using Portage, in which case you will most likely have to create an init script. 

[insert verbiage here]

Reproducible: Always

Steps to Reproduce:
1. Search for local.start and find example in a network howto but not in the handbook under initscripts.

Actual Results:  
wasted time creating an initscript to start /sbin/gradm -E

Expected Results:  
posted a message to the forums and a kind person pointed me to the local.start

Comment 1 SpanKY gentoo-dev

2010-02-16 02:50:50 UTC

local.{start,stop} are part of openrc