Commit Graph

54 Commits

Author SHA1 Message Date
Jesse
644ee05aab Update manual pages with markup and spacing fixes.
Added ability to use "@" symbol in command named in the inittab file. This
treats commands as literal and does not launch a shell to interpret them.

Updated inittab manual page to include overview of symbols which trigger
a shell interpretor and how to disable them using the @ symbol.
2022-02-15 17:01:41 -04:00
Jesse
f55348808d Applied new translation support from Mario Blattermann. 2022-01-27 21:39:55 -04:00
Jesse
a6e80e1133 Added new Makefile to the "man" directory. This will handle the logic
for changes, substitutions, and clean-up of the man pages.
For now install instructions are still in the "src" directory
to avoid breaking install scripts.
2021-12-27 17:50:25 -04:00
Jesse
92d4b0e74a Applied fixes for markup and spacing in manual pages.
Patch provided by Mario Blattermann.

Added translation framework (po4a) from Mario Blttermann.
2021-12-27 16:14:42 -04:00
Jesse
933ce33854 Add Q and q flags to synopsis section of shutdown manual page.
Patch provided by Helge Kreutzmann through Mark Hindley.
Closes Debian bug #1001908
2021-12-22 13:32:50 -04:00
Jesse Smith
0b695c7e0b Use readlink() instead of stat() to check processes. This shold avoid
hanging if NFS mounts are not responding.

Default to showing processes in the uninterruptable state (D).
The -z flag no longer affects whether processes in D state are shown.

The -z flag does still toggle whether zombie (Z) processes are shown.
2021-10-21 14:44:55 -03:00
Jesse Smith
2729c3f5da Fixed typos and missing underlies in shutdown manual page.
Corrections provided by Helge Kreutzmann.
2020-12-14 17:34:10 -04:00
Jesse Smith
ab53132154 Removed old original source file that was left behind by
patch action.

Fixed typos in source code, comments, manual pages, and
changelog. Corrections provided by Jens Schleusener of
FOSSIES (fossies.org).
2020-11-17 20:31:37 -04:00
Jesse Smith
b7fe11f4ab Fixed type and order of references in manual page. 2020-07-06 15:50:46 -03:00
Jesse Smith
584df5efaf Added patch from William Shipley which allows shutdown time to be specified
in the format +hh:mm. This is in addition to the existing formats such as
hh:mm, +m, and "now".

Cleared up compiler warning in dowall which can happen if the
output message is longer than the size limit on the snprintf()
buffer. This is not a bug, a the trucation works, but using a larger
buffer avoids the warning on systems with long user/host names.
2020-06-20 13:41:18 -03:00
Jesse Smith
fa124114ae Reformatted init code to make if/while logic more clear.
Cleaned up some output from readbootlog.

Added -e flg to bootlogd. When -e is used, data saved
to the boot log file does not have escape characters
removed. This means colour and cursor movement codes
stay in the log file. The may then look nicer when
read with "less -R', but may appear cluttered or
out of alignment when viewed with other, plain-text tools.
2019-08-11 22:10:45 -03:00
Jesse Smith
39df2f0fa3 Added -z command line paramter to pidof which tells pidof to
try to find processes in uninterruptable (D) or zombie (Z) states.
This can cause pidof to hang, but produces a more complete process
list.
2019-07-04 22:00:47 -03:00
Jesse Smith
df1aec8981 Accepted patch from Luc Gommans which explains why zombie and
deep sleep processes (Z and D) may be hidden from pidof
2019-05-25 15:41:57 -03:00
Jesse Smith
647ec365c6 Updated manual page for shutdown to better describe -h, -H and -P
flags.
2019-04-08 13:02:41 -03:00
Jesse Smith
f1da344565 Dropped "-f" format flag for pidof command as it
could be used to print information from memory or crash
pidof. Replaced flag with "-d" which allows for a custom
separator to be used between listed PIDs.
Patch supplied by KatolaZ.
2019-03-20 13:46:36 -03:00
Jesse Smith
4e2ad6a698 Fixed segfault in pidof when the -f (format) flag is used with
crafted format strings.
Avoid printing stack memory when special format string is passed
to -f.
Listed control characters for -f flag in manual page.
2019-03-18 18:09:24 -03:00
Jesse Smith
e19b991bb0 Add reference to fstab (5) manual page in our
fstab-decode page.
2019-03-05 11:54:10 -04:00
Jesse Smith
b5b5b268aa Updated manual description of fstab-decode 2019-03-03 17:35:22 -04:00
Jesse Smith
cf55352b97 Fixed various typos and control codes in manual pages.
Patch provided by Bjarni Ingi Gislason.
2019-03-03 17:32:28 -04:00
Jesse Smith
80e83960da Updated the fstab-decode manual page to explain what the utility does. 2019-02-21 15:09:48 -04:00
Jesse Smith
aa3b8121e1 Fixed typo in init.8 manual page. 2019-02-17 21:51:13 -04:00
Jesse Smith
3f2b4a5704 Added logsave.c and logsave.8 manual page from e2fsprogs to make
sure logsave is available to initscripts.

Updated src/Makefile to make sure bootlogd compiles with Clang.
2018-12-31 16:31:34 -04:00
Jesse Smith
5b03e0faf0 Updated shutdown manual page to try to clarify which components
of the shutdown process vs shutdown program we are referring to.
2018-11-15 13:28:35 -04:00
Jesse Smith
f064d8f4b9 Added reference to readbootlog to the bootlogd manual page. This
should allow Debian bug #725123 to be closed.
2018-11-12 20:58:44 -04:00
Jesse Smith
5d3815b0ff Added manual page and options for readbootlog. 2018-11-12 20:53:52 -04:00
Jesse Smith
aa6873b85b Removed typos from pidof manual page and killall5 page.
Closes Debian bugs #815839, #905245 and #890478

Added -f <format> option to pidof program to allow printf
style formating.
Closes Debian bug #571590
Thanks to Philipp Marek for the patch.
2018-11-10 21:27:11 -04:00
Jesse Smith
848ee05104 Updated init manual page to include GRUB in boot loader comment
as LILO is rarely used outside of the Slackware family these days.

Switched stty flags to use ECHOE instead of ECHOPRT. This should
give smoother, more natural backspac-erase behaviour on emergency
consoles. (Created in init -b mode.)
2018-11-05 23:15:11 -04:00
Jesse Smith
c45219c64f Added -q and -Q flags to shutdown command to make the "system is going down"
message appear less often. The -q flag causes messages to only appear at the
10 minute, 5 minute and x-hour intervals.
The -Q flag maintains complete silence up until the final "now" warning.
2018-11-01 17:21:47 -03:00
Jesse Smith
44fce86dde Added -l flag to "last" command. When used it allows "last" to
display usernames longer than 8 characters long.
2018-10-30 21:46:04 -03:00
Jesse Smith
a17f736a42 Applied patch from Regid Ichira to clarify shutdown command
line options. Updated manual page for shutdown.
Closes Debian bug #630661.
2018-10-27 20:37:47 -03:00
Jesse Smith
1b659c8ebe Applied patch from Daniel Povey which should allow killall5/pidof to
avoid locking up if it encounters stopped or zombie processes
due to broken NFS mount points.
This should allow Debian bug #719273 to be closed.
2018-10-27 20:26:15 -03:00
Jesse Smith
b4f8539153 Addressed man page documentation to warn the halt -i flag may
not properly shut down a network interface if it has no
valid IP address.
2018-10-22 22:19:49 -03:00
Jesse Smith
d27e34754a Unified shutdown and init to use 3 second wait between SIGTERM and
SIGKILL. Defined this value in init.h (WAIT_BETWEEN_SIGNALS) for
easy modification.
Updated documentation to address Debian bug #375274.
2018-10-22 21:44:39 -03:00
Jesse Smith
f1ca96e1c1 Added patch from Walter Harms which allows pidof to run without
displaying output. In this mode pidof simply returns true or false
without displaying PID values.

Updated manual page with new -q (quiet) mode.

Added -h flag for pidof, which was recognized before, but not used.
The -h flag now displays brief usage information for pidof.
2018-09-08 17:19:21 -03:00
Jesse Smith
6e8323e9fb The init process now writes the current runlevel to /var/run/runlevel.
This information can be read by the "runlevel" command as well as "halt"
and "reboot". Having the information logged in /var/run/runlevel as
well as the utmp file means systems without utmp (like those running
the musl C library) can still check the current runlevel. This is
useful when running halt/reboot as these programs want to check the
runlevel.

Updated the changelog, and manual pages for halt and runlevel.
2018-07-07 20:19:03 -03:00
Jesse Smith
aa80ddcc4b Updated init manual page to make "--version" flag behaviour more clear. 2018-07-01 18:51:31 -03:00
Jesse Smith
4438de4e50 Added --version flag to init and updated manual page. 2018-06-22 17:04:47 -03:00
Jesse Smith
272f112c98 Added new signal handler for SIGUSR2. When init receives SIGUSR2
it closes (and leaves closed) the named pipe /run/initctl. This
can be used to make sure init does not have any files open. However,
it also means we cannot switch run levels or bring down the system.
The pipe can be re-opened by sending init the SIGUSR1 signal.

Updated the man pages for initctl and init to include this information.
2018-04-17 19:44:50 -03:00
Jesse Smith
aee28b3292 Updated init page to reference the initctl manual page instead of
telling people to read the source code to learn how to use
the /run/initctl named pipe. Updated Makefile to install
the initctl.5 manual page.
2018-04-14 19:19:18 -03:00
Jesse Smith
01ca5252e8 Added new manual page for the initctl named pipe.
This provides information on how to send messages
to the init command.
2018-04-14 19:16:12 -03:00
Jesse Smith
9bbabbfda4 Updated manual page to include -p flag description. 2018-03-08 12:32:50 -04:00
Jesse Smith
8c8172349e Updated mountpoint to search for circular mount points when using
the -p parameter. This works around mountpoint not recognizing
circular mounts where /a/b/c/d and /a/b are the same location
(ie the same device and same inode).
Closes Savannah bug #37114.
2018-03-07 16:25:53 -04:00
Jesse Smith
efa6fefa8e Applied Debian patches to update init Makefile, halt and init documentation. 2018-02-20 19:26:09 -04:00
Jesse Smith
7817f31a4f Updated init.8 man page to include the term "reload" when the Q or q
parameter is passed.
2018-02-20 19:23:48 -04:00
Petter Reinholdtsen
959397cf9a Improve nroff formatting of init(8) manual page.
Based on patch from Bjarni Ingi Gislason in
<URL: https://bugs.debian.org/890041 >.
2018-02-11 09:20:47 +00:00
Petter Reinholdtsen
58b3b75728 Fix typo in fstab-decode(8) font escape. Patch from Bjarni Ingi
Gislason and Debian.
2014-02-07 17:44:15 +00:00
Petter Reinholdtsen
a05987e281 Document length limit for the process field in the inittab. Patch
from Johannes Truschnigg and Debian.
2014-02-07 17:41:58 +00:00
Werner Fink
bfca7da0f5 * Remove man-db tag for encoding for canonical man 2011-04-27 13:41:04 +00:00
Werner Fink
06972d9a7a Make quotes visible in example of the manual page of fstab-decode 2010-05-19 08:11:05 +00:00
Werner Fink
f69ea1f550 * Add fix for Debian bug #536574 -- Can be enabled by -DACCTON_OFF
* Add helper program fstab-decode to make it easier to handle
   /etc/mtab content. Patch by Miloslav Trmac and Fedora.
 * Add fix for Debian bug #335023 - Make sure TERM is set on FreeBSD.
 * Add fix for Debian bug #374038 - Make it clear that shutdown -c can
   only cancel a waiting shutdown, not an active one.
 * Add not to pidof manual page about the use of readlink(2). Patch by
   Bill Nottingham and Fedora.
 * Add changes for Debian bug #68621 - Add PAM support for programs spawned
   by init on the console like sulogin. Based on patch by Topi Miettinen.
2010-03-23 14:37:01 +00:00