=pod

=head1 NAME

ADMISSIONS,

ADMISSIONS_get0_admissionAuthority,

ADMISSIONS_get0_namingAuthority,

ADMISSIONS_get0_professionInfos,

ADMISSIONS_set0_admissionAuthority,

ADMISSIONS_set0_namingAuthority,

ADMISSIONS_set0_professionInfos,

ADMISSION_SYNTAX,

ADMISSION_SYNTAX_get0_admissionAuthority,

ADMISSION_SYNTAX_get0_contentsOfAdmissions,

ADMISSION_SYNTAX_set0_admissionAuthority,

ADMISSION_SYNTAX_set0_contentsOfAdmissions,

NAMING_AUTHORITY,

NAMING_AUTHORITY_get0_authorityId,

NAMING_AUTHORITY_get0_authorityURL,

NAMING_AUTHORITY_get0_authorityText,

NAMING_AUTHORITY_set0_authorityId,

NAMING_AUTHORITY_set0_authorityURL,

NAMING_AUTHORITY_set0_authorityText,

PROFESSION_INFO,

PROFESSION_INFOS,

PROFESSION_INFO_get0_addProfessionInfo,

PROFESSION_INFO_get0_namingAuthority,

PROFESSION_INFO_get0_professionItems,

PROFESSION_INFO_get0_professionOIDs,

PROFESSION_INFO_get0_registrationNumber,

PROFESSION_INFO_set0_addProfessionInfo,

PROFESSION_INFO_set0_namingAuthority,

PROFESSION_INFO_set0_professionItems,

PROFESSION_INFO_set0_professionOIDs,

PROFESSION_INFO_set0_registrationNumber

- Accessors and settors for ADMISSION_SYNTAX

=head1 SYNOPSIS

 typedef struct NamingAuthority_st NAMING_AUTHORITY;

 typedef struct ProfessionInfo_st PROFESSION_INFO;

 typedef STACK_OF(PROFESSION_INFO) PROFESSION_INFOS;

 typedef struct Admissions_st ADMISSIONS;

 typedef struct AdmissionSyntax_st ADMISSION_SYNTAX;

 const ASN1_OBJECT *NAMING_AUTHORITY_get0_authorityId(

     const NAMING_AUTHORITY *n);

 void NAMING_AUTHORITY_set0_authorityId(NAMING_AUTHORITY *n,

     ASN1_OBJECT* namingAuthorityId);

 const ASN1_IA5STRING *NAMING_AUTHORITY_get0_authorityURL(

     const NAMING_AUTHORITY *n);

 void NAMING_AUTHORITY_set0_authorityURL(NAMING_AUTHORITY *n,

     ASN1_IA5STRING* namingAuthorityUrl);

 const ASN1_STRING *NAMING_AUTHORITY_get0_authorityText(

     const NAMING_AUTHORITY *n);

 void NAMING_AUTHORITY_set0_authorityText(NAMING_AUTHORITY *n,

     ASN1_STRING* namingAuthorityText);

 const GENERAL_NAME *ADMISSION_SYNTAX_get0_admissionAuthority(

     const ADMISSION_SYNTAX *as);

 void ADMISSION_SYNTAX_set0_admissionAuthority(

     ADMISSION_SYNTAX *as, GENERAL_NAME *aa);

 const STACK_OF(ADMISSIONS) *ADMISSION_SYNTAX_get0_contentsOfAdmissions(

     const ADMISSION_SYNTAX *as);

 void ADMISSION_SYNTAX_set0_contentsOfAdmissions(

     ADMISSION_SYNTAX *as, STACK_OF(ADMISSIONS) *a);

 const GENERAL_NAME *ADMISSIONS_get0_admissionAuthority(const ADMISSIONS *a);

 void ADMISSIONS_set0_admissionAuthority(ADMISSIONS *a, GENERAL_NAME *aa);

 const NAMING_AUTHORITY *ADMISSIONS_get0_namingAuthority(const ADMISSIONS *a);

 void ADMISSIONS_set0_namingAuthority(ADMISSIONS *a, NAMING_AUTHORITY *na);

 const PROFESSION_INFOS *ADMISSIONS_get0_professionInfos(const ADMISSIONS *a);

 void ADMISSIONS_set0_professionInfos(ADMISSIONS *a, PROFESSION_INFOS *pi);

 const ASN1_OCTET_STRING *PROFESSION_INFO_get0_addProfessionInfo(

     const PROFESSION_INFO *pi);

 void PROFESSION_INFO_set0_addProfessionInfo(

     PROFESSION_INFO *pi, ASN1_OCTET_STRING *aos);

 const NAMING_AUTHORITY *PROFESSION_INFO_get0_namingAuthority(

     const PROFESSION_INFO *pi);

 void PROFESSION_INFO_set0_namingAuthority(

     PROFESSION_INFO *pi, NAMING_AUTHORITY *na);

 const STACK_OF(ASN1_STRING) *PROFESSION_INFO_get0_professionItems(

     const PROFESSION_INFO *pi);

 void PROFESSION_INFO_set0_professionItems(

     PROFESSION_INFO *pi, STACK_OF(ASN1_STRING) *as);

 const STACK_OF(ASN1_OBJECT) *PROFESSION_INFO_get0_professionOIDs(

     const PROFESSION_INFO *pi);

 void PROFESSION_INFO_set0_professionOIDs(

     PROFESSION_INFO *pi, STACK_OF(ASN1_OBJECT) *po);

 const ASN1_PRINTABLESTRING *PROFESSION_INFO_get0_registrationNumber(

     const PROFESSION_INFO *pi);

 void PROFESSION_INFO_set0_registrationNumber(

     PROFESSION_INFO *pi, ASN1_PRINTABLESTRING *rn);

=head1 DESCRIPTION

The B<PROFESSION_INFOS>, B<ADMISSION_SYNTAX>, B<ADMISSIONS>, and

B<PROFESSION_INFO> types are opaque structures representing the

analogous types defined in the Common PKI Specification published

by L<https://www.t7ev.org>.

Knowledge of those structures and their semantics is assumed.

The conventional routines to convert between DER and the local format

are described in L<d2i_X509(3)>.

The conventional routines to allocate and free the types are defined

in L<X509_dup(3)>.

The B<PROFESSION_INFOS> type is a stack of B<PROFESSION_INFO>; see

L<DEFINE_STACK_OF(3)> for details.

The B<NAMING_AUTHORITY> type has an authority ID and URL, and text fields.

The NAMING_AUTHORITY_get0_authorityId(),

NAMING_AUTHORITY_get0_get0_authorityURL(), and

NAMING_AUTHORITY_get0_get0_authorityText(), functions return pointers

to those values within the object.

The NAMING_AUTHORITY_set0_authorityId(),

NAMING_AUTHORITY_set0_get0_authorityURL(), and

NAMING_AUTHORITY_set0_get0_authorityText(),

functions free any existing value and set the pointer to the specified value.

The B<ADMISSION_SYNTAX> type has an authority name and a stack of

B<ADMISSION> objects.

The ADMISSION_SYNTAX_get0_admissionAuthority()

and ADMISSION_SYNTAX_get0_contentsOfAdmissions() functions return pointers

to those values within the object.

The

ADMISSION_SYNTAX_set0_admissionAuthority() and

ADMISSION_SYNTAX_set0_contentsOfAdmissions()

functions free any existing value and set the pointer to the specified value.

The B<ADMISSION> type has an authority name, authority object, and a

stack of B<PROFESSION_INFO> items.

The ADMISSIONS_get0_admissionAuthority(), ADMISSIONS_get0_namingAuthority(),

and ADMISSIONS_get0_professionInfos()

functions return pointers to those values within the object.

The

ADMISSIONS_set0_admissionAuthority(),

ADMISSIONS_set0_namingAuthority(), and

ADMISSIONS_set0_professionInfos()

functions free any existing value and set the pointer to the specified value.

The B<PROFESSION_INFO> type has a name authority, stacks of

profession Items and OIDs, a registration number, and additional

profession info.

The functions PROFESSION_INFO_get0_addProfessionInfo(),

PROFESSION_INFO_get0_namingAuthority(), PROFESSION_INFO_get0_professionItems(),

PROFESSION_INFO_get0_professionOIDs(), and

PROFESSION_INFO_get0_registrationNumber()

functions return pointers to those values within the object.

The

PROFESSION_INFO_set0_addProfessionInfo(),

PROFESSION_INFO_set0_namingAuthority(),

PROFESSION_INFO_set0_professionItems(),

PROFESSION_INFO_set0_professionOIDs(), and

PROFESSION_INFO_set0_registrationNumber()

functions free any existing value and set the pointer to the specified value.

=head1 RETURN VALUES

Described above.

Note that all of the I<get0> functions return a pointer to the internal data

structure and must not be freed.

=head1 SEE ALSO

L<X509_dup(3)>,

L<d2i_X509(3)>,

=head1 COPYRIGHT

Copyright 2017-2019 The OpenSSL Project Authors. All Rights Reserved.

Licensed under the OpenSSL license (the "License").  You may not use

this file except in compliance with the License.  You can obtain a copy

in the file LICENSE in the source distribution or at

L<https://www.openssl.org/source/license.html>.

=cut