summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorTom Gundersen <teg@jklm.no>2011-12-31 01:40:57 +0100
committerTom Gundersen <teg@jklm.no>2011-12-31 02:09:51 +0100
commitd129fef076e6dd4ba1b12717880cfa4f4f6ef1bf (patch)
tree4b5743cc48fd3aa4066da2904306b1ae7d0b95f3
parentf26c97b536b0d4d3462cac5fac7d0aff513a4267 (diff)
man: add hostname(5)
Also fix typo in Makefile making the install of the other manpages fail. Signed-off-by: Tom Gundersen <teg@jklm.no>
-rw-r--r--.gitignore1
-rw-r--r--Makefile10
-rw-r--r--hostname.5.txt34
3 files changed, 42 insertions, 3 deletions
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.