diff options
Diffstat (limited to 'man/libhttpc_loadrequest.3')
| -rw-r--r-- | man/libhttpc_loadrequest.3 | 85 |
1 files changed, 81 insertions, 4 deletions
diff --git a/man/libhttpc_loadrequest.3 b/man/libhttpc_loadrequest.3 index d926953..b25e09d 100644 --- a/man/libhttpc_loadrequest.3 +++ b/man/libhttpc_loadrequest.3 @@ -1,9 +1,10 @@ -.Dd December 14, 2024 +.Dd December 15, 2024 .Dt LIBHTTPC_LOADREQUEST 3 .Os . .Sh NAME -.Nm LibHTTPC_loadRequest +.Nm LibHTTPC_loadRequest , +.Nm LibHTTPC_readRequest .Nd parse HTTP request . .Sh SYNOPSIS @@ -13,6 +14,13 @@ .Fa "struct LibHTTPC_Request *request_buf" .Fa "char *buf" .Fc +.Ft "struct LibHTTPC_Request *" +.Fo LibHTTPC_readRequest +.Fa "int sockfd" +.Fa "struct LibHTTPC_Request *request_buf" +.Fa "char *buf" +.Fa "size_t buf_len" +.Fc . .Sh DESCRIPTION .Fn LibHTTPC_loadRequest @@ -20,12 +28,27 @@ parses .Fa buf and fills .Fa request_buf . +. +.Pp +.Fn LibHTTPC_readRequest +parses +.Xr libhttpc_request 3 +from +.Xr socket 2 +directly. +.Fa buf +can't be NULL. +Behavior +for this should be +implemented later, +though. +. +.Pp If .Fa request_buf -argument is .Dv NULL , -then functon will +then function will allocate buffer itself. . @@ -69,6 +92,55 @@ section of for more information. .El . +.Pp +If +.Fn LibHTTPC_readRequest +returned +.Dv NULL , +it could mean +either: +.Bl -bullet +.It +If +.Xr errno 3 +is 0 +(Success), +then either: +.Bl -bullet +.It +Either +.Fa buf +is +.Dv NULL +or +.Fa buf_len +is 0 +.It +Read text about +return values of +.Fn LibHTTPC_loadRequest +.El +.It +If +.Xr errno 3 +is not 0, +it means that either: +.Bl -bullet +.It +.Xr recv 2 +has failed. +Read +.Ql ERRORS +section of +.Xr recv 2 +for more information. +.It +Read text about +return values of +.Fn LibHTTPC_loadRequest +.El +.El +. .Sh SEE ALSO .Xr libhttpc 3 , .Xr libhttpc-alloc 3 , @@ -88,3 +160,8 @@ It sets on the end of every string in .Fa request_buf . +Note that +.Fn LibHTTPC_readRequest +uses +.Fn LibHTTPC_loadRequest +under the hood. |