| OBJ_nid2obj.3 (127131) | OBJ_nid2obj.3 (142429) |
|---|---|
| 1.\" Automatically generated by Pod::Man version 1.15 2.\" Wed Mar 17 09:38:36 2004 | 1.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.14 |
| 3.\" 4.\" Standard preamble: | 2.\" 3.\" Standard preamble: |
| 5.\" ====================================================================== | 4.\" ======================================================================== |
| 6.de Sh \" Subsection heading 7.br 8.if t .Sp 9.ne 5 10.PP 11\fB\\$1\fR 12.PP 13.. 14.de Sp \" Vertical space (when we can't use .PP) 15.if t .sp .5v 16.if n .sp 17.. | 5.de Sh \" Subsection heading 6.br 7.if t .Sp 8.ne 5 9.PP 10\fB\\$1\fR 11.PP 12.. 13.de Sp \" Vertical space (when we can't use .PP) 14.if t .sp .5v 15.if n .sp 16.. |
| 18.de Ip \" List item 19.br 20.ie \\n(.$>=3 .ne \\$3 21.el .ne 3 22.IP "\\$1" \\$2 23.. | |
| 24.de Vb \" Begin verbatim text 25.ft CW 26.nf 27.ne \\$1 28.. 29.de Ve \" End verbatim text 30.ft R | 17.de Vb \" Begin verbatim text 18.ft CW 19.nf 20.ne \\$1 21.. 22.de Ve \" End verbatim text 23.ft R |
| 31 | |
| 32.fi 33.. 34.\" Set up some character translations and predefined strings. \*(-- will 35.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left 36.\" double quote, and \*(R" will give a right double quote. | will give a | 24.fi 25.. 26.\" Set up some character translations and predefined strings. \*(-- will 27.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left 28.\" double quote, and \*(R" will give a right double quote. | will give a |
| 37.\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used 38.\" to do unbreakable dashes and therefore won't be available. \*(C` and 39.\" \*(C' expand to `' in nroff, nothing in troff, for use with C<> | 29.\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used to 30.\" do unbreakable dashes and therefore won't be available. \*(C` and \*(C' 31.\" expand to `' in nroff, nothing in troff, for use with C<>. |
| 40.tr \(*W-|\(bv\*(Tr 41.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' 42.ie n \{\ 43. ds -- \(*W- 44. ds PI pi 45. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch 46. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch 47. ds L" "" 48. ds R" "" 49. ds C` "" 50. ds C' "" 51'br\} 52.el\{\ 53. ds -- \|\(em\| 54. ds PI \(*p 55. ds L" `` 56. ds R" '' 57'br\} 58.\" | 32.tr \(*W-|\(bv\*(Tr 33.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' 34.ie n \{\ 35. ds -- \(*W- 36. ds PI pi 37. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch 38. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch 39. ds L" "" 40. ds R" "" 41. ds C` "" 42. ds C' "" 43'br\} 44.el\{\ 45. ds -- \|\(em\| 46. ds PI \(*p 47. ds L" `` 48. ds R" '' 49'br\} 50.\" |
| 59.\" If the F register is turned on, we'll generate index entries on stderr 60.\" for titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and 61.\" index entries marked with X<> in POD. Of course, you'll have to process 62.\" the output yourself in some meaningful fashion. | 51.\" If the F register is turned on, we'll generate index entries on stderr for 52.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index 53.\" entries marked with X<> in POD. Of course, you'll have to process the 54.\" output yourself in some meaningful fashion. |
| 63.if \nF \{\ 64. de IX 65. tm Index:\\$1\t\\n%\t"\\$2" 66.. 67. nr % 0 68. rr F 69.\} 70.\" | 55.if \nF \{\ 56. de IX 57. tm Index:\\$1\t\\n%\t"\\$2" 58.. 59. nr % 0 60. rr F 61.\} 62.\" |
| 71.\" For nroff, turn off justification. Always turn off hyphenation; it 72.\" makes way too many mistakes in technical documents. | 63.\" For nroff, turn off justification. Always turn off hyphenation; it makes 64.\" way too many mistakes in technical documents. |
| 73.hy 0 74.if n .na 75.\" 76.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). 77.\" Fear. Run. Save yourself. No user-serviceable parts. | 65.hy 0 66.if n .na 67.\" 68.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). 69.\" Fear. Run. Save yourself. No user-serviceable parts. |
| 78.bd B 3 | |
| 79. \" fudge factors for nroff and troff 80.if n \{\ 81. ds #H 0 82. ds #V .8m 83. ds #F .3m 84. ds #[ \f1 85. ds #] \fP 86.\} --- 43 unchanged lines hidden (view full) --- 130. ds d- d\h'-1'\(ga 131. ds D- D\h'-1'\(hy 132. ds th \o'bp' 133. ds Th \o'LP' 134. ds ae ae 135. ds Ae AE 136.\} 137.rm #[ #] #H #V #F C | 70. \" fudge factors for nroff and troff 71.if n \{\ 72. ds #H 0 73. ds #V .8m 74. ds #F .3m 75. ds #[ \f1 76. ds #] \fP 77.\} --- 43 unchanged lines hidden (view full) --- 121. ds d- d\h'-1'\(ga 122. ds D- D\h'-1'\(hy 123. ds th \o'bp' 124. ds Th \o'LP' 125. ds ae ae 126. ds Ae AE 127.\} 128.rm #[ #] #H #V #F C |
| 138.\" ====================================================================== | 129.\" ======================================================================== |
| 139.\" 140.IX Title "OBJ_nid2obj 3" | 130.\" 131.IX Title "OBJ_nid2obj 3" |
| 141.TH OBJ_nid2obj 3 "0.9.7d" "2004-03-17" "OpenSSL" 142.UC | 132.TH OBJ_nid2obj 3 "2005-02-24" "0.9.7d" "OpenSSL" |
| 143.SH "NAME" 144OBJ_nid2obj, OBJ_nid2ln, OBJ_nid2sn, OBJ_obj2nid, OBJ_txt2nid, OBJ_ln2nid, OBJ_sn2nid, | 133.SH "NAME" 134OBJ_nid2obj, OBJ_nid2ln, OBJ_nid2sn, OBJ_obj2nid, OBJ_txt2nid, OBJ_ln2nid, OBJ_sn2nid, |
| 145OBJ_cmp, OBJ_dup, OBJ_txt2obj, OBJ_obj2txt, OBJ_create, OBJ_cleanup \- \s-1ASN1\s0 object utility | 135OBJ_cmp, OBJ_dup, OBJ_txt2obj, OBJ_obj2txt, OBJ_create, OBJ_cleanup \- ASN1 object utility |
| 146functions 147.SH "SYNOPSIS" 148.IX Header "SYNOPSIS" 149.Vb 3 150\& ASN1_OBJECT * OBJ_nid2obj(int n); 151\& const char * OBJ_nid2ln(int n); 152\& const char * OBJ_nid2sn(int n); 153.Ve | 136functions 137.SH "SYNOPSIS" 138.IX Header "SYNOPSIS" 139.Vb 3 140\& ASN1_OBJECT * OBJ_nid2obj(int n); 141\& const char * OBJ_nid2ln(int n); 142\& const char * OBJ_nid2sn(int n); 143.Ve |
| 144.PP |
|
| 154.Vb 3 155\& int OBJ_obj2nid(const ASN1_OBJECT *o); 156\& int OBJ_ln2nid(const char *ln); 157\& int OBJ_sn2nid(const char *sn); 158.Ve | 145.Vb 3 146\& int OBJ_obj2nid(const ASN1_OBJECT *o); 147\& int OBJ_ln2nid(const char *ln); 148\& int OBJ_sn2nid(const char *sn); 149.Ve |
| 150.PP |
|
| 159.Vb 1 160\& int OBJ_txt2nid(const char *s); 161.Ve | 151.Vb 1 152\& int OBJ_txt2nid(const char *s); 153.Ve |
| 154.PP |
|
| 162.Vb 2 163\& ASN1_OBJECT * OBJ_txt2obj(const char *s, int no_name); 164\& int OBJ_obj2txt(char *buf, int buf_len, const ASN1_OBJECT *a, int no_name); 165.Ve | 155.Vb 2 156\& ASN1_OBJECT * OBJ_txt2obj(const char *s, int no_name); 157\& int OBJ_obj2txt(char *buf, int buf_len, const ASN1_OBJECT *a, int no_name); 158.Ve |
| 159.PP |
|
| 166.Vb 2 167\& int OBJ_cmp(const ASN1_OBJECT *a,const ASN1_OBJECT *b); 168\& ASN1_OBJECT * OBJ_dup(const ASN1_OBJECT *o); 169.Ve | 160.Vb 2 161\& int OBJ_cmp(const ASN1_OBJECT *a,const ASN1_OBJECT *b); 162\& ASN1_OBJECT * OBJ_dup(const ASN1_OBJECT *o); 163.Ve |
| 164.PP |
|
| 170.Vb 2 171\& int OBJ_create(const char *oid,const char *sn,const char *ln); 172\& void OBJ_cleanup(void); 173.Ve 174.SH "DESCRIPTION" 175.IX Header "DESCRIPTION" 176The \s-1ASN1\s0 object utility functions process \s-1ASN1_OBJECT\s0 structures which are 177a representation of the \s-1ASN1\s0 \s-1OBJECT\s0 \s-1IDENTIFIER\s0 (\s-1OID\s0) type. --- 42 unchanged lines hidden (view full) --- 220.PP 221For example the \s-1OID\s0 for commonName has the following definitions: 222.PP 223.Vb 3 224\& #define SN_commonName "CN" 225\& #define LN_commonName "commonName" 226\& #define NID_commonName 13 227.Ve | 165.Vb 2 166\& int OBJ_create(const char *oid,const char *sn,const char *ln); 167\& void OBJ_cleanup(void); 168.Ve 169.SH "DESCRIPTION" 170.IX Header "DESCRIPTION" 171The \s-1ASN1\s0 object utility functions process \s-1ASN1_OBJECT\s0 structures which are 172a representation of the \s-1ASN1\s0 \s-1OBJECT\s0 \s-1IDENTIFIER\s0 (\s-1OID\s0) type. --- 42 unchanged lines hidden (view full) --- 215.PP 216For example the \s-1OID\s0 for commonName has the following definitions: 217.PP 218.Vb 3 219\& #define SN_commonName "CN" 220\& #define LN_commonName "commonName" 221\& #define NID_commonName 13 222.Ve |
| 223.PP |
|
| 228New objects can be added by calling \fIOBJ_create()\fR. 229.PP 230Table objects have certain advantages over other objects: for example 231their NIDs can be used in a C language switch statement. They are 232also static constant structures which are shared: that is there 233is only a single constant structure for each table object. 234.PP 235Objects which are not in the table have the \s-1NID\s0 value NID_undef. --- 4 unchanged lines hidden (view full) --- 240.SH "EXAMPLES" 241.IX Header "EXAMPLES" 242Create an object for \fBcommonName\fR: 243.PP 244.Vb 2 245\& ASN1_OBJECT *o; 246\& o = OBJ_nid2obj(NID_commonName); 247.Ve | 224New objects can be added by calling \fIOBJ_create()\fR. 225.PP 226Table objects have certain advantages over other objects: for example 227their NIDs can be used in a C language switch statement. They are 228also static constant structures which are shared: that is there 229is only a single constant structure for each table object. 230.PP 231Objects which are not in the table have the \s-1NID\s0 value NID_undef. --- 4 unchanged lines hidden (view full) --- 236.SH "EXAMPLES" 237.IX Header "EXAMPLES" 238Create an object for \fBcommonName\fR: 239.PP 240.Vb 2 241\& ASN1_OBJECT *o; 242\& o = OBJ_nid2obj(NID_commonName); 243.Ve |
| 244.PP |
|
| 248Check if an object is \fBcommonName\fR 249.PP 250.Vb 2 251\& if (OBJ_obj2nid(obj) == NID_commonName) 252\& /* Do something */ 253.Ve | 245Check if an object is \fBcommonName\fR 246.PP 247.Vb 2 248\& if (OBJ_obj2nid(obj) == NID_commonName) 249\& /* Do something */ 250.Ve |
| 251.PP |
|
| 254Create a new \s-1NID\s0 and initialize an object from it: 255.PP 256.Vb 3 257\& int new_nid; 258\& ASN1_OBJECT *obj; 259\& new_nid = OBJ_create("1.2.3.4", "NewOID", "New Object Identifier"); 260.Ve | 252Create a new \s-1NID\s0 and initialize an object from it: 253.PP 254.Vb 3 255\& int new_nid; 256\& ASN1_OBJECT *obj; 257\& new_nid = OBJ_create("1.2.3.4", "NewOID", "New Object Identifier"); 258.Ve |
| 259.PP |
|
| 261.Vb 1 262\& obj = OBJ_nid2obj(new_nid); 263.Ve | 260.Vb 1 261\& obj = OBJ_nid2obj(new_nid); 262.Ve |
| 263.PP |
|
| 264Create a new object directly: 265.PP 266.Vb 1 267\& obj = OBJ_txt2obj("1.2.3.4", 1); 268.Ve 269.SH "BUGS" 270.IX Header "BUGS" 271\&\fIOBJ_obj2txt()\fR is awkward and messy to use: it doesn't follow the --- 9 unchanged lines hidden (view full) --- 281.PP 282\&\fIOBJ_nid2ln()\fR and \fIOBJ_nid2sn()\fR returns a valid string or \fB\s-1NULL\s0\fR 283on error. 284.PP 285\&\fIOBJ_obj2nid()\fR, \fIOBJ_ln2nid()\fR, \fIOBJ_sn2nid()\fR and \fIOBJ_txt2nid()\fR return 286a \s-1NID\s0 or \fBNID_undef\fR on error. 287.SH "SEE ALSO" 288.IX Header "SEE ALSO" | 264Create a new object directly: 265.PP 266.Vb 1 267\& obj = OBJ_txt2obj("1.2.3.4", 1); 268.Ve 269.SH "BUGS" 270.IX Header "BUGS" 271\&\fIOBJ_obj2txt()\fR is awkward and messy to use: it doesn't follow the --- 9 unchanged lines hidden (view full) --- 281.PP 282\&\fIOBJ_nid2ln()\fR and \fIOBJ_nid2sn()\fR returns a valid string or \fB\s-1NULL\s0\fR 283on error. 284.PP 285\&\fIOBJ_obj2nid()\fR, \fIOBJ_ln2nid()\fR, \fIOBJ_sn2nid()\fR and \fIOBJ_txt2nid()\fR return 286a \s-1NID\s0 or \fBNID_undef\fR on error. 287.SH "SEE ALSO" 288.IX Header "SEE ALSO" |
| 289ERR_get_error(3) | 289\&\fIERR_get_error\fR\|(3) |
| 290.SH "HISTORY" 291.IX Header "HISTORY" 292\&\s-1TBA\s0 | 290.SH "HISTORY" 291.IX Header "HISTORY" 292\&\s-1TBA\s0 |