From 1cb64d264cb92d55cfa2b6d3ea5ebc1adca7444f Mon Sep 17 00:00:00 2001

From: =?UTF-8?q?Nikola=20Forr=C3=B3?= <nforro@redhat.com>

Date: Fri, 27 Jul 2018 17:27:24 +0200

Subject: [PATCH 5/5] remove syscalls deprecated on aarch64

---

 man2/_sysctl.2      |   1 -

 man2/access.2       |   5 +

 man2/alarm.2        | 105 --------------

 man2/bdflush.2      | 133 -----------------

 man2/chmod.2        |   5 +

 man2/chown.2        |   7 +

 man2/clone.2        |  21 +++

 man2/dup.2          |   7 +

 man2/epoll_create.2 |   5 +

 man2/epoll_wait.2   |   5 +

 man2/eventfd.2      |   5 +

 man2/fork.2         | 337 ------------------------------------------

 man2/futimesat.2    | 142 ------------------

 man2/getdents.2     |   7 +

 man2/inotify_init.2 |   5 +

 man2/link.2         |   5 +

 man2/mkdir.2        |   5 +

 man2/mknod.2        |   5 +

 man2/open.2         |   7 +

 man2/pause.2        |  72 ---------

 man2/pipe.2         |   5 +

 man2/poll.2         |   5 +

 man2/readlink.2     |   5 +

 man2/recv.2         |   7 +

 man2/rename.2       |   5 +

 man2/rmdir.2        | 150 -------------------

 man2/select.2       |   5 +

 man2/send.2         |   7 +

 man2/setpgid.2      |   5 +

 man2/signalfd.2     |   5 +

 man2/symlink.2      |   5 +

 man2/sysctl.2       | 190 ------------------------

 man2/time.2         | 140 ------------------

 man2/umount.2       |   5 +

 man2/unlink.2       |   5 +

 man2/uselib.2       | 138 ------------------

 man2/ustat.2        | 127 ----------------

 man2/utime.2        |   9 +-

 man2/vfork.2        | 346 --------------------------------------------

 man2/wait4.2        |   7 +

 40 files changed, 171 insertions(+), 1884 deletions(-)

 delete mode 100644 man2/_sysctl.2

 delete mode 100644 man2/alarm.2

 delete mode 100644 man2/bdflush.2

 delete mode 100644 man2/fork.2

 delete mode 100644 man2/futimesat.2

 delete mode 100644 man2/pause.2

 delete mode 100644 man2/rmdir.2

 delete mode 100644 man2/sysctl.2

 delete mode 100644 man2/time.2

 delete mode 100644 man2/uselib.2

 delete mode 100644 man2/ustat.2

 delete mode 100644 man2/vfork.2

diff --git a/man2/_sysctl.2 b/man2/_sysctl.2

deleted file mode 100644

index 9e14d4b..0000000

--- a/man2/_sysctl.2

+++ /dev/null

@@ -1 +0,0 @@

-.so man2/sysctl.2

diff --git a/man2/access.2 b/man2/access.2

index 2d194b5..9d8f444 100644

--- a/man2/access.2

+++ b/man2/access.2

@@ -76,6 +76,11 @@ _ATFILE_SOURCE

 .PD

 .SH DESCRIPTION

 .BR access ()

+system call is DEPRECATED, use

+.BR faccessat ()

+instead!!!

+.PP

+.BR access ()

 checks whether the calling process can access the file

 .IR pathname .

 If

diff --git a/man2/alarm.2 b/man2/alarm.2

deleted file mode 100644

index 43d7664..0000000

--- a/man2/alarm.2

+++ /dev/null

@@ -1,105 +0,0 @@

-.\" This manpage is Copyright (C) 1992 Drew Eckhardt;

-.\"             and Copyright (C) 1993 Michael Haardt, Ian Jackson.

-.\"

-.\" %%%LICENSE_START(VERBATIM)

-.\" Permission is granted to make and distribute verbatim copies of this

-.\" manual provided the copyright notice and this permission notice are

-.\" preserved on all copies.

-.\"

-.\" Permission is granted to copy and distribute modified versions of this

-.\" manual under the conditions for verbatim copying, provided that the

-.\" entire resulting derived work is distributed under the terms of a

-.\" permission notice identical to this one.

-.\"

-.\" Since the Linux kernel and libraries are constantly changing, this

-.\" manual page may be incorrect or out-of-date.  The author(s) assume no

-.\" responsibility for errors or omissions, or for damages resulting from

-.\" the use of the information contained herein.  The author(s) may not

-.\" have taken the same level of care in the production of this manual,

-.\" which is licensed free of charge, as they might when working

-.\" professionally.

-.\"

-.\" Formatted or processed versions of this manual, if unaccompanied by

-.\" the source, must acknowledge the copyright and authors of this work.

-.\" %%%LICENSE_END

-.\"

-.\" Modified Wed Jul 21 19:42:57 1993 by Rik Faith <faith@cs.unc.edu>

-.\" Modified Sun Jul 21 21:25:26 1996 by Andries Brouwer <aeb@cwi.nl>

-.\" Modified Wed Nov  6 03:46:05 1996 by Eric S. Raymond <esr@thyrsus.com>

-.\"

-.TH ALARM 2 2017-05-03 "Linux" "Linux Programmer's Manual"

-.SH NAME

-alarm \- set an alarm clock for delivery of a signal

-.SH SYNOPSIS

-.nf

-.B #include <unistd.h>

-.PP

-.BI "unsigned int alarm(unsigned int " seconds );

-.fi

-.SH DESCRIPTION

-.BR alarm ()

-arranges for a

-.B SIGALRM

-signal to be delivered to the calling process in

-.I seconds

-seconds.

-.PP

-If

-.I seconds

-is zero, any pending alarm is canceled.

-.PP

-In any event any previously set

-.BR alarm ()

-is canceled.

-.SH RETURN VALUE

-.BR alarm ()

-returns the number of seconds remaining until any previously scheduled

-alarm was due to be delivered, or zero if there was no previously

-scheduled alarm.

-.SH CONFORMING TO

-POSIX.1-2001, POSIX.1-2008, SVr4, 4.3BSD.

-.SH NOTES

-.BR alarm ()

-and

-.BR setitimer (2)

-share the same timer; calls to one will interfere with use of the

-other.

-.PP

-Alarms created by

-.BR alarm ()

-are preserved across

-.BR execve (2)

-and are not inherited by children created via

-.BR fork (2).

-.PP

-.BR sleep (3)

-may be implemented using

-.BR SIGALRM ;

-mixing calls to

-.BR alarm ()

-and

-.BR sleep (3)

-is a bad idea.

-.PP

-Scheduling delays can, as ever, cause the execution of the process to

-be delayed by an arbitrary amount of time.

-.SH SEE ALSO

-.BR gettimeofday (2),

-.BR pause (2),

-.BR select (2),

-.BR setitimer (2),

-.BR sigaction (2),

-.BR signal (2),

-.BR timer_create (2),

-.BR timerfd_create (2),

-.BR sleep (3),

-.BR time (7)

-.SH COLOPHON

-This page is part of release 4.15 of the Linux

-.I man-pages

-project.

-A description of the project,

-information about reporting bugs,

-and the latest version of this page,

-can be found at

-\%https://www.kernel.org/doc/man\-pages/.

diff --git a/man2/bdflush.2 b/man2/bdflush.2

deleted file mode 100644

index ac0df3e..0000000

--- a/man2/bdflush.2

+++ /dev/null

@@ -1,133 +0,0 @@

-.\" Copyright (c) 1995 Michael Chastain (mec@shell.portal.com), 15 April 1995.

-.\"

-.\" %%%LICENSE_START(GPLv2+_DOC_FULL)

-.\" This is free documentation; you can redistribute it and/or

-.\" modify it under the terms of the GNU General Public License as

-.\" published by the Free Software Foundation; either version 2 of

-.\" the License, or (at your option) any later version.

-.\"

-.\" The GNU General Public License's references to "object code"

-.\" and "executables" are to be interpreted as the output of any

-.\" document formatting or typesetting system, including

-.\" intermediate and printed output.

-.\"

-.\" This manual is distributed in the hope that it will be useful,

-.\" but WITHOUT ANY WARRANTY; without even the implied warranty of

-.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

-.\" GNU General Public License for more details.

-.\"

-.\" You should have received a copy of the GNU General Public

-.\" License along with this manual; if not, see

-.\" <http://www.gnu.org/licenses/>.

-.\" %%%LICENSE_END

-.\"

-.\" Modified 1997-01-31 by Eric S. Raymond <esr@thyrsus.com>

-.\" Modified 2004-06-17 by Michael Kerrisk <mtk.manpages@gmail.com>

-.\"

-.TH BDFLUSH 2 2016-10-08 "Linux" "Linux Programmer's Manual"

-.SH NAME

-bdflush \- start, flush, or tune buffer-dirty-flush daemon

-.SH SYNOPSIS

-.nf

-.B #include <sys/kdaemon.h>

-.PP

-.BI "int bdflush(int "  func ", long *" address );

-.BI "int bdflush(int "  func ", long " data );

-.fi

-.SH DESCRIPTION

-.IR Note :

-Since Linux 2.6,

-.\" As noted in a changes in the 2.5.12 source

-this system call is deprecated and does nothing.

-It is likely to disappear altogether in a future kernel release.

-Nowadays, the task performed by

-.BR bdflush ()

-is handled by the kernel

-.I pdflush

-thread.

-.PP

-.BR bdflush ()

-starts, flushes, or tunes the buffer-dirty-flush daemon.

-Only a privileged process (one with the

-.B CAP_SYS_ADMIN

-capability) may call

-.BR bdflush ().

-.PP

-If

-.I func

-is negative or 0, and no daemon has been started, then

-.BR bdflush ()

-enters the daemon code and never returns.

-.PP

-If

-.I func

-is 1,

-some dirty buffers are written to disk.

-.PP

-If

-.I func

-is 2 or more and is even (low bit is 0), then

-.I address

-is the address of a long word,

-and the tuning parameter numbered

-.RI "(" "func" "\-2)/2"

-is returned to the caller in that address.

-.PP

-If

-.I func

-is 3 or more and is odd (low bit is 1), then

-.I data

-is a long word,

-and the kernel sets tuning parameter numbered

-.RI "(" "func" "\-3)/2"

-to that value.

-.PP

-The set of parameters, their values, and their valid ranges

-are defined in the Linux kernel source file

-.IR fs/buffer.c .

-.SH RETURN VALUE

-If

-.I func

-is negative or 0 and the daemon successfully starts,

-.BR bdflush ()

-never returns.

-Otherwise, the return value is 0 on success and \-1 on failure, with

-.I errno

-set to indicate the error.

-.SH ERRORS

-.TP

-.B EBUSY

-An attempt was made to enter the daemon code after

-another process has already entered.

-.TP

-.B EFAULT

-.I address

-points outside your accessible address space.

-.TP

-.B EINVAL

-An attempt was made to read or write an invalid parameter number,

-or to write an invalid value to a parameter.

-.TP

-.B EPERM

-Caller does not have the

-.B CAP_SYS_ADMIN

-capability.

-.SH VERSIONS

-Since version 2.23, glibc no longer supports this obsolete system call.

-.SH CONFORMING TO

-.BR bdflush ()

-is Linux-specific and should not be used in programs

-intended to be portable.

-.SH SEE ALSO

-.BR sync (1),

-.BR fsync (2),

-.BR sync (2)

-.SH COLOPHON

-This page is part of release 4.15 of the Linux

-.I man-pages

-project.

-A description of the project,

-information about reporting bugs,

-and the latest version of this page,

-can be found at

-\%https://www.kernel.org/doc/man\-pages/.

diff --git a/man2/chmod.2 b/man2/chmod.2

index 5c55553..9637954 100644

--- a/man2/chmod.2

+++ b/man2/chmod.2

@@ -91,6 +91,11 @@ _ATFILE_SOURCE

 .PD

 .ad

 .SH DESCRIPTION

+.BR chmod ()

+system call is DEPRECATED, use

+.BR fchmodat ()

+instead!!!

+.PP

 The

 .BR chmod ()

 and

diff --git a/man2/chown.2 b/man2/chown.2

index ef358e0..b917e5c 100644

--- a/man2/chown.2

+++ b/man2/chown.2

@@ -83,6 +83,13 @@ _ATFILE_SOURCE

 .ad

 .PD

 .SH DESCRIPTION

+.BR chown ()

+and

+.BR lchown ()

+system calls are DEPRECATED, use

+.BR fchownat ()

+instead!!!

+.PP

 These system calls change the owner and group of a file.

 The

 .BR chown (),

diff --git a/man2/clone.2 b/man2/clone.2

index 20ead6d..62bb4e6 100644

--- a/man2/clone.2

+++ b/man2/clone.2

@@ -1206,6 +1206,27 @@ On i386,

 .BR clone ()

 should not be called through vsyscall, but directly through

 .IR "int $0x80" .

+

+.BR clone()

+replaces

+.BR fork (2)

+and

+.BR vfork (2)

+system calls.

+A call to

+.BR fork (2)

+is equivalent to a call to

+.BR clone ()

+specifying

+.I flags

+as just SIGCHLD.

+A call to

+.BR vfork (2)

+is equivalent to calling

+.BR clone ()

+with

+.I flags

+specified as: CLONE_VM | CLONE_VFORK | SIGCHLD.

 .SH BUGS

 GNU C library versions 2.3.4 up to and including 2.24

 contained a wrapper function for

diff --git a/man2/dup.2 b/man2/dup.2

index 1829b5e..6782677 100644

--- a/man2/dup.2

+++ b/man2/dup.2

@@ -51,6 +51,13 @@ dup, dup2, dup3 \- duplicate a file descriptor

 .BI "int dup3(int " oldfd ", int " newfd ", int " flags );

 .fi

 .SH DESCRIPTION

+.BR dup2 ()

+system call is DEPRECATED, use

+.BR dup3 ()

+with

+.I flags

+set to 0 instead!!!

+.PP

 The

 .BR dup ()

 system call creates a copy of the file descriptor

diff --git a/man2/epoll_create.2 b/man2/epoll_create.2

index 2bc253d..64143d6 100644

--- a/man2/epoll_create.2

+++ b/man2/epoll_create.2

@@ -33,6 +33,11 @@ epoll_create, epoll_create1 \- open an epoll file descriptor

 .fi

 .SH DESCRIPTION

 .BR epoll_create ()

+system call is DEPRECATED, use

+.BR epoll_create1 ()

+instead!!!

+.PP

+.BR epoll_create ()

 creates a new

 .BR epoll (7)

 instance.

diff --git a/man2/epoll_wait.2 b/man2/epoll_wait.2

index 5edf20e..c3793ef 100644

--- a/man2/epoll_wait.2

+++ b/man2/epoll_wait.2

@@ -33,6 +33,11 @@ epoll_wait, epoll_pwait \- wait for an I/O event on an epoll file descriptor

 .BI "               const sigset_t *" sigmask );

 .fi

 .SH DESCRIPTION

+.BR epoll_wait ()

+system call is DEPRECATED, use

+.BR epoll_pwait ()

+instead!!!

+.PP

 The

 .BR epoll_wait ()

 system call waits for events on the

diff --git a/man2/eventfd.2 b/man2/eventfd.2

index de2461f..0d06430 100644

--- a/man2/eventfd.2

+++ b/man2/eventfd.2

@@ -28,6 +28,11 @@ eventfd \- create a file descriptor for event notification

 .BI "int eventfd(unsigned int " initval ", int " flags );

 .SH DESCRIPTION

 .BR eventfd ()

+system call is DEPRECATED, use

+.BR eventfd2 ()

+instead!!!

+.PP

+.BR eventfd ()

 creates an "eventfd object" that can be used as

 an event wait/notify mechanism by user-space applications,

 and by the kernel to notify user-space applications of events.

diff --git a/man2/fork.2 b/man2/fork.2

deleted file mode 100644

index c217a3a..0000000

--- a/man2/fork.2

+++ /dev/null

@@ -1,337 +0,0 @@

-.\" Copyright (C) 2006 Michael Kerrisk <mtk.manpages@gmail.com>

-.\" A few fragments remain from an earlier (1992) page by

-.\" Drew Eckhardt (drew@cs.colorado.edu),

-.\"

-.\" %%%LICENSE_START(VERBATIM)

-.\" Permission is granted to make and distribute verbatim copies of this

-.\" manual provided the copyright notice and this permission notice are

-.\" preserved on all copies.

-.\"

-.\" Permission is granted to copy and distribute modified versions of this

-.\" manual under the conditions for verbatim copying, provided that the

-.\" entire resulting derived work is distributed under the terms of a

-.\" permission notice identical to this one.

-.\"

-.\" Since the Linux kernel and libraries are constantly changing, this

-.\" manual page may be incorrect or out-of-date.  The author(s) assume no

-.\" responsibility for errors or omissions, or for damages resulting from

-.\" the use of the information contained herein.  The author(s) may not

-.\" have taken the same level of care in the production of this manual,

-.\" which is licensed free of charge, as they might when working

-.\" professionally.

-.\"

-.\" Formatted or processed versions of this manual, if unaccompanied by

-.\" the source, must acknowledge the copyright and authors of this work.

-.\" %%%LICENSE_END

-.\"

-.\" Modified by Michael Haardt (michael@moria.de)

-.\" Modified Sat Jul 24 13:22:07 1993 by Rik Faith (faith@cs.unc.edu)

-.\" Modified 21 Aug 1994 by Michael Chastain (mec@shell.portal.com):

-.\"   Referenced 'clone(2)'.

-.\" Modified 1995-06-10, 1996-04-18, 1999-11-01, 2000-12-24

-.\"   by Andries Brouwer (aeb@cwi.nl)

-.\" Modified, 27 May 2004, Michael Kerrisk <mtk.manpages@gmail.com>

-.\"     Added notes on capability requirements

-.\" 2006-09-04, Michael Kerrisk

-.\"     Greatly expanded, to describe all attributes that differ

-.\"	parent and child.

-.\"

-.TH FORK 2 2017-09-15 "Linux" "Linux Programmer's Manual"

-.SH NAME

-fork \- create a child process

-.SH SYNOPSIS

-.B #include <sys/types.h>

-.br

-.B #include <unistd.h>

-.PP

-.B pid_t fork(void);

-.SH DESCRIPTION

-.BR fork ()

-creates a new process by duplicating the calling process.

-The new process is referred to as the

-.I child

-process.

-The calling process is referred to as the

-.I parent

-process.

-.PP

-The child process and the parent process run in separate memory spaces.

-At the time of

-.BR fork ()

-both memory spaces have the same content.

-Memory writes, file mappings

-.RB ( mmap (2)),

-and unmappings

-.RB ( munmap (2))

-performed by one of the processes do not affect the other.

-.PP

-The child process is an exact duplicate of the parent

-process except for the following points:

-.IP * 3

-The child has its own unique process ID,

-and this PID does not match the ID of any existing process group

-.RB ( setpgid (2))

-or session.

-.IP *

-The child's parent process ID is the same as the parent's process ID.

-.IP *

-The child does not inherit its parent's memory locks

-.RB ( mlock (2),

-.BR mlockall (2)).

-.IP *

-Process resource utilizations

-.RB ( getrusage (2))

-and CPU time counters

-.RB ( times (2))

-are reset to zero in the child.

-.IP *

-The child's set of pending signals is initially empty

-.RB ( sigpending (2)).

-.IP *

-The child does not inherit semaphore adjustments from its parent

-.RB ( semop (2)).

-.IP *

-The child does not inherit process-associated record locks from its parent

-.RB ( fcntl (2)).

-(On the other hand, it does inherit

-.BR fcntl (2)

-open file description locks and

-.BR flock (2)

-locks from its parent.)

-.IP *

-The child does not inherit timers from its parent

-.RB ( setitimer (2),

-.BR alarm (2),

-.BR timer_create (2)).

-.IP *

-The child does not inherit outstanding asynchronous I/O operations

-from its parent

-.RB ( aio_read (3),

-.BR aio_write (3)),

-nor does it inherit any asynchronous I/O contexts from its parent (see

-.BR io_setup (2)).

-.PP

-The process attributes in the preceding list are all specified

-in POSIX.1.

-The parent and child also differ with respect to the following

-Linux-specific process attributes:

-.IP * 3

-The child does not inherit directory change notifications (dnotify)

-from its parent

-(see the description of

-.B F_NOTIFY

-in

-.BR fcntl (2)).

-.IP *

-The

-.BR prctl (2)

-.B PR_SET_PDEATHSIG

-setting is reset so that the child does not receive a signal

-when its parent terminates.

-.IP *

-The default timer slack value is set to the parent's

-current timer slack value.

-See the description of

-.BR PR_SET_TIMERSLACK

-in

-.BR prctl (2).

-.IP *

-Memory mappings that have been marked with the

-.BR madvise (2)

-.B MADV_DONTFORK

-flag are not inherited across a

-.BR fork ().

-.IP *

-Memory in address ranges that have been marked with the

-.BR madvise (2)

-.B MADV_WIPEONFORK

-flag is zeroed in the child after a

-.BR fork ().

-(The

-.B MADV_WIPEONFORK

-setting remains in place for those address ranges in the child.)

-.IP *

-The termination signal of the child is always

-.B SIGCHLD

-(see

-.BR clone (2)).

-.IP *

-The port access permission bits set by

-.BR ioperm (2)

-are not inherited by the child;

-the child must turn on any bits that it requires using

-.BR ioperm (2).

-.PP

-Note the following further points:

-.IP * 3

-The child process is created with a single thread\(emthe

-one that called

-.BR fork ().

-The entire virtual address space of the parent is replicated in the child,

-including the states of mutexes, condition variables,

-and other pthreads objects; the use of

-.BR pthread_atfork (3)

-may be helpful for dealing with problems that this can cause.

-.IP *

-After a

-.BR fork ()

-in a multithreaded program,

-the child can safely call only async-signal-safe functions (see

-.BR signal-safety (7))

-until such time as it calls

-.BR execve (2).

-.IP *

-The child inherits copies of the parent's set of open file descriptors.

-Each file descriptor in the child refers to the same

-open file description (see

-.BR open (2))

-as the corresponding file descriptor in the parent.

-This means that the two file descriptors share open file status flags,

-file offset,

-and signal-driven I/O attributes (see the description of

-.B F_SETOWN

-and

-.B F_SETSIG

-in

-.BR fcntl (2)).

-.IP *

-The child inherits copies of the parent's set of open message

-queue descriptors (see

-.BR mq_overview (7)).

-Each file descriptor in the child refers to the same

-open message queue description

-as the corresponding file descriptor in the parent.

-This means that the two file descriptors share the same flags

-.RI ( mq_flags ).

-.IP *

-The child inherits copies of the parent's set of open directory streams (see

-.BR opendir (3)).

-POSIX.1 says that the corresponding directory streams

-in the parent and child

-.I may

-share the directory stream positioning;

-on Linux/glibc they do not.

-.SH RETURN VALUE

-On success, the PID of the child process is returned in the parent,

-and 0 is returned in the child.

-On failure, \-1 is returned in the parent,

-no child process is created, and

-.I errno

-is set appropriately.

-.SH ERRORS

-.TP

-.B EAGAIN

-.\" NOTE! The following should match the description in pthread_create(3)

-A system-imposed limit on the number of threads was encountered.

-There are a number of limits that may trigger this error:

-.RS

-.IP * 3

-the

-.BR RLIMIT_NPROC

-soft resource limit (set via

-.BR setrlimit (2)),

-which limits the number of processes and threads for a real user ID,

-was reached;

-.IP *

-the kernel's system-wide limit on the number of processes and threads,

-.IR /proc/sys/kernel/threads-max ,

-was reached (see

-.BR proc (5));

-.IP *

-the maximum number of PIDs,

-.IR /proc/sys/kernel/pid_max ,

-was reached (see

-.BR proc (5));

-or

-.IP *

-the PID limit

-.RI ( pids.max )

-imposed by the cgroup "process number" (PIDs) controller was reached.

-.RE

-.TP

-.B EAGAIN

-The caller is operating under the

-.BR SCHED_DEADLINE

-scheduling policy and does not have the reset-on-fork flag set.

-See

-.BR sched (7).

-.TP

-.B ENOMEM

-.BR fork ()

-failed to allocate the necessary kernel structures because memory is tight.

-.TP

-.B ENOMEM

-An attempt was made to create a child process in a PID namespace

-whose "init" process has terminated.

-See

-.BR pid_namespaces (7).

-.TP

-.B ENOSYS

-.BR fork ()

-is not supported on this platform (for example,

-.\" e.g., arm (optionally), blackfin, c6x, frv, h8300, microblaze, xtensa

-hardware without a Memory-Management Unit).

-.TP

-.BR ERESTARTNOINTR " (since Linux 2.6.17)"

-.\" commit 4a2c7a7837da1b91468e50426066d988050e4d56

-System call was interrupted by a signal and will be restarted.

-(This can be seen only during a trace.)

-.SH CONFORMING TO

-POSIX.1-2001, POSIX.1-2008, SVr4, 4.3BSD.

-.SH NOTES

-.PP

-Under Linux,

-.BR fork ()

-is implemented using copy-on-write pages, so the only penalty that it incurs

-is the time and memory required to duplicate the parent's page tables,

-and to create a unique task structure for the child.

-.SS C library/kernel differences

-Since version 2.3.3,

-.\" nptl/sysdeps/unix/sysv/linux/fork.c

-rather than invoking the kernel's

-.BR fork ()

-system call,

-the glibc

-.BR fork ()

-wrapper that is provided as part of the

-NPTL threading implementation invokes

-.BR clone (2)

-with flags that provide the same effect as the traditional system call.

-(A call to

-.BR fork ()

-is equivalent to a call to

-.BR clone (2)

-specifying

-.I flags

-as just

-.BR SIGCHLD .)

-The glibc wrapper invokes any fork handlers that have been

-established using

-.BR pthread_atfork (3).

-.\" and does some magic to ensure that getpid(2) returns the right value.

-.SH EXAMPLE

-See

-.BR pipe (2)

-and

-.BR wait (2).

-.SH SEE ALSO

-.BR clone (2),

-.BR execve (2),

-.BR exit (2),

-.BR setrlimit (2),

-.BR unshare (2),

-.BR vfork (2),

-.BR wait (2),

-.BR daemon (3),

-.BR pthread_atfork (3),

-.BR capabilities (7),

-.BR credentials (7)

-.SH COLOPHON

-This page is part of release 4.15 of the Linux

-.I man-pages

-project.

-A description of the project,

-information about reporting bugs,

-and the latest version of this page,

-can be found at

-\%https://www.kernel.org/doc/man\-pages/.

diff --git a/man2/futimesat.2 b/man2/futimesat.2

deleted file mode 100644

index 8991c98..0000000

--- a/man2/futimesat.2

+++ /dev/null

@@ -1,142 +0,0 @@

-.\" This manpage is Copyright (C) 2006, Michael Kerrisk

-.\"

-.\" %%%LICENSE_START(VERBATIM)

-.\" Permission is granted to make and distribute verbatim copies of this

-.\" manual provided the copyright notice and this permission notice are

-.\" preserved on all copies.

-.\"

-.\" Permission is granted to copy and distribute modified versions of this

-.\" manual under the conditions for verbatim copying, provided that the

-.\" entire resulting derived work is distributed under the terms of a

-.\" permission notice identical to this one.

-.\"

-.\" Since the Linux kernel and libraries are constantly changing, this

-.\" manual page may be incorrect or out-of-date.  The author(s) assume no

-.\" responsibility for errors or omissions, or for damages resulting from

-.\" the use of the information contained herein.  The author(s) may not

-.\" have taken the same level of care in the production of this manual,

-.\" which is licensed free of charge, as they might when working

-.\" professionally.

-.\"

-.\" Formatted or processed versions of this manual, if unaccompanied by

-.\" the source, must acknowledge the copyright and authors of this work.

-.\" %%%LICENSE_END

-.\"

-.TH FUTIMESAT 2 2017-09-15 "Linux" "Linux Programmer's Manual"

-.SH NAME

-futimesat \- change timestamps of a file relative to a \

-directory file descriptor

-.SH SYNOPSIS

-.nf

-.B #include <fcntl.h>           /* Definition of AT_* constants */

-.B #include <sys/time.h>

-.PP

-.BI "int futimesat(int " dirfd ", const char *" pathname ,

-.BI "              const struct timeval " times [2]);

-.fi

-.PP

-.in -4n

-Feature Test Macro Requirements for glibc (see

-.BR feature_test_macros (7)):

-.in

-.PP

-.BR futimesat ():

-_GNU_SOURCE

-.SH DESCRIPTION

-This system call is obsolete.

-Use

-.BR utimensat (2)

-instead.

-.PP

-The

-.BR futimesat ()

-system call operates in exactly the same way as

-.BR utimes (2),

-except for the differences described in this manual page.

-.PP

-If the pathname given in

-.I pathname

-is relative, then it is interpreted relative to the directory

-referred to by the file descriptor

-.I dirfd

-(rather than relative to the current working directory of

-the calling process, as is done by

-.BR utimes (2)

-for a relative pathname).

-.PP