enosys: add manpage

Signed-off-by: Thomas Weißschuh <thomas@t-8ch.de>

diff --git a/meson.build b/meson.build
index 3a535339aa074b45f6c938dee2827e37fb1d1616..9449501e18e78c5b78b1daa912460c6e05fdc352 100644 (file)
--- a/meson.build
+++ b/meson.build
@@ -2865,6 +2865,7 @@ exe = executable(
   install : true)
 if not is_disabler(exe)
   exes += exe
+  manadocs += ['misc-utils/enosys.1.adoc']
   bashcompletions += ['enosys']
 endif
 

diff --git a/misc-utils/Makemodule.am b/misc-utils/Makemodule.am
index 50fe449fe8891cec450d0dfc1c089b37f00e1200..9c558994db625b62af0913183d811adb5f422c26 100644 (file)
--- a/misc-utils/Makemodule.am
+++ b/misc-utils/Makemodule.am
@@ -300,6 +300,8 @@ endif
 
 if BUILD_ENOSYS
 usrbin_exec_PROGRAMS += enosys
+MANPAGES += misc-utils/enosys.1
+dist_noinst_DATA += misc-utils/enosys.1.adoc
 enosys_SOURCES = misc-utils/enosys.c
 enosys_LDADD = $(LDADD) libcommon.la
 enosys_CFLAGS = $(AM_CFLAGS)

diff --git a/misc-utils/enosys.1.adoc b/misc-utils/enosys.1.adoc
new file mode 100644 (file)
index 0000000..189f148
--- /dev/null
+++ b/misc-utils/enosys.1.adoc
@@ -0,0 +1,57 @@
+//po4a: entry man manual
+= enosys(1)
+:doctype: manpage
+:man manual: User Commands
+:man source: util-linux {release-version}
+:page-layout: base
+:command: enosys
+
+== NAME
+
+enosys - utility make syscalls fail with ENOSYS
+
+== SYNOPSIS
+
+*enosys* [*--syscall*|*-s* _syscall_] command
+
+== DESCRIPTION
+
+*enosys* is a simple command to execute a child process for which certain
+syscalls fail with errno ENOSYS.
+
+It can be used to test the behavior of applications in the face of missing
+syscalls as would happen when running on old kernels.
+
+== OPTIONS
+
+*-s*, *--syscall*::
+Syscall to block. Can be specified multiple times.
+
+include::man-common/help-version.adoc[]
+
+== EXIT STATUS
+
+*enosys* exits with the status code of the executed process.
+The following values have special meanings:
+
+*1*::
+internal error
+
+*2*::
+system does not provide the necessary functionality
+
+== AUTHORS
+
+mailto:thomas@t-8ch.de[Thomas Weißschuh]
+
+== SEE ALSO
+
+*syscall*(2)
+
+include::man-common/bugreports.adoc[]
+
+include::man-common/footer.adoc[]
+
+ifdef::translation[]
+include::man-common/translation.adoc[]
+endif::[]