Hi,
Presently it seems that the kdump/kexec documentation is scattered over several files which is not very intuitive for a user/system admin installing the kexec-tools rpm on his system.
We have presently the following documentation helpers. I propose to make the following changes to the overall documentation:
1. kexec-kdump-howto.txt and fadump-howto.txt:
Background: ---------------- Contains very descriptive information about kdump and kexec, but is normally not the first place where a user/system admin looks for information when he installs the kexec-tools.
Proposal: ------------ To deprecate these howto and move the information from here to respective man pages for kdump, kexec, kdumpctl and kdump.conf
This will avoid duplication of similar information and also ensure that the user/system admin has the right man pages at his disposal.
2. man page for kdump / kdump service:
Background: ---------------- One doesn't exist yet for kdump service. The existing one is a placeholder only.
Proposal: ------------ Add a proper man page for kdump (one lines of the man page for dracut) which links properly to man pages for kdumpctl and kdump.conf (again see man page for dracut.conf for details).
Move the relevant kdump information from kexec-kdump-howto.txt and fadump-howto.txt to here.
3. man page for kexec:
Background: ---------------- Descriptive man page exists.
Proposal: ------------ Move the relevant kexec information from kexec-kdump-howto.txt and fadump-howto.txt to here.
4. man page for kdumpctl:
Background: ---------------- Descriptive man page exists.
Proposal: ------------ Link this to man page of kdump or kdump services.
Please share your views and add any missing bits.
Regards, Bhupesh