'\" t .\" Title: fence_array_create .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Generator: DocBook XSL Stylesheets v1.79.1 .\" Date: January 2017 .\" Manual: Device drivers infrastructure .\" Source: Kernel Hackers Manual 4.8.15 .\" Language: English .\" .TH "FENCE_ARRAY_CREATE" "9" "January 2017" "Kernel Hackers Manual 4\&.8\&." "Device drivers infrastructure" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" http://bugs.debian.org/507673 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) .ad l .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "NAME" fence_array_create \- Create a custom fence array .SH "SYNOPSIS" .HP \w'struct\ fence_array\ *\ fence_array_create('u .BI "struct fence_array * fence_array_create(int\ " "num_fences" ", struct\ fence\ **\ " "fences" ", u64\ " "context" ", unsigned\ " "seqno" ", bool\ " "signal_on_any" ");" .SH "ARGUMENTS" .PP \fInum_fences\fR .RS 4 [in] number of fences to add in the array .RE .PP \fIfences\fR .RS 4 [in] array containing the fences .RE .PP \fIcontext\fR .RS 4 [in] fence context to use .RE .PP \fIseqno\fR .RS 4 [in] sequence number to use \fIsignal_on_any\fR [in] signal on any fence in the array .RE .PP \fIsignal_on_any\fR .RS 4 \-\- undescribed \-\- .RE .SH "DESCRIPTION" .PP Allocate a fence_array object and initialize the base fence with \fBfence_init\fR\&. In case of error it returns NULL\&. .PP The caller should allocte the fences array with num_fences size and fill it with the fences it wants to add to the object\&. Ownership of this array is take and \fBfence_put\fR is used on each fence on release\&. .PP If \fIsignal_on_any\fR is true the fence array signals if any fence in the array signals, otherwise it signals when all fences in the array signal\&. .SH "COPYRIGHT" .br