~ubuntu-branches/ubuntu/dapper/curl/dapper-updates

« back to all changes in this revision

Viewing changes to docs/libcurl/curl_global_init.html

  • Committer: Bazaar Package Importer
  • Author(s): Domenico Andreoli
  • Date: 2002-03-12 19:06:21 UTC
  • Revision ID: james.westby@ubuntu.com-20020312190621-iqx7k9cipo5d0ifr
Tags: upstream-7.9.5
Import upstream version 7.9.5

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
<HTML>
 
2
<BODY>
 
3
<PRE>
 
4
<!-- Manpage converted by man2html 3.0.1 -->
 
5
 
 
6
</PRE>
 
7
<H2>NAME</H2><PRE>
 
8
     curl_global_init - Global libcurl initialisation
 
9
 
 
10
 
 
11
</PRE>
 
12
<H2>SYNOPSIS</H2><PRE>
 
13
     <B>#include</B> <B>&lt;curl/curl.h&gt;</B>
 
14
 
 
15
     <B>CURLcode</B> <B>curl_global_init(long</B> <I>flags</I><B>);</B>
 
16
 
 
17
 
 
18
</PRE>
 
19
<H2>DESCRIPTION</H2><PRE>
 
20
     This function should only be called once (no matter how many
 
21
     threads or libcurl sessions that'll be used) by every appli�
 
22
     cation that uses libcurl.
 
23
 
 
24
     If  this function hasn't been invoked when <I>curl</I><B>_</B><I>easy</I><B>_</B><I>init</I> is
 
25
     called, it will be done automatically by libcurl.
 
26
 
 
27
     The flags option is a bit pattern that tells  libcurl  exact
 
28
     what  features  to init, as described below. Set the desired
 
29
     bits by ORing the values together.
 
30
 
 
31
     You must however <B>always</B> use  the  <I>curl</I><B>_</B><I>global</I><B>_</B><I>cleanup</I>  func�
 
32
     tion,  as  that  cannot  be  called automatically for you by
 
33
     libcurl.
 
34
 
 
35
     Calling this function  more  than  once  will  cause  unpre�
 
36
     dictable results.
 
37
 
 
38
     This function was added in libcurl 7.8.
 
39
 
 
40
 
 
41
</PRE>
 
42
<H2>FLAGS</H2><PRE>
 
43
     <B>CURL_GLOBAL_ALL</B>
 
44
          Initialize  everything  possible.  This  sets all known
 
45
          bits.
 
46
 
 
47
     <B>CURL_GLOBAL_SSL</B>
 
48
          Initialize SSL
 
49
 
 
50
     <B>CURL_GLOBAL_WIN32</B>
 
51
          Initialize  the  Win32  socket  libraries.  (added   in
 
52
          libcurl 7.8.1)
 
53
 
 
54
     <B>CURL_GLOBAL_NOTHING</B>
 
55
          Initialise nothing extra. This sets no bit.
 
56
 
 
57
 
 
58
</PRE>
 
59
<H2>RETURN VALUE</H2><PRE>
 
60
     If  this function returns non-zero, something went wrong and
 
61
     you cannot use the other curl functions.
 
62
 
 
63
 
 
64
</PRE>
 
65
<H2>SEE ALSO</H2><PRE>
 
66
     <B>curl_global_cleanup(3)</B>,
 
67
 
 
68
 
 
69
 
 
70
</PRE>
 
71
<H2>BUGS</H2><PRE>
 
72
     None.
 
73
 
 
74
 
 
75
 
 
76
 
 
77
 
 
78
 
 
79
 
 
80
 
 
81
 
 
82
 
 
83
 
 
84
 
 
85
 
 
86
 
 
87
 
 
88
 
 
89
 
 
90
 
 
91
 
 
92
 
 
93
 
 
94
 
 
95
 
 
96
 
 
97
 
 
98
 
 
99
 
 
100
 
 
101
 
 
102
 
 
103
 
 
104
 
 
105
 
 
106
 
 
107
 
 
108
 
 
109
 
 
110
 
 
111
 
 
112
 
 
113
 
 
114
 
 
115
 
 
116
 
 
117
 
 
118
 
 
119
 
 
120
 
 
121
 
 
122
 
 
123
</PRE>
 
124
<HR>
 
125
<ADDRESS>
 
126
Man(1) output converted with
 
127
<a href="http://www.oac.uci.edu/indiv/ehood/man2html.html">man2html</a>
 
128
</ADDRESS>
 
129
</BODY>
 
130
</HTML>