Manual Pages for UNIX Operating System command usage for man X509_NAME_get_index_by_OBJ

OpenSSL                      X509_NAME_get_index_by_NID(3openssl)



NNNNAAAAMMMMEEEE
     X509_NAME_get_index_by_NID, X509_NAME_get_index_by_OBJ,
     X509_NAME_get_entry, X509_NAME_entry_count,
     X509_NAME_get_text_by_NID, X509_NAME_get_text_by_OBJ -
     X509_NAME lookup and enumeration functions

SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
      #include 

      int X509_NAME_get_index_by_NID(X509_NAME *name,int nid,int lastpos);
      int X509_NAME_get_index_by_OBJ(X509_NAME *name,ASN1_OBJECT *obj, int lastpos);

      int X509_NAME_entry_count(X509_NAME *name);
      X509_NAME_ENTRY *X509_NAME_get_entry(X509_NAME *name, int loc);

      int X509_NAME_get_text_by_NID(X509_NAME *name, int nid, char *buf,int len);
      int X509_NAME_get_text_by_OBJ(X509_NAME *name, ASN1_OBJECT *obj, char *buf,int len);


DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
     These functions allow an XXXX555500009999_NNNNAAAAMMMMEEEE structure to be examined.
     The XXXX555500009999_NNNNAAAAMMMMEEEE structure is the same as the NNNNaaaammmmeeee type defined
     in RFC2459 (and elsewhere) and used for example in
     certificate subject and issuer names.

     X509_NAME_get_index_by_NID() and
     X509_NAME_get_index_by_OBJ() retrieve the next index
     matching nnnniiiidddd or oooobbbbjjjj after llllaaaassssttttppppoooossss. llllaaaassssttttppppoooossss should initially
     be set to -1. If there are no more entries -1 is returned.

     X509_NAME_entry_count() returns the total number of entries
     in nnnnaaaammmmeeee.

     X509_NAME_get_entry() retrieves the XXXX555500009999_NNNNAAAAMMMMEEEE_EEEENNNNTTTTRRRRYYYY from
     nnnnaaaammmmeeee corresponding to index lllloooocccc. Acceptable values for lllloooocccc
     run from 0 to (X509_NAME_entry_count(name) - 1). The value
     returned is an internal pointer which must not be freed.

     X509_NAME_get_text_by_NID(), X509_NAME_get_text_by_OBJ()
     retrieve the "text" from the first entry in nnnnaaaammmmeeee which
     matches nnnniiiidddd or oooobbbbjjjj, if no such entry exists -1 is returned.
     At most lllleeeennnn bytes will be written and the text written to
     bbbbuuuuffff will be null terminated. The length of the output string
     written is returned excluding the terminating null. If bbbbuuuuffff
     is  then the amount of space needed in bbbbuuuuffff (excluding
     the final null) is returned.

NNNNOOOOTTTTEEEESSSS
     X509_NAME_get_text_by_NID() and X509_NAME_get_text_by_OBJ()
     are legacy functions which have various limitations which
     make them of minimal use in practice. They can only find the
     first matching entry and will copy the contents of the field



27/Mar/2010            Last change: 0.9.8o                      1






OpenSSL                      X509_NAME_get_index_by_NID(3openssl)



     verbatim: this can be highly confusing if the target is a
     muticharacter string type like a BMPString or a UTF8String.

     For a more general solution X509_NAME_get_index_by_NID() or
     X509_NAME_get_index_by_OBJ() should be used followed by
     X509_NAME_get_entry() on any matching indices and then the
     various XXXX555500009999_NNNNAAAAMMMMEEEE_EEEENNNNTTTTRRRRYYYY utility functions on the result.

EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
     Process all entries:

      int i;
      X509_NAME_ENTRY *e;

      for (i = 0; i < X509_NAME_entry_count(nm); i++)
             {
             e = X509_NAME_get_entry(nm, i);
             /* Do something with e */
             }

     Process all commonName entries:

      int loc;
      X509_NAME_ENTRY *e;

      loc = -1;
      for (;;)
             {
             lastpos = X509_NAME_get_index_by_NID(nm, NID_commonName, lastpos);
             if (lastpos == -1)
                     break;
             e = X509_NAME_get_entry(nm, lastpos);
             /* Do something with e */
             }


RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEESSSS
     X509_NAME_get_index_by_NID() and
     X509_NAME_get_index_by_OBJ() return the index of the next
     matching entry or -1 if not found.

     X509_NAME_entry_count() returns the total number of entries.

     X509_NAME_get_entry() returns an XXXX555500009999_NNNNAAAAMMMMEEEE pointer to the
     requested entry or NNNNUUUULLLLLLLL if the index is invalid.

SSSSEEEEEEEE AAAALLLLSSSSOOOO
     ERR_get_error(3), d2i_X509_NAME(3)

HHHHIIIISSSSTTTTOOOORRRRYYYY
     TBA




27/Mar/2010            Last change: 0.9.8o                      2






OpenSSL                      X509_NAME_get_index_by_NID(3openssl)























































27/Mar/2010            Last change: 0.9.8o                      3