Zig 0.17.0-dev (Split by item) This is an example of documentation generated by
ZigDoc , an alternative to Zig's built-in
Auto Doc feature. See also
examples in other modes/formats . The project being documented here (as the example) is the Zig standard library.
std › Io › Uring › childKill Private Function childKill Doc Source Private Function std.Io.Uring.childKill
fn childKill (userdata : ?*anyopaque , child : *process .Child ) void Params userdata : ?*anyopaque child : *process .Child File Io/Uring.zig: 4773
4773
4774
4775
4776
4777
4778
4779
4780
4781
4782
4783
4784
4785
4786
4787
4788
4789
4790
4791
4792
4793
4794
4795
4796
4797
4798
4799
4800
4801
4802
4803
4804
4805
4806
4807
4808
4809
4810
4811
4812
4813
4814
4815
4816
4817
4818
4819
4820 fn childKill (userdata : ?*anyopaque , child : *process .Child ) void {
const ev : *Evented = @ptrCast (@alignCast (userdata ));
var maybe_sync : CancelRegion .Sync .Maybe = .{ .sync = .initBlocked (ev ) };
defer maybe_sync .deinit (ev );
defer ev .childCleanup (child );
const pid = child .id .?;
while (true ) switch (linux .errno (linux .kill (pid , .TERM ))) {
.SUCCESS => break ,
.INTR => {},
.PERM => return ,
.INVAL => |err | return errnoBug (err ) catch {},
.SRCH => |err | return errnoBug (err ) catch {},
else => |err | return unexpectedErrno (err ) catch {},
};
maybe_sync .leaveSync (ev );
var info : linux .siginfo_t = undefined ;
while (true ) {
const thread = maybe_sync .cancel_region .awaitIoUring () catch |err | switch (err ) {
error .Canceled => unreachable , // blocked
};
thread .enqueue ().* = .{
.opcode = .WAITID ,
.flags = 0 ,
.ioprio = 0 ,
.fd = pid ,
.off = @intFromPtr (&info ),
.addr = 0 ,
.len = @backingInt (linux .P .PID ),
.rw_flags = 0 ,
.user_data = @intFromPtr (maybe_sync .cancel_region .fiber ),
.buf_index = 0 ,
.personality = 0 ,
.splice_fd_in = linux .W .EXITED ,
.addr3 = 0 ,
.resv = 0 ,
};
ev .yield (null , .nothing );
switch (maybe_sync .cancel_region .errno ()) {
.SUCCESS => return ,
.INTR , .CANCELED => {},
.CHILD => |err | return errnoBug (err ) catch {}, // Double-free.
else => |err | return unexpectedErrno (err ) catch {},
}
}
}