159191Skris=pod
259191Skris
359191Skris=head1 NAME
459191Skris
559191SkrisERR_load_strings, ERR_PACK, ERR_get_next_error_library - load
659191Skrisarbitrary error strings
759191Skris
859191Skris=head1 SYNOPSIS
959191Skris
1059191Skris #include <openssl/err.h>
1159191Skris
1259191Skris void ERR_load_strings(int lib, ERR_STRING_DATA str[]);
1359191Skris
1459191Skris int ERR_get_next_error_library(void);
1559191Skris
1659191Skris unsigned long ERR_PACK(int lib, int func, int reason);
1759191Skris
1859191Skris=head1 DESCRIPTION
1959191Skris
2059191SkrisERR_load_strings() registers error strings for library number B<lib>.
2159191Skris
2259191SkrisB<str> is an array of error string data:
2359191Skris
2459191Skris typedef struct ERR_string_data_st
2559191Skris {
2659191Skris        unsigned long error;
2759191Skris        char *string;
2859191Skris } ERR_STRING_DATA;
2959191Skris
3059191SkrisThe error code is generated from the library number and a function and
3159191Skrisreason code: B<error> = ERR_PACK(B<lib>, B<func>, B<reason>).
3259191SkrisERR_PACK() is a macro.
3359191Skris
3459191SkrisThe last entry in the array is {0,0}.
3559191Skris
3659191SkrisERR_get_next_error_library() can be used to assign library numbers
3759191Skristo user libraries at runtime.
3859191Skris
3959191Skris=head1 RETURN VALUE
4059191Skris
4159191SkrisERR_load_strings() returns no value. ERR_PACK() return the error code.
4259191SkrisERR_get_next_error_library() returns a new library number.
4359191Skris
4459191Skris=head1 SEE ALSO
4559191Skris
4659191SkrisL<err(3)|err(3)>, L<ERR_load_strings(3)|ERR_load_strings(3)>
4759191Skris
4859191Skris=head1 HISTORY
4959191Skris
5059191SkrisERR_load_error_strings() and ERR_PACK() are available in all versions
5159191Skrisof SSLeay and OpenSSL. ERR_get_next_error_library() was added in
5259191SkrisSSLeay 0.9.0.
5359191Skris
5459191Skris=cut
55