diff options
author | Richard Levitte <levitte@openssl.org> | 2019-05-23 03:36:21 +0200 |
---|---|---|
committer | Richard Levitte <levitte@openssl.org> | 2019-10-03 15:47:25 +0200 |
commit | 695d195bbb81f8ed4027468fe1c480f958e846c8 (patch) | |
tree | 97adf9d6199573bed701910b41cfe56bb4e56dd7 /doc/internal | |
parent | e7c27a6c3716843f8412fd96311b70ac84b785f9 (diff) |
Replumbing: make it possible for providers to specify multiple names
This modifies the treatment of algorithm name strings to allow
multiple names separated with colons.
Reviewed-by: Tomas Mraz <tmraz@fedoraproject.org>
(Merged from https://github.com/openssl/openssl/pull/8985)
Diffstat (limited to 'doc/internal')
-rw-r--r-- | doc/internal/man3/ossl_namemap_new.pod | 23 |
1 files changed, 18 insertions, 5 deletions
diff --git a/doc/internal/man3/ossl_namemap_new.pod b/doc/internal/man3/ossl_namemap_new.pod index b82d47a5bf..2bcf21386d 100644 --- a/doc/internal/man3/ossl_namemap_new.pod +++ b/doc/internal/man3/ossl_namemap_new.pod @@ -3,7 +3,9 @@ =head1 NAME ossl_namemap_new, ossl_namemap_free, ossl_namemap_stored, -ossl_namemap_add, ossl_namemap_name2num, ossl_namemap_doall_names +ossl_namemap_add, ossl_namemap_add_n, +ossl_namemap_name2num, ossl_namemap_name2num_n, +ossl_namemap_doall_names - internal number E<lt>-E<gt> name map =head1 SYNOPSIS @@ -16,8 +18,12 @@ ossl_namemap_add, ossl_namemap_name2num, ossl_namemap_doall_names void ossl_namemap_free(OSSL_NAMEMAP *namemap); int ossl_namemap_add(OSSL_NAMEMAP *namemap, int number, const char *name); + int ossl_namemap_add_n(OSSL_NAMEMAP *namemap, int number, + const char *name, size_t name_len); int ossl_namemap_name2num(const OSSL_NAMEMAP *namemap, const char *name); + int ossl_namemap_name2num_n(const OSSL_NAMEMAP *namemap, + const char *name, size_t name_len); void ossl_namemap_doall_names(const OSSL_NAMEMAP *namemap, int number, void (*fn)(const char *name, void *data), void *data); @@ -49,6 +55,12 @@ names already associated with that number. ossl_namemap_name2num() finds the number corresponding to the given I<name>. +ossl_namemap_add_n() and ossl_namemap_name2num_n() do the same thing +as ossl_namemap_add() and ossl_namemap_name2num(), but take a string +length I<name_len> as well, allowing the caller to use a fragment of +a string as a name. + + ossl_namemap_doall_names() walks through all names associated with I<number> in the given I<namemap> and calls the function I<fn> for each of them. @@ -60,15 +72,16 @@ pass extra data for that function to use. ossl_namemap_new() and ossl_namemap_stored() return the pointer to a B<OSSL_NAMEMAP>, or NULL on error. -ossl_namemap_add() returns the number associated with the added -string, or zero on error. +ossl_namemap_add() and ossl_namemap_add_n() return the number associated +with the added string, or zero on error. ossl_namemap_num2names() returns a pointer to a NULL-terminated list of pointers to the names corresponding to the given number, or NULL if it's undefined in the given B<OSSL_NAMEMAP>. -ossl_namemap_name2num() returns the number corresponding to the given -name, or 0 if it's undefined in the given B<OSSL_NAMEMAP>. +ossl_namemap_name2num() and ossl_namemap_name2num_n() return the number +corresponding to the given name, or 0 if it's undefined in the given +B<OSSL_NAMEMAP>. =head1 NOTES |