Merge from vendor branch GCC:
[dragonfly.git] / secure / lib / libcrypto / man / OBJ_nid2obj.3
index 4d7eb58..6542df6 100644 (file)
@@ -1,8 +1,7 @@
-.\" Automatically generated by Pod::Man version 1.15
-.\" Wed Feb 19 16:42:55 2003
+.\" Automatically generated by Pod::Man 2.12 (Pod::Simple 3.05)
 .\"
 .\" Standard preamble:
-.\" ======================================================================
+.\" ========================================================================
 .de Sh \" Subsection heading
 .br
 .if t .Sp
 .if t .sp .5v
 .if n .sp
 ..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
 .de Vb \" Begin verbatim text
 .ft CW
 .nf
 ..
 .de Ve \" End verbatim text
 .ft R
-
 .fi
 ..
 .\" Set up some character translations and predefined strings.  \*(-- will
 .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
-.\" double quote, and \*(R" will give a right double quote.  | will give a
-.\" real vertical bar.  \*(C+ will give a nicer C++.  Capital omega is used
-.\" to do unbreakable dashes and therefore won't be available.  \*(C` and
-.\" \*(C' expand to `' in nroff, nothing in troff, for use with C<>
-.tr \(*W-|\(bv\*(Tr
+.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
+.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
+.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
+.\" nothing in troff, for use with C<>.
+.tr \(*W-
 .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
 .ie n \{\
 .    ds -- \(*W-
 .    ds R" ''
 'br\}
 .\"
-.\" If the F register is turned on, we'll generate index entries on stderr
-.\" for titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and
-.\" index entries marked with X<> in POD.  Of course, you'll have to process
-.\" the output yourself in some meaningful fashion.
+.\" If the F register is turned on, we'll generate index entries on stderr for
+.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
+.\" entries marked with X<> in POD.  Of course, you'll have to process the
+.\" output yourself in some meaningful fashion.
 .if \nF \{\
 .    de IX
 .    tm Index:\\$1\t\\n%\t"\\$2"
 .    rr F
 .\}
 .\"
-.\" For nroff, turn off justification.  Always turn off hyphenation; it
-.\" makes way too many mistakes in technical documents.
-.hy 0
-.if n .na
-.\"
 .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
 .\" Fear.  Run.  Save yourself.  No user-serviceable parts.
-.bd B 3
 .    \" fudge factors for nroff and troff
 .if n \{\
 .    ds #H 0
 .    ds Ae AE
 .\}
 .rm #[ #] #H #V #F C
-.\" ======================================================================
+.\" ========================================================================
 .\"
 .IX Title "OBJ_nid2obj 3"
-.TH OBJ_nid2obj 3 "0.9.7a" "2003-02-19" "OpenSSL"
-.UC
+.TH OBJ_nid2obj 3 "2007-10-24" "0.9.8g" "OpenSSL"
+.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
+.\" way too many mistakes in technical documents.
+.if n .ad l
+.nh
 .SH "NAME"
 OBJ_nid2obj, OBJ_nid2ln, OBJ_nid2sn, OBJ_obj2nid, OBJ_txt2nid, OBJ_ln2nid, OBJ_sn2nid,
-OBJ_cmp, OBJ_dup, OBJ_txt2obj, OBJ_obj2txt, OBJ_create, OBJ_cleanup \- \s-1ASN1\s0 object utility
+OBJ_cmp, OBJ_dup, OBJ_txt2obj, OBJ_obj2txt, OBJ_create, OBJ_cleanup \- ASN1 object utility
 functions
 .SH "SYNOPSIS"
 .IX Header "SYNOPSIS"
@@ -150,24 +139,19 @@ functions
 \& ASN1_OBJECT * OBJ_nid2obj(int n);
 \& const char *  OBJ_nid2ln(int n);
 \& const char *  OBJ_nid2sn(int n);
-.Ve
-.Vb 3
+\&
 \& int OBJ_obj2nid(const ASN1_OBJECT *o);
 \& int OBJ_ln2nid(const char *ln);
 \& int OBJ_sn2nid(const char *sn);
-.Ve
-.Vb 1
+\&
 \& int OBJ_txt2nid(const char *s);
-.Ve
-.Vb 2
+\&
 \& ASN1_OBJECT * OBJ_txt2obj(const char *s, int no_name);
 \& int OBJ_obj2txt(char *buf, int buf_len, const ASN1_OBJECT *a, int no_name);
-.Ve
-.Vb 2
+\&
 \& int OBJ_cmp(const ASN1_OBJECT *a,const ASN1_OBJECT *b);
 \& ASN1_OBJECT * OBJ_dup(const ASN1_OBJECT *o);
-.Ve
-.Vb 2
+\&
 \& int OBJ_create(const char *oid,const char *sn,const char *ln);
 \& void OBJ_cleanup(void);
 .Ve
@@ -225,6 +209,7 @@ For example the \s-1OID\s0 for commonName has the following definitions:
 \& #define LN_commonName                   "commonName"
 \& #define NID_commonName                  13
 .Ve
+.PP
 New objects can be added by calling \fIOBJ_create()\fR.
 .PP
 Table objects have certain advantages over other objects: for example
@@ -245,22 +230,24 @@ Create an object for \fBcommonName\fR:
 \& ASN1_OBJECT *o;
 \& o = OBJ_nid2obj(NID_commonName);
 .Ve
+.PP
 Check if an object is \fBcommonName\fR
 .PP
 .Vb 2
 \& if (OBJ_obj2nid(obj) == NID_commonName)
 \&        /* Do something */
 .Ve
+.PP
 Create a new \s-1NID\s0 and initialize an object from it:
 .PP
 .Vb 3
 \& int new_nid;
 \& ASN1_OBJECT *obj;
 \& new_nid = OBJ_create("1.2.3.4", "NewOID", "New Object Identifier");
-.Ve
-.Vb 1
+\&
 \& obj = OBJ_nid2obj(new_nid);
 .Ve
+.PP
 Create a new object directly:
 .PP
 .Vb 1
@@ -286,7 +273,7 @@ on error.
 a \s-1NID\s0 or \fBNID_undef\fR on error.
 .SH "SEE ALSO"
 .IX Header "SEE ALSO"
-ERR_get_error(3)
+\&\fIERR_get_error\fR\|(3)
 .SH "HISTORY"
 .IX Header "HISTORY"
 \&\s-1TBA\s0