From: "Alejandro Colomar (man-pages)" <alx.manpages@gmail.com>
To: Samanta Navarro <ferivoz@riseup.net>
Cc: "G. Branden Robinson" <g.branden.robinson@gmail.com>,
linux-man@vger.kernel.org, mtk.manpages@gmail.com
Subject: Re: [patch] pthread_cancel.3, pthread_cleanup_push_defer_np.3, pthread_setcancelstate.3, pthread_testcancel.3, pthreads.7: tfix
Date: Mon, 29 Nov 2021 12:59:36 +0100 [thread overview]
Message-ID: <5e5296c5-793c-0daa-ff8b-6bbb4eed3e57@gmail.com> (raw)
In-Reply-To: <20211124115858.47rtd2gr5l6mghyp@localhost>
Hi Samanta,
On 11/24/21 12:58, Samanta Navarro wrote:
>
> Changed cancellation to cancelation.
>
> Signed-off-by: Samanta Navarro <ferivoz@riseup.net>
Patch applied.
Thanks!
Alex
> ---
> man3/error.3 | 2 +-
> man3/fopen.3 | 2 +-
> man3/getentropy.3 | 4 +--
> man3/pthread_cancel.3 | 52 ++++++++++++++--------------
> man3/pthread_cleanup_push.3 | 16 ++++-----
> man3/pthread_cleanup_push_defer_np.3 | 8 ++---
> man3/pthread_kill_other_threads_np.3 | 2 +-
> man3/pthread_setcancelstate.3 | 26 +++++++-------
> man3/pthread_testcancel.3 | 8 ++---
> man7/aio.7 | 4 +--
> man7/attributes.7 | 42 +++++++++++-----------
> man7/nptl.7 | 2 +-
> man7/pthreads.7 | 28 +++++++--------
> man7/signal-safety.7 | 6 ++--
> 14 files changed, 101 insertions(+), 101 deletions(-)
>
> diff --git a/man3/error.3 b/man3/error.3
> index 673fe8c..38d0434 100644
> --- a/man3/error.3
> +++ b/man3/error.3
> @@ -149,7 +149,7 @@ used once, it should be safe enough) and, if
> is set nonzero, the internal static variables (not exposed to users)
> used to hold the last printed filename and line number are accessed
> and modified without synchronization; the update is not atomic and it
> -occurs before disabling cancellation, so it can be interrupted only after
> +occurs before disabling cancelation, so it can be interrupted only after
> one of the two variables is modified.
> After that,
> .BR error_at_line ()
> diff --git a/man3/fopen.3 b/man3/fopen.3
> index a1d7817..a16af1d 100644
> --- a/man3/fopen.3
> +++ b/man3/fopen.3
> @@ -327,7 +327,7 @@ The GNU C library allows the following extensions for the string specified in
> .BR c " (since glibc 2.3.3)"
> Do not make the open operation,
> or subsequent read and write operations,
> -thread cancellation points.
> +thread cancelation points.
> This flag is ignored for
> .BR fdopen ().
> .TP
> diff --git a/man3/getentropy.3 b/man3/getentropy.3
> index dca0a83..4853009 100644
> --- a/man3/getentropy.3
> +++ b/man3/getentropy.3
> @@ -98,9 +98,9 @@ function is implemented using
> .PP
> Whereas the glibc wrapper makes
> .BR getrandom (2)
> -a cancellation point,
> +a cancelation point,
> .BR getentropy ()
> -is not a cancellation point.
> +is not a cancelation point.
> .PP
> .BR getentropy ()
> is also declared in
> diff --git a/man3/pthread_cancel.3 b/man3/pthread_cancel.3
> index 01b7cf0..cf39098 100644
> --- a/man3/pthread_cancel.3
> +++ b/man3/pthread_cancel.3
> @@ -25,7 +25,7 @@
> .\"
> .TH PTHREAD_CANCEL 3 2021-03-22 "Linux" "Linux Programmer's Manual"
> .SH NAME
> -pthread_cancel \- send a cancellation request to a thread
> +pthread_cancel \- send a cancelation request to a thread
> .SH SYNOPSIS
> .nf
> .B #include <pthread.h>
> @@ -37,10 +37,10 @@ Compile and link with \fI\-pthread\fP.
> .SH DESCRIPTION
> The
> .BR pthread_cancel ()
> -function sends a cancellation request to the thread
> +function sends a cancelation request to the thread
> .IR thread .
> Whether and when the target thread
> -reacts to the cancellation request depends on
> +reacts to the cancelation request depends on
> two attributes that are under the control of that thread:
> its cancelability
> .I state
> @@ -53,13 +53,13 @@ can be
> .I enabled
> (the default for new threads) or
> .IR disabled .
> -If a thread has disabled cancellation,
> -then a cancellation request remains queued until the thread
> -enables cancellation.
> -If a thread has enabled cancellation,
> -then its cancelability type determines when cancellation occurs.
> +If a thread has disabled cancelation,
> +then a cancelation request remains queued until the thread
> +enables cancelation.
> +If a thread has enabled cancelation,
> +then its cancelability type determines when cancelation occurs.
> .PP
> -A thread's cancellation type, determined by
> +A thread's cancelation type, determined by
> .BR pthread_setcanceltype (3),
> may be either
> .IR asynchronous
> @@ -69,13 +69,13 @@ or
> Asynchronous cancelability
> means that the thread can be canceled at any time
> (usually immediately, but the system does not guarantee this).
> -Deferred cancelability means that cancellation will be delayed until
> +Deferred cancelability means that cancelation will be delayed until
> the thread next calls a function that is a
> -.IR "cancellation point" .
> -A list of functions that are or may be cancellation points is provided in
> +.IR "cancelation point" .
> +A list of functions that are or may be cancelation points is provided in
> .BR pthreads (7).
> .PP
> -When a cancellation requested is acted on, the following steps occur for
> +When a cancelation requested is acted on, the following steps occur for
> .IR thread
> (in this order):
> .IP 1. 3
> @@ -98,7 +98,7 @@ The above steps happen asynchronously with respect to the
> call;
> the return status of
> .BR pthread_cancel ()
> -merely informs the caller whether the cancellation request
> +merely informs the caller whether the cancelation request
> was successfully queued.
> .PP
> After a canceled thread has terminated,
> @@ -107,7 +107,7 @@ a join with that thread using
> obtains
> .B PTHREAD_CANCELED
> as the thread's exit status.
> -(Joining with a thread is the only way to know that cancellation
> +(Joining with a thread is the only way to know that cancelation
> has completed.)
> .SH RETURN VALUE
> On success,
> @@ -142,7 +142,7 @@ T} Thread safety MT-Safe
> .SH CONFORMING TO
> POSIX.1-2001, POSIX.1-2008.
> .SH NOTES
> -On Linux, cancellation is implemented using signals.
> +On Linux, cancelation is implemented using signals.
> Under the NPTL threading implementation,
> the first real-time signal (i.e., signal 32) is used for this purpose.
> On LinuxThreads, the second real-time signal is used,
> @@ -159,9 +159,9 @@ The following shell session shows what happens when we run the program:
> .in +4n
> .EX
> $ ./a.out
> -thread_func(): started; cancellation disabled
> -main(): sending cancellation request
> -thread_func(): about to enable cancellation
> +thread_func(): started; cancelation disabled
> +main(): sending cancelation request
> +thread_func(): about to enable cancelation
> main(): thread was canceled
> .EE
> .in
> @@ -182,22 +182,22 @@ thread_func(void *ignored_argument)
> {
> int s;
>
> - /* Disable cancellation for a while, so that we don\(aqt
> - immediately react to a cancellation request. */
> + /* Disable cancelation for a while, so that we don\(aqt
> + immediately react to a cancelation request. */
>
> s = pthread_setcancelstate(PTHREAD_CANCEL_DISABLE, NULL);
> if (s != 0)
> handle_error_en(s, "pthread_setcancelstate");
>
> - printf("thread_func(): started; cancellation disabled\en");
> + printf("thread_func(): started; cancelation disabled\en");
> sleep(5);
> - printf("thread_func(): about to enable cancellation\en");
> + printf("thread_func(): about to enable cancelation\en");
>
> s = pthread_setcancelstate(PTHREAD_CANCEL_ENABLE, NULL);
> if (s != 0)
> handle_error_en(s, "pthread_setcancelstate");
>
> - /* sleep() is a cancellation point. */
> + /* sleep() is a cancelation point. */
>
> sleep(1000); /* Should get canceled while we sleep */
>
> @@ -214,7 +214,7 @@ main(void)
> void *res;
> int s;
>
> - /* Start a thread and then send it a cancellation request. */
> + /* Start a thread and then send it a cancelation request. */
>
> s = pthread_create(&thr, NULL, &thread_func, NULL);
> if (s != 0)
> @@ -222,7 +222,7 @@ main(void)
>
> sleep(2); /* Give thread a chance to get started */
>
> - printf("main(): sending cancellation request\en");
> + printf("main(): sending cancelation request\en");
> s = pthread_cancel(thr);
> if (s != 0)
> handle_error_en(s, "pthread_cancel");
> diff --git a/man3/pthread_cleanup_push.3 b/man3/pthread_cleanup_push.3
> index 7960315..0263248 100644
> --- a/man3/pthread_cleanup_push.3
> +++ b/man3/pthread_cleanup_push.3
> @@ -26,7 +26,7 @@
> .TH PTHREAD_CLEANUP_PUSH 3 2021-03-22 "Linux" "Linux Programmer's Manual"
> .SH NAME
> pthread_cleanup_push, pthread_cleanup_pop \- push and pop
> -thread cancellation clean-up handlers
> +thread cancelation clean-up handlers
> .SH SYNOPSIS
> .nf
> .B #include <pthread.h>
> @@ -38,7 +38,7 @@ Compile and link with \fI\-pthread\fP.
> .fi
> .SH DESCRIPTION
> These functions manipulate the calling thread's stack of
> -thread-cancellation clean-up handlers.
> +thread-cancelation clean-up handlers.
> A clean-up handler is a function that is automatically executed
> when a thread is canceled (or in various other circumstances
> described below);
> @@ -63,7 +63,7 @@ and optionally executes it if
> .I execute
> is nonzero.
> .PP
> -A cancellation clean-up handler is popped from the stack
> +A cancelation clean-up handler is popped from the stack
> and executed in the following circumstances:
> .IP 1. 3
> When a thread is canceled,
> @@ -180,13 +180,13 @@ This loop increments a global variable,
> .IR cnt ,
> once each second.
> Depending on what command-line arguments are supplied,
> -the main thread sends the other thread a cancellation request,
> +the main thread sends the other thread a cancelation request,
> or sets a global variable that causes the other thread
> to exit its loop and terminate normally (by doing a
> .IR return ).
> .PP
> In the following shell session,
> -the main thread sends a cancellation request to the other thread:
> +the main thread sends a cancelation request to the other thread:
> .PP
> .in +4n
> .EX
> @@ -201,7 +201,7 @@ Thread was canceled; cnt = 0
> .in
> .PP
> From the above, we see that the thread was canceled,
> -and that the cancellation clean-up handler was called
> +and that the cancelation clean-up handler was called
> and it reset the value of the global variable
> .I cnt
> to 0.
> @@ -281,10 +281,10 @@ thread_start(void *arg)
> curr = start = time(NULL);
>
> while (!done) {
> - pthread_testcancel(); /* A cancellation point */
> + pthread_testcancel(); /* A cancelation point */
> if (curr < time(NULL)) {
> curr = time(NULL);
> - printf("cnt = %d\en", cnt); /* A cancellation point */
> + printf("cnt = %d\en", cnt); /* A cancelation point */
> cnt++;
> }
> }
> diff --git a/man3/pthread_cleanup_push_defer_np.3 b/man3/pthread_cleanup_push_defer_np.3
> index c5096d1..27ce08c 100644
> --- a/man3/pthread_cleanup_push_defer_np.3
> +++ b/man3/pthread_cleanup_push_defer_np.3
> @@ -26,7 +26,7 @@
> .TH PTHREAD_CLEANUP_PUSH_DEFER_NP 3 2021-03-22 "Linux" "Linux Programmer's Manual"
> .SH NAME
> pthread_cleanup_push_defer_np, pthread_cleanup_pop_restore_np \- push and pop
> -thread cancellation clean-up handlers while saving cancelability type
> +thread cancelation clean-up handlers while saving cancelability type
> .SH SYNOPSIS
> .nf
> .B #include <pthread.h>
> @@ -59,11 +59,11 @@ Like
> .BR pthread_cleanup_push_defer_np ()
> pushes
> .I routine
> -onto the thread's stack of cancellation clean-up handlers.
> +onto the thread's stack of cancelation clean-up handlers.
> In addition, it also saves the thread's current cancelability type,
> and sets the cancelability type to "deferred" (see
> .BR pthread_setcanceltype (3));
> -this ensures that cancellation clean-up will occur
> +this ensures that cancelation clean-up will occur
> even if the thread's cancelability type was "asynchronous"
> before the call.
> .PP
> @@ -71,7 +71,7 @@ Like
> .BR pthread_cleanup_pop (3),
> .BR pthread_cleanup_pop_restore_np ()
> pops the top-most clean-up handler from the thread's
> -stack of cancellation clean-up handlers.
> +stack of cancelation clean-up handlers.
> In addition, it restores the thread's cancelability
> type to its value at the time of the matching
> .BR pthread_cleanup_push_defer_np ().
> diff --git a/man3/pthread_kill_other_threads_np.3 b/man3/pthread_kill_other_threads_np.3
> index 031f289..ce490af 100644
> --- a/man3/pthread_kill_other_threads_np.3
> +++ b/man3/pthread_kill_other_threads_np.3
> @@ -39,7 +39,7 @@ On that implementation,
> calling this function causes the immediate termination of
> all threads in the application,
> except the calling thread.
> -The cancellation state and cancellation type of the
> +The cancelation state and cancelation type of the
> to-be-terminated threads are ignored,
> and the cleanup handlers are not called in those threads.
> .\" .SH VERSIONS
> diff --git a/man3/pthread_setcancelstate.3 b/man3/pthread_setcancelstate.3
> index 56e2acf..e0c7463 100644
> --- a/man3/pthread_setcancelstate.3
> +++ b/man3/pthread_setcancelstate.3
> @@ -54,11 +54,11 @@ The thread is cancelable.
> This is the default cancelability state in all new threads,
> including the initial thread.
> The thread's cancelability type determines when a cancelable thread
> -will respond to a cancellation request.
> +will respond to a cancelation request.
> .TP
> .B PTHREAD_CANCEL_DISABLE
> The thread is not cancelable.
> -If a cancellation request is received,
> +If a cancelation request is received,
> it is blocked until cancelability is enabled.
> .PP
> The
> @@ -74,21 +74,21 @@ The
> argument must have one of the following values:
> .TP
> .B PTHREAD_CANCEL_DEFERRED
> -A cancellation request is deferred until the thread next calls
> -a function that is a cancellation point (see
> +A cancelation request is deferred until the thread next calls
> +a function that is a cancelation point (see
> .BR pthreads (7)).
> This is the default cancelability type in all new threads,
> including the initial thread.
> .IP
> -Even with deferred cancellation, a
> -cancellation point in an asynchronous signal handler may still
> +Even with deferred cancelation, a
> +cancelation point in an asynchronous signal handler may still
> be acted upon and the effect is as if it was an asynchronous
> -cancellation.
> +cancelation.
> .TP
> .B PTHREAD_CANCEL_ASYNCHRONOUS
> The thread can be canceled at any time.
> (Typically,
> -it will be canceled immediately upon receiving a cancellation request,
> +it will be canceled immediately upon receiving a cancelation request,
> but the system doesn't guarantee this.)
> .PP
> The set-and-get operation performed by each of these functions
> @@ -150,10 +150,10 @@ For details of what happens when a thread is canceled, see
> .PP
> Briefly disabling cancelability is useful
> if a thread performs some critical action
> -that must not be interrupted by a cancellation request.
> +that must not be interrupted by a cancelation request.
> Beware of disabling cancelability for long periods,
> or around operations that may block for long periods,
> -since that will render the thread unresponsive to cancellation requests.
> +since that will render the thread unresponsive to cancelation requests.
> .SS Asynchronous cancelability
> Setting the cancelability type to
> .B PTHREAD_CANCEL_ASYNCHRONOUS
> @@ -165,13 +165,13 @@ time, it cannot safely reserve resources (e.g., allocating memory with
> acquire mutexes, semaphores, or locks, and so on.
> Reserving resources is unsafe because the application has no way of
> knowing what the state of these resources is when the thread is canceled;
> -that is, did cancellation occur before the resources were reserved,
> +that is, did cancelation occur before the resources were reserved,
> while they were reserved, or after they were released?
> Furthermore, some internal data structures
> (e.g., the linked list of free blocks managed by the
> .BR malloc (3)
> family of functions) may be left in an inconsistent state
> -if cancellation occurs in the middle of the function call.
> +if cancelation occurs in the middle of the function call.
> Consequently, clean-up handlers cease to be useful.
> .PP
> Functions that can be safely asynchronously canceled are called
> @@ -186,7 +186,7 @@ In general, other library functions
> can't be safely called from an asynchronously cancelable thread.
> .PP
> One of the few circumstances in which asynchronous cancelability is useful
> -is for cancellation of a thread that is in a pure compute-bound loop.
> +is for cancelation of a thread that is in a pure compute-bound loop.
> .SS Portability notes
> The Linux threading implementations permit the
> .I oldstate
> diff --git a/man3/pthread_testcancel.3 b/man3/pthread_testcancel.3
> index 8dc2d61..42f34a2 100644
> --- a/man3/pthread_testcancel.3
> +++ b/man3/pthread_testcancel.3
> @@ -25,7 +25,7 @@
> .\"
> .TH PTHREAD_TESTCANCEL 3 2021-03-22 "Linux" "Linux Programmer's Manual"
> .SH NAME
> -pthread_testcancel \- request delivery of any pending cancellation request
> +pthread_testcancel \- request delivery of any pending cancelation request
> .SH SYNOPSIS
> .nf
> .B #include <pthread.h>
> @@ -37,13 +37,13 @@ Compile and link with \fI\-pthread\fP.
> .SH DESCRIPTION
> Calling
> .BR pthread_testcancel ()
> -creates a cancellation point within the calling thread,
> +creates a cancelation point within the calling thread,
> so that a thread that is otherwise executing code that contains
> -no cancellation points will respond to a cancellation request.
> +no cancelation points will respond to a cancelation request.
> .PP
> If cancelability is disabled (using
> .BR pthread_setcancelstate (3)),
> -or no cancellation request is pending,
> +or no cancelation request is pending,
> then a call to
> .BR pthread_testcancel ()
> has no effect.
> diff --git a/man7/aio.7 b/man7/aio.7
> index 72287be..959c354 100644
> --- a/man7/aio.7
> +++ b/man7/aio.7
> @@ -209,7 +209,7 @@ the program retrieves their status using
> The
> .B SIGQUIT
> signal (generated by typing control-\e) causes the program to request
> -cancellation of each of the outstanding requests using
> +cancelation of each of the outstanding requests using
> .BR aio_cancel (3).
> .PP
> Here is an example of what we might see when running this program.
> @@ -371,7 +371,7 @@ main(int argc, char *argv[])
>
> /* On receipt of SIGQUIT, attempt to cancel each of the
> outstanding I/O requests, and display status returned
> - from the cancellation requests. */
> + from the cancelation requests. */
>
> printf("got SIGQUIT; canceling I/O requests: \en");
>
> diff --git a/man7/attributes.7 b/man7/attributes.7
> index 580ebfe..fdf91e1 100644
> --- a/man7/attributes.7
> +++ b/man7/attributes.7
> @@ -85,7 +85,7 @@ safe for inlining.
> .\" .I AC-Safe
> .\" .I AC-Safe
> .\" or Async-Cancel-Safe functions are safe to call when
> -.\" asynchronous cancellation is enabled.
> +.\" asynchronous cancelation is enabled.
> .\" AC in AC-Safe stands for Asynchronous Cancellation.
> .\"
> .\" The POSIX standard defines only three functions to be AC-Safe, namely
> @@ -99,10 +99,10 @@ safe for inlining.
> .\" This documentation is provided for use
> .\" by the GNU C Library developers.
> .\"
> -.\" Just like signal handlers, cancellation cleanup routines must configure
> +.\" Just like signal handlers, cancelation cleanup routines must configure
> .\" the floating point environment they require.
> .\" The routines cannot assume a floating point environment,
> -.\" particularly when asynchronous cancellation is enabled.
> +.\" particularly when asynchronous cancelation is enabled.
> .\" If the configuration of the floating point
> .\" environment cannot be performed atomically then it is also possible that
> .\" the environment encountered is internally inconsistent.
> @@ -174,7 +174,7 @@ Other keywords that appear in safety notes are defined in subsequent sections.
> .\" AS-Unsafe features in this section indicate the functions are never safe
> .\" to call when asynchronous signals are enabled.
> .\" AC-Unsafe features
> -.\" indicate they are never safe to call when asynchronous cancellation is
> +.\" indicate they are never safe to call when asynchronous cancelation is
> .\" .\" enabled.
> .\" There are no MT-Unsafe marks in this section.
> .\" .TP
> @@ -190,7 +190,7 @@ Other keywords that appear in safety notes are defined in subsequent sections.
> .\" .I lock
> .\" as an AC-Unsafe feature may, if canceled asynchronously,
> .\" fail to release a lock that would have been released if their execution
> -.\" had not been interrupted by asynchronous thread cancellation.
> +.\" had not been interrupted by asynchronous thread cancelation.
> .\" Once a lock is left taken,
> .\" attempts to take that lock will block indefinitely.
> .\" .TP
> @@ -319,7 +319,7 @@ Other keywords that appear in safety notes are defined in subsequent sections.
> .\" AS-Unsafe, because calling them in signal handlers may interfere with
> .\" timers set in the interrupted code, and AC-Unsafe,
> .\" because there is no safe way to guarantee an earlier timer
> -.\" will be reset in case of asynchronous cancellation.
> +.\" will be reset in case of asynchronous cancelation.
> .\"
> .\"
> .SS Conditionally safe features
> @@ -366,7 +366,7 @@ the function can then be safely called after other threads are started.
> .\" .I init
> .\" as an AS-Safety or AC-Unsafe feature should ensure
> .\" the initialization is performed
> -.\" before configuring signal handlers or enabling cancellation,
> +.\" before configuring signal handlers or enabling cancelation,
> .\" so that the AS-Safety and AC-Safety issues related with
> .\" .I libc_once
> .\" do not arise.
> @@ -565,16 +565,16 @@ blocking that signal before the call and resetting its
> handler afterwards is recommended.
> .\"
> .\" There is no safe way to guarantee the original signal handler is
> -.\" restored in case of asynchronous cancellation,
> +.\" restored in case of asynchronous cancelation,
> .\" therefore so-marked functions are also AC-Unsafe.
> .\"
> -.\" .\" fixme: at least deferred cancellation should get it right, and would
> +.\" .\" fixme: at least deferred cancelation should get it right, and would
> .\" .\" obviate the restoring bit below, and the qualifier above.
> .\"
> .\" Besides the measures recommended to work around the
> .\" MT-Safety and AS-Safety problem,
> -.\" in order to avert the cancellation problem,
> -.\" disabling asynchronous cancellation
> +.\" in order to avert the cancelation problem,
> +.\" disabling asynchronous cancelation
> .\" .I and
> .\" installing a cleanup handler to restore the signal to the desired state
> .\" and to release the mutex are recommended.
> @@ -616,13 +616,13 @@ even if referenced by different file descriptors.
> .\" restore terminal settings to their original state,
> .\" after temporarily changing them, but they may fail to do so if canceled.
> .\"
> -.\" .\" fixme: at least deferred cancellation should get it right, and would
> +.\" .\" fixme: at least deferred cancelation should get it right, and would
> .\" .\" obviate the restoring bit below, and the qualifier above.
> .\"
> .\" Besides the measures recommended to work around the
> .\" MT-Safety and AS-Safety problem,
> -.\" in order to avert the cancellation problem,
> -.\" disabling asynchronous cancellation
> +.\" in order to avert the cancelation problem,
> +.\" disabling asynchronous cancelation
> .\" .I and
> .\" installing a cleanup handler to
> .\" restore the terminal settings to the original state and to release the
> @@ -733,7 +733,7 @@ which makes the former safe.
> .\" Functions annotated with
> .\" .I fd
> .\" as an AC-Safety issue may leak file
> -.\" descriptors if asynchronous thread cancellation interrupts their
> +.\" descriptors if asynchronous thread cancelation interrupts their
> .\" execution.
> .\"
> .\" Functions that allocate or deallocate file descriptors will generally be
> @@ -755,7 +755,7 @@ which makes the former safe.
> .\" reallocated by another thread or signal handler.
> .\"
> .\" Such leaks could be internally avoided, with some performance penalty,
> -.\" by temporarily disabling asynchronous thread cancellation.
> +.\" by temporarily disabling asynchronous thread cancelation.
> .\" However,
> .\" since callers of allocation or deallocation functions would have to do
> .\" this themselves, to avoid the same sort of leak in their own layer,
> @@ -768,26 +768,26 @@ which makes the former safe.
> .\" However, cumulative effects of such leaks may pose a
> .\" problem for some programs.
> .\" If this is the case,
> -.\" suspending asynchronous cancellation for the duration of calls
> +.\" suspending asynchronous cancelation for the duration of calls
> .\" to such functions is recommended.
> .\" .TP
> .\" .I mem
> .\" Functions annotated with
> .\" .I mem
> .\" as an AC-Safety issue may leak
> -.\" memory if asynchronous thread cancellation interrupts their execution.
> +.\" memory if asynchronous thread cancelation interrupts their execution.
> .\"
> .\" The problem is similar to that of file descriptors: there is no atomic
> .\" interface to allocate memory and store its address in the argument to a
> .\" cleanup handler,
> .\" or to release it and remove its address from that argument,
> -.\" without at least temporarily disabling asynchronous cancellation,
> +.\" without at least temporarily disabling asynchronous cancelation,
> .\" which these functions do not do.
> .\"
> .\" This remark does not by itself cause a function to be regarded as
> .\" generally AC-Unsafe.
> .\" However, cumulative effects of such leaks may be
> -.\" severe enough for some programs that disabling asynchronous cancellation
> +.\" severe enough for some programs that disabling asynchronous cancelation
> .\" for the duration of calls to such functions may be required.
> .TP
> .I cwd
> @@ -796,7 +796,7 @@ Functions marked with
> as an MT-Safety issue may temporarily
> change the current working directory during their execution,
> which may cause relative pathnames to be resolved in unexpected ways in
> -other threads or within asynchronous signal or cancellation handlers.
> +other threads or within asynchronous signal or cancelation handlers.
> .IP
> This is not enough of a reason to mark so-marked functions as MT-Unsafe,
> .\" or AS-Unsafe,
> diff --git a/man7/nptl.7 b/man7/nptl.7
> index 0133c0a..ea17940 100644
> --- a/man7/nptl.7
> +++ b/man7/nptl.7
> @@ -34,7 +34,7 @@ Linux systems.
> .SS NPTL and signals
> NPTL makes internal use of the first two real-time signals
> (signal numbers 32 and 33).
> -One of these signals is used to support thread cancellation and POSIX timers
> +One of these signals is used to support thread cancelation and POSIX timers
> (see
> .BR timer_create (2));
> the other is used as part of a mechanism that ensures all threads in
> diff --git a/man7/pthreads.7 b/man7/pthreads.7
> index 6f4f6e7..380aeb2 100644
> --- a/man7/pthreads.7
> +++ b/man7/pthreads.7
> @@ -257,17 +257,17 @@ pthread_setcanceltype()
> .in
> .SS Cancellation points
> POSIX.1 specifies that certain functions must,
> -and certain other functions may, be cancellation points.
> +and certain other functions may, be cancelation points.
> If a thread is cancelable, its cancelability type is deferred,
> -and a cancellation request is pending for the thread,
> +and a cancelation request is pending for the thread,
> then the thread is canceled when it calls a function
> -that is a cancellation point.
> +that is a cancelation point.
> .PP
> -The following functions are required to be cancellation points by
> +The following functions are required to be cancelation points by
> POSIX.1-2001 and/or POSIX.1-2008:
> .PP
> .\" FIXME
> -.\" Document the list of all functions that are cancellation points in glibc
> +.\" Document the list of all functions that are cancelation points in glibc
> .in +4n
> .EX
> accept()
> @@ -331,7 +331,7 @@ writev()
> .EE
> .in
> .PP
> -The following functions may be cancellation points according to
> +The following functions may be cancelation points according to
> POSIX.1-2001 and/or POSIX.1-2008:
> .PP
> .in +4n
> @@ -567,23 +567,23 @@ wscanf()
> .in
> .PP
> An implementation may also mark other functions
> -not specified in the standard as cancellation points.
> +not specified in the standard as cancelation points.
> In particular, an implementation is likely to mark
> -any nonstandard function that may block as a cancellation point.
> +any nonstandard function that may block as a cancelation point.
> (This includes most functions that can touch files.)
> .PP
> It should be noted that even if an application is not using
> -asynchronous cancellation, that calling a function from the above list
> +asynchronous cancelation, that calling a function from the above list
> from an asynchronous signal handler may cause the equivalent of
> -asynchronous cancellation.
> +asynchronous cancelation.
> The underlying user code may not expect
> -asynchronous cancellation and the state of the user data may become
> +asynchronous cancelation and the state of the user data may become
> inconsistent.
> Therefore signals should be used with caution when
> -entering a region of deferred cancellation.
> -.\" So, scanning "cancellation point" comments in the glibc 2.8 header
> +entering a region of deferred cancelation.
> +.\" So, scanning "cancelation point" comments in the glibc 2.8 header
> .\" files, it looks as though at least the following nonstandard
> -.\" functions are cancellation points:
> +.\" functions are cancelation points:
> .\" endnetgrent
> .\" endspent
> .\" epoll_pwait
> diff --git a/man7/signal-safety.7 b/man7/signal-safety.7
> index 9e8cd3f..b0108c8 100644
> --- a/man7/signal-safety.7
> +++ b/man7/signal-safety.7
> @@ -322,9 +322,9 @@ is likely to remove
> from the list of async-signal-safe functions.
> .\"
> .IP * 3
> -Asynchronous signal handlers that call functions which are cancellation
> -points and nest over regions of deferred cancellation may trigger
> -cancellation whose behavior is as if asynchronous cancellation had
> +Asynchronous signal handlers that call functions which are cancelation
> +points and nest over regions of deferred cancelation may trigger
> +cancelation whose behavior is as if asynchronous cancelation had
> occurred and may cause application state to become inconsistent.
> .\"
> .SS errno
>
--
Alejandro Colomar
Linux man-pages comaintainer; http://www.kernel.org/doc/man-pages/
prev parent reply other threads:[~2021-11-29 13:17 UTC|newest]
Thread overview: 6+ messages / expand[flat|nested] mbox.gz Atom feed top
2021-11-13 11:56 [patch] pthread_cancel.3, pthread_cleanup_push_defer_np.3, pthread_setcancelstate.3, pthread_testcancel.3, pthreads.7: tfix Samanta Navarro
2021-11-13 12:40 ` G. Branden Robinson
2021-11-13 13:00 ` Samanta Navarro
2021-11-22 17:09 ` Alejandro Colomar (man-pages)
2021-11-24 11:58 ` Samanta Navarro
2021-11-29 11:59 ` Alejandro Colomar (man-pages) [this message]
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=5e5296c5-793c-0daa-ff8b-6bbb4eed3e57@gmail.com \
--to=alx.manpages@gmail.com \
--cc=ferivoz@riseup.net \
--cc=g.branden.robinson@gmail.com \
--cc=linux-man@vger.kernel.org \
--cc=mtk.manpages@gmail.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox