meaning to send until the end of file has been reached.
On return the value pointed to by the
.Fa len
-argument indicates how many bytes have been sent.
+argument indicates how many bytes have been sent, except when a header or
+trailer is specified as shown below.
The
.Fa len
pointer may not be NULL.
and
.Fa trl_cnt .
.Pp
+When a header or trailer is specified, the value of
+.Fa len
+argument indicates the maximum number of bytes in the header and/or file to be sent.
+It does not control the trailer; if a trailer exists, all of it will be sent.
+If the value of
+.Fa len
+argument is 0, all of the header and/or file will be sent before the entire trailer is sent.
+On return, the
+.Fa len
+argument specifies the total number of bytes sent.
+.Pp
The
.Fa flags
parameter is reserved for future expansion and must be set to 0. Any other value