NAME

       cl_hp_parse_field - Execute field parser

SYNOPSIS

       #include <libcanlock-3/canlock-hp.h>

       char *cl_hp_parse_field(const char *data, size_t data_len);

DESCRIPTION

       The cl_hp_parse_field() function executes the header field parser.
       This implementation executes the canlock-hfp utility in a separate process.

       The parameter data should point to the beginning of the input data.
       Specify the length of the input data with the data_len parameter.

       The input data must be an unfolded "Cancel-Lock" or "Cancel-Key" header field without line
       break at the end.
       The function cl_hp_get_field() can be used to extract a field from the message header.
       The function cl_hp_unfold_field() can be used to remove potential folding from an  already
       extracted header field.

RETURN VALUE

       If  the  parser  reports success, a pointer to the NUL-terminated output data is returned.
       Otherwise, NULL is returned.

       On success, the caller is responsible to free() the memory block allocated for the  output
       data.

AUTHORS

       Michael Baeuerle

REPORTING BUGS

       Report bugs to <mailto:michael.baeuerle@gmx.net>.

STANDARDS

       cl_hp_parse_field() tries to comply with the following standards:

       RFC 8315

SEE ALSO

       free(3),   cl_hp_get_field(3),   cl_hp_unfold_field(3),   canlock-hfp(1),  canlock-mhp(1),
       canlock(1)