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 › Threaded › netListenUnixPosix Private Function netListenUnixPosix Doc Source Private Function std.Io.Threaded.netListenUnixPosix
fn netListenUnixPosix (
userdata : ?*anyopaque ,
address : *const net .UnixAddress ,
options : net .UnixAddress .ListenOptions ,
) net .UnixAddress .ListenError !net .Socket .Handle Params userdata : ?*anyopaque address : *const net .UnixAddress options : net .UnixAddress .ListenOptions File Io/Threaded.zig: 12026
12026
12027
12028
12029
12030
12031
12032
12033
12034
12035
12036
12037
12038
12039
12040
12041
12042
12043
12044
12045
12046
12047
12048
12049
12050
12051
12052
12053
12054
12055
12056
12057
12058
12059
12060
12061
12062
12063
12064
12065 fn netListenUnixPosix (
userdata : ?*anyopaque ,
address : *const net .UnixAddress ,
options : net .UnixAddress .ListenOptions ,
) net .UnixAddress .ListenError !net .Socket .Handle {
if (!net .has_unix_sockets ) return error .AddressFamilyUnsupported ;
const t : *Threaded = @ptrCast (@alignCast (userdata ));
_ = t ;
const socket_fd = openSocketPosix (posix .AF .UNIX , .{ .mode = .stream }) catch |err | switch (err ) {
error .ProtocolUnsupportedBySystem => return error .AddressFamilyUnsupported ,
error .ProtocolUnsupportedByAddressFamily => return error .AddressFamilyUnsupported ,
error .SocketModeUnsupported => return error .AddressFamilyUnsupported ,
error .OptionUnsupported => return error .Unexpected ,
else => |e | return e ,
};
errdefer closeFd (socket_fd );
var storage : UnixAddress = undefined ;
const addr_len = addressUnixToPosix (address , &storage );
try posixBindUnix (socket_fd , &storage .any , addr_len );
const syscall : Syscall = try .start ();
while (true ) {
switch (posix .errno (posix .system .listen (socket_fd , options .kernel_backlog ))) {
.SUCCESS => {
syscall .finish ();
break ;
},
.INTR => {
try syscall .checkCancel ();
continue ;
},
.ADDRINUSE => return syscall .fail (error .AddressInUse ),
.BADF => |err | return syscall .errnoBug (err ), // File descriptor used after closed.
else => |err | return syscall .unexpectedErrno (err ),
}
}
return socket_fd ;
}