From: Thomas Weißschuh <thomas@t-8ch.de>
Date: Thu, 4 May 2023 18:31:32 +0000 (+0200)
Subject: enosys: add manpage
X-Git-Tag: v2.40-rc1~466^2~6
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=ae03abcf56766c1b45762d17558e59788d252bcc;p=thirdparty%2Futil-linux.git

enosys: add manpage

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

diff --git a/meson.build b/meson.build
index 3a535339aa..9449501e18 100644
--- 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 50fe449fe8..9c558994db 100644
--- 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
index 0000000000..189f1488af
--- /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::[]