Copyright (c) 2003, 2007 The NetBSD Foundation, Inc.
All rights reserved.
This code is derived from software contributed to The NetBSD Foundation
by Jason R. Thorpe of Wasabi Systems, Inc, and by Andrew Doran.
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions
are met:
1. Redistributions of source code must retain the above copyright
notice, this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright
notice, this list of conditions and the following disclaimer in the
documentation and/or other materials provided with the distribution.
THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
POSSIBILITY OF SUCH DAMAGE.
.Dd February 10, 2007 .Dt _LWP_UNPARK_ALL 2 .Os .Sh NAME .Nm _lwp_unpark_all .Nd resume execution of a waiting LWP .Sh LIBRARY .Lb libc .Sh SYNOPSIS n lwp.h .Ft ssize_t .Fn _lwp_unpark_all "const lwpid_t *targets" "size_t ntargets" "const void *hint" .Sh DESCRIPTION .Fn _lwp_unpark_all resumes execution of one or more light-weight processes listed in the array pointed to by .Fa targets .
p The target LWPs are assumed to be waiting in the kernel as a result of calls to .Fn _lwp_park . If any of the target LWPs are not currently waiting, those LWPs will return immediately upon the next call to .Fn _lwp_park .
p The .Fa ntargets argument specifies the size of the array pointed to by .Fa targets .
p If the .Fa targets argument is given as .Dv NULL , the maximum size of the array
q expressed as the number of entries is returned.
p
See
.Xr _lwp_park 2
for a description of the
.Fa hint
argument.
.Sh RETURN VALUES
XXX: almsost, but we need the initial "if" clause...
.Rv -std _lwp_unpark_all
If the maximum size of the
.Fa targets
array is not being queried, the
.Fn _lwp_unpark_all
function returns the value 0 if successful;
otherwise the value -1 is returned and the global variable
.Va errno
is set to indicate the error.
.Sh ERRORS
l -tag -width Er t Bq Er EFAULT The value specified for
.Fa targets
is invalid.
t Bq Er EINVAL The value specified for
.Fa ntargets
is out of range.
t Bq Er ENOMEM Insufficient resources are available to complete the operation.
.El
.Sh SEE ALSO
.Xr _lwp_park 2 ,
.Xr _lwp_unpark 2 ,
.Xr _lwp_wakeup 2
.Sh HISTORY
The
.Fn _lwp_unpark_all
system call first appeared in
.Nx 5.0 .
Indexes created Wed Sep 24 05:09:52 GMT 2025