From d129fef076e6dd4ba1b12717880cfa4f4f6ef1bf Mon Sep 17 00:00:00 2001 From: Tom Gundersen Date: Sat, 31 Dec 2011 01:40:57 +0100 Subject: man: add hostname(5) Also fix typo in Makefile making the install of the other manpages fail. Signed-off-by: Tom Gundersen --- .gitignore | 1 + Makefile | 10 +++++++--- hostname.5.txt | 34 ++++++++++++++++++++++++++++++++++ 3 files changed, 42 insertions(+), 3 deletions(-) create mode 100644 hostname.5.txt diff --git a/.gitignore b/.gitignore index 7b4ecc9..e365ecb 100644 --- a/.gitignore +++ b/.gitignore @@ -1,5 +1,6 @@ tags *.tar.xz* +hostname.5 locale.conf.5 vconsole.conf.5 rc.conf.5 diff --git a/Makefile b/Makefile index 4570a54..3e83e58 100644 --- a/Makefile +++ b/Makefile @@ -13,6 +13,7 @@ DIRS := \ /usr/lib/initscripts \ /etc/bash_completion.d \ /usr/share/zsh/site-functions \ + /usr/share/man/man5 \ /usr/share/man/man8 all: doc @@ -29,7 +30,7 @@ install: installdirs doc install -m755 -t $(DESTDIR)/etc/profile.d locale.sh install -m755 -t $(DESTDIR)/usr/sbin rc.d install -m644 -t ${DESTDIR}/usr/share/man/man8 rc.d.8 - install -m644 -t ${DESTDIR}/usr/share/man/man5 rc.conf.5 locale.conf vconsole.conf + install -m644 -t ${DESTDIR}/usr/share/man/man5 rc.conf.5 locale.conf.5 vconsole.conf.5 hostname.5 install -m755 -t $(DESTDIR)/usr/lib/initscripts arch-tmpfiles arch-sysctl install -m644 tmpfiles.conf $(DESTDIR)/usr/lib/tmpfiles.d/arch.conf install -m644 -T bash-completion $(DESTDIR)/etc/bash_completion.d/rc.d @@ -47,10 +48,13 @@ locale.conf.5: locale.conf.5.txt vconsole.conf.5: vconsole.conf.5.txt a2x -d manpage -f manpage vconsole.conf.5.txt -doc: rc.d.8 rc.conf.5 locale.conf.5 vconsole.conf.5 +hostname.5: hostname.5.txt + a2x -d manpage -f manpage hostname.5.txt + +doc: rc.d.8 rc.conf.5 locale.conf.5 vconsole.conf.5 hostname.5 clean: - rm -f rc.d.8 rc.conf.5 locale.conf.5 vconsole.conf.5 + rm -f rc.d.8 rc.conf.5 locale.conf.5 vconsole.conf.5 hostname.5 tar: git archive HEAD --prefix=initscripts-$(VER)/ | xz > initscripts-$(VER).tar.xz diff --git a/hostname.5.txt b/hostname.5.txt new file mode 100644 index 0000000..f141768 --- /dev/null +++ b/hostname.5.txt @@ -0,0 +1,34 @@ +///// +vim:set ts=4 sw=4 syntax=asciidoc noet: +///// +hostname(5) +=========== + +NAME +---- +hostname - Local host name configuration file + +SYNOPSIS +-------- +*/etc/hostname* + +DESCRIPTION +----------- +The /etc/hostname file configures the name of the local system that is set during boot. It +should contain a single newline-terminated host name string. The host name may be a free-form string up to 64 characters in length, +however it is recommended that it consists only of 7bit ASCII lower-case characters and no spaces or dots, and limits itself to the +format allowed for DNS domain name labels, even though this is not a strict requirement. + +In Arch Linux the HOSTNAME variable in /etc/rc.conf is checked for the host name as well, however only as fallback. + +HISTORY +------- +The simple configuration file format of /etc/hostname originates from Debian GNU/Linux. + +SEE ALSO +-------- +systemd.hostname(5), hostname(1), hostname(7), rc.conf(5) + +AUTHORS +------- +Original by Lennart Poettering, adapted to Arch Linux by Tom Gundersen. -- cgit v1.2.3