1.\" $OpenBSD: PKCS7_get_signer_info.3,v 1.1 2020/06/10 11:43:08 schwarze Exp $ 2.\" 3.\" Copyright (c) 2020 Ingo Schwarze <schwarze@openbsd.org> 4.\" 5.\" Permission to use, copy, modify, and distribute this software for any 6.\" purpose with or without fee is hereby granted, provided that the above 7.\" copyright notice and this permission notice appear in all copies. 8.\" 9.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES 10.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF 11.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR 12.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES 13.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN 14.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF 15.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. 16.\" 17.Dd $Mdocdate: June 10 2020 $ 18.Dt PKCS7_GET_SIGNER_INFO 3 19.Os 20.Sh NAME 21.Nm PKCS7_get_signer_info 22.Nd retrieve signerInfos from a SignedData object 23.Sh SYNOPSIS 24.In openssl/pkcs7.h 25.Ft STACK_OF(PKCS7_SIGNER_INFO) * 26.Fn PKCS7_get_signer_info "PKCS7 *p7" 27.Sh DESCRIPTION 28This function retrieves the set of 29.Vt SignerInfo 30structures from the 31.Fa signerInfos 32field of 33.Fa p7 . 34.Pp 35These can subsequently be manipulated with the functions documented in 36.Xr PKCS7_add_attribute 3 . 37.Sh RETURN VALUES 38.Fn PKCS7_get_signer_info 39returns an internal pointer to a 40.Vt STACK_OF(PKCS7_SIGNER_INFO) 41object or 42.Dv NULL 43on failure. 44It fails if 45.Fa p7 46is 47.Dv NULL , 48if it has no content, 49or if it is of a type other than 50.Vt SignedData 51or 52.Vt SignedAndEnvelopedData . 53.Sh SEE ALSO 54.Xr PKCS7_add_attribute 3 , 55.Xr PKCS7_final 3 , 56.Xr PKCS7_new 3 , 57.Xr PKCS7_sign 3 , 58.Xr PKCS7_sign_add_signer 3 59.Sh HISTORY 60.Fn PKCS7_get_signer_info 61first appeared in SSLeay 0.8.1 and has been available since 62.Ox 2.4 . 63