Bug 439245

Summary:	man page doesn't document how to configure mingetty/c-a-d handling, etc
Product:	[Fedora] Fedora	Reporter:	Daniel Berrangé <berrange>
Component:	upstart	Assignee:	Casey Dahlin <cdahlin>
Status:	CLOSED RAWHIDE	QA Contact:	Fedora Extras Quality Assurance <extras-qa>
Severity:	low	Docs Contact:
Priority:	low
Version:	rawhide	CC:	notting, vanhoof
Target Milestone:	---	Flags:	katzj: fedora_requires_release_note?
Target Release:	---
Hardware:	All
OS:	Linux
Whiteboard:
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2008-04-05 00:49:11 UTC	Type:	---
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:
Bug Depends On:
Bug Blocks:	235706

Description Daniel Berrangé 2008-03-27 17:38:42 UTC

Description of problem:
The /etc/inittab file is no longer used by upstart. There is no documentation in
the 'init' manpage shipped with upstart which explains what configuration
file(s) replace it.

Specifically it needs to document at least

 - where/how to switch text vs graphical boot (runlevel 3 vs 5 equivalent)
 - where/how to configure mingetty spawning for text console
 - where/how to configure agetty for serial consoles
 - where/how to override the default C-A-D handling


Version-Release number of selected component (if applicable):
upstart-0.3.9-9.fc9.x86_64

How reproducible:
Always

Steps to Reproduce:
1. man init
2.
3.
  
Actual results:
No docs on how to configure the 4 points listed above

Expected results:
Documentation on configuration.

Additional info:

Comment 1 Bill Nottingham 2008-03-27 17:54:25 UTC

The problem with doing this in upstart is that everything in upstart is a
generic event; ergo, 'how to configure mingetty' is all related to how the
distribution in question sets up their upstart events; there would be no
'upstart' way to do it.

Comment 2 Daniel Berrangé 2008-03-27 18:11:54 UTC

The current man page doesn't even document what events are available, or how to
discover them, or the format of files you stuff into /etc/event.d. So there no
way for users to even make an intelligent guess at the necessary configuration
steps. Some manpage needs to document the available events for the way Fedora
deploys upstart, preferrably with examples to illustrate configs equivalent to
old style inittab settings. Either 'init' man page itself, or perhaps it just
has a reference to a separate Fedora specific man page describing events / examples.

Comment 3 Bill Nottingham 2008-04-04 15:28:02 UTC

Documented inittab added in initscripts-8.68-1.

Comment 4 Bill Nottingham 2008-04-05 00:30:45 UTC

*** Bug 435056 has been marked as a duplicate of this bug. ***

Comment 5 Bill Nottingham 2008-04-05 00:49:11 UTC

Added an 'events' manpage in -15.