~ubuntu-branches/ubuntu/trusty/tclcurl/trusty : revision 12

1

<HTML><HEAD><TITLE>Manpage of TclCurl</TITLE>

2

</HEAD><BODY>

3

<H1>TclCurl</H1>

4

Section: Easy inteface (n) Updated: 8 September 2008

4

Section: Easy inteface (n) Updated: 03 October 2011

5

6

<hr>

7

8

9

TclCurl: - get a URL with FTP, FTPS, HTTP, HTTPS, SCP, SFTP, TFTP, TELNET, DICT, FILE or LDAP syntax.

9

TclCurl: - get a URL with FTP, FTPS, HTTP, HTTPS, SCP, SFTP, TFTP, TELNET, DICT, FILE, LDAP,

10

LDAPS, IMAP, IMAPS, POP, POP3, SMTP, SMTPS and gopher syntax.

10

11

11

12

<H2>SYNOPSIS</H2>

12

13

61

62

62

63

<H2>DESCRIPTION</H2>

63

64

The TclCurl extension gives Tcl programmers access to the libcurl

65

library written by <a href="http://daniel.haxx.se">Daniel Stenberg</a>, with it you can download urls,

66

upload them and many other neat tricks, for more information check

67

65

The TclCurl extension gives Tcl programmers access to the <a href="http://curl.haxx.se/libcurl/">libcurl</a>

66

library written by <a href="http://daniel.haxx.se/">Daniel Stenberg</a>, with it you can download urls,

67

upload them and many other neat tricks.

68

69

70

147

<DT>-noprogress

148

149

<DD>

150

A 1 tells the extension to turn on the built-in progress meter.

151

Nowadays it is turn off by default.

150

A 1 tells the extension to turn on the progress meter

151

completely. It will also prevent the progessproc from getting called.

152

153

<DT>-nosignal

154

158

option is mainly here to allow multi-threaded unix applications to still

159

set/use all timeout options etc, without risking getting signals.

160

161

162

</DL>

161

If this option is set and libcurl has been built with the standard name resolver,

162

timeouts will not occur while the name resolve takes place. Consider building

163

libcurl with c-ares support to enable asynchronous DNS lookups, which enables

164

nice timeouts for name resolves without signals.

165

166

Setting nosignal to 1 makes libcurl NOT ask the system to ignore

167

SIGPIPE signals, which otherwise are sent by the system when trying to send

168

data to a socket which is closed in the other end. libcurl makes an effort to

169

never cause such SIGPIPEs to trigger, but some operating systems have no way

170

to avoid them and even on those that have there are some corner cases when

171

they may still happen, contrary to our desire. In addition, using

172

ntlm_Wb authentication could cause a SIGCHLD signal to be raised.

173

174

<DT>-wildcard

175

176

<DD>

177

Set this option to 1 if you want to transfer multiple files according to a

178

file name pattern. The pattern can be specified as part of the

179

-url option, using an fnmatch-like pattern (Shell Pattern

180

Matching) in the last part of URL (file name).

181

182

By default, TClCurl uses its internal wildcard matching implementation. You

183

can provide your own matching function by the -fnmatchproc option.

184

185

This feature is only supported by the FTP download for now.

186

187

A brief introduction of its syntax follows:

188

189

190

<DT>* - ASTERISK<DD>

191

ftp://example.com/some/path/*.txt (for all txt's from the root directory)

192

</DL>

193

</DL>

194

195

196

197

<DT>? - QUESTION MARK<DD>

198

Question mark matches any (exactly one) character.

199

200

ftp://example.com/some/path/photo?.jpeg

201

</DL>

202

</DL>

203

204

205

206

<DT>[ - BRACKET EXPRESSION<DD>

207

The left bracket opens a bracket expression. The question mark and asterisk have

208

no special meaning in a bracket expression. Each bracket expression ends by the

209

right bracket and matches exactly one character. Some examples follow:

210

211

[a-zA-Z0-9] or [f-gF-G] - character interval

212

213

[abc] - character enumeration

214

215

[^abc] or [!abc] - negation

216

217

[[:name:]] class expression. Supported classes are

218

alnum,lower, space, alpha, digit, print,

219

upper, blank, graph, xdigit.

220

221

[][-!^] - special case - matches only '-', ']', '[', '!' or '^'. These

222

characters have no special purpose.

223

224

[\[\]\\] - escape syntax. Matches '[', ']' or '\'.

225

226

Using the rules above, a file name pattern can be constructed:

227

228

ftp://example.com/some/path/[a-z[:upper:]\\].jpeg

229

</DL>

230

</DL>

231

232

</DL>

233

234

235

163

236

164

237

<H2>Callback options</H2>

165

238

190

263

should return the actual number of bytes read, or '0' if you want to

191

264

stop the transfer.

192

265

266

If you stop the current transfer by returning 0 "pre-maturely" (i.e before

267

the server expected it, like when you've said you will upload N bytes and

268

you upload less than N bytes), you may experience that the server "hangs"

269

waiting for the rest of the data that won't come.

270

271

Bugs: when doing TFTP uploads, you must return the exact amount of data

272

that the callback wants, or it will be considered the final packet by the

273

server end and the transfer will end there.

274

193

275

<DT>-infile

194

276

195

277

<DD>

199

281

200

282

<DD>

201

283

Name of the Tcl procedure that will invoked by TclCurl with a frequent

202

interval during operation (roughly once per second), no matter if data

284

interval during operation (roughly once per second or sooner), no matter if data

203

285

is being transfered or not. Unknown/unused

204

286

argument values passed to the callback will be set to zero (like if you

205

287

only download data, the upload size will remain 0), the prototype of the

227

309

only complete lines are written. Parsing headers should be easy enough using

228

310

this.

229

311

312

See also the headervar option to get the headers into an array.

313

230

314

<DT>-debugproc

231

315

232

316

<DD>

242

326

1 incoming header, 2 outgoing header, 3 incoming data, 4 outgoing data,

243

327

5 incoming SSL data, 6 outgoing SSL data).

244

328

329

<DT>-chunkbgnproc

330

331

<DD>

332

Name of the procedure that will be called before a file will be transfered by

333

ftp, it should match the following prototype:

334

335

ChunkBgnProc {remains}

336

337

338

339

Where remains is the number of files left to be transfered (or skipped)

340

341

This callback makes sense only when using the -wildcard option.

342

343

<DT>-chunkbgnvar

344

345

<DD>

346

Name of the variable in the global scope that will contain the data of the file about

347

to be transfered. If you don't use this option '::fileData' will be used.

348

349

The available data is: filename, filetype (file, directory, symlink, device block, device char,

350

named pipe, socket, door or error if it couldn't be identified), time, perm, uid, gid,

351

size, hardlinks and flags.

352

353

<DT>-chunkendproc

354

355

<DD>

356

Name of the procedure that will be called after a file is transfered (or skipped)

357

by ftp, it should match the following prototype:

358

359

ChunkEndProc {}

360

361

362

It should return '0' if everyhting is fine and '1' if some error occurred.

363

364

<DT>-fnmatchProc

365

366

<DD>

367

Name of the procedure that will be called instead of the internal wildcard

368

matching function, it should match the following prototype:

369

370

FnMatchProc {pattern string}

371

372

373

Returns '0' if it matches, '1' if it doesn't.

374

245

375

</DL>

246

376

247

377

<H2>Error Options</H2>

290

420

attempt to guess which protocol to use based on the given host name. If the

291

421

given protocol of the set URL is not supported, TclCurl will return the

292

422

unsupported protocol error when you call perform. Use

293

curl::versioninfo for detailed info on which protocols that are supported.

294

295

NOTE: this the one option required to be set

296

before

297

perform

298

299

is called.

423

curl::versioninfo for detailed info on which protocols are supported.

424

425

Starting with version 7.22.0, the fragment part of the URI will not be send as

426

part of the path, which was the case previously.

427

428

NOTE: this is the one option required to be set before perform is called.

429

430

<DT>-protocols

431

432

<DD>

433

Pass a list in lowecase of protocols to limit what protocols TclCurl may use in the transfer. This

434

allows you to have a TclCurl built to support a wide range of protocols but still limit

435

specific transfers to only be allowed to use a subset of them.

436

437

Accepted protocols are 'http', 'https', 'ftp', 'ftps', 'scp', 'sftp', 'telnet', 'ldap',

438

439

and 'all'.

440

441

<DT>-redirprotocols

442

443

<DD>

444

Pass a list in lowercase of accepted protocols to limit what protocols TclCurl may use in a transfer

445

that it follows to in a redirect when -followlocation is enabled. This allows you

446

to limit specific transfers to only be allowed to use a subset of protocols in redirections.

447

448

By default TclCurl will allow all protocols except for FILE and SCP. This is a difference

449

compared to pre-7.19.4 versions which unconditionally would follow to all protocols supported.

300

450

301

451

<DT>-proxy

302

452

328

478

environment variables, include protocol prefix (<A HREF="http://)">http://)</A> and embedded

329

479

user + password.

330

480

481

Since 7.22.0, the proxy string may be specified with a protocol:// prefix to

482

specify alternative proxy protocols. Use socks4://, socks4a://, socks5:// or

483

socks5h:// (the last one to enable socks5 and asking the proxy to do the resolving)

484

to request the specific SOCKS version

485

to be used. No protocol specified, http:// and all others will be treated as

486

HTTP proxies.

487

331

488

<DT>-proxyport

332

489

333

490

<DD>

334

491

Use this option to set the proxy port to use unless it is specified in

335

the proxy string by -proxy.

492

the proxy string by -proxy. If not specified, TclCurl will default

493

-to using port 1080 for proxies.

336

494

337

495

<DT>-proxytype

338

496

339

497

<DD>

340

Pass the type of the proxy. Available options are 'http', 'socks4', 'socks4a'

341

and 'socks5', with the HTTP one being default.

498

Pass the type of the proxy. Available options are 'http', 'http1.0', 'socks4', 'socks4a',

499

<BLOCKQUOTE>man2html: unable to open or read file

500

501

</BLOCKQUOTE>

502

503

504

If you set it to http1.0, it will only affect how libcurl speaks to a proxy

505

when CONNECT is used. The HTTP version used for "regular" HTTP requests is instead

506

controled with httpversion.

507

508

<DT>-noproxy

509

510

<DD>

511

Pass a string, a comma-separated list of hosts which do not use a proxy, if one

512

is specified. The only wildcard is a single * character, which matches all hosts,

513

and effectively disables the proxy. Each name in this list is matched as either

514

a domain which contains the hostname, or the hostname itself. For example, local.com

515

would match local.com, local.com:80, and www.local.com, but not http://www.notlocal.com.

342

516

343

517

<DT>-httpproxytunnel

344

518

347

521

operations through the given HTTP proxy. Do note that there is a big

348

522

difference between using a proxy and tunneling through it. If you don't know what

349

523

this means, you probably don't want this tunnel option.

350

524

525

<DT>-socks5gssapiservice

526

527

<DD>

528

Pass thee name of the service. The default service name for a SOCKS5 server is

529

rcmd/server-fqdn. This option allows you to change it.

530

531

<DT>-socks5gssapinec

532

533

<DD>

534

Pass a 1 to enable or 0 to disable. As part of the gssapi negotiation a protection

535

mode is negotiated. The rfc1961 says in section 4.3/4.4 it should be protected, but

536

the NEC reference implementation does not. If enabled, this option allows the

537

unprotected exchange of the protection mode negotiation.

351

538

352

539

<DT>-interface

353

540

361

548

<DD>

362

549

This sets the local port number of the socket used for connection. This can

363

550

be used in combination with -interface and you are recommended to use

364

localportrange as well when this is set. Note the only valid port numbers

551

localportrange as well when this is set. Valid port numbers

365

552

are 1 - 65535.

366

553

367

554

<DT>-localportrange

370

557

This is the number of attempts TclCurl should do to find a working local port

371

558

number. It starts with the given -localport and adds

372

559

one to the number for each retry. Setting this value to 1 or below will make

373

TclCurl do only one try for exact port number. Note that port numbers by nature

560

TclCurl do only one try for each port number. Port numbers by nature

374

561

are a scarce resource that will be busy at times so setting this value to something

375

562

too low might cause unnecessary connection setup failures.

376

563

381

568

of seconds. Set to '0' to completely disable caching, or '-1' to make the

382

569

cached entries remain forever. By default, TclCurl caches this info for 60 seconds.

383

570

571

The name resolve functions of various libc implementations don't re-read name

572

server information unless explicitly told so (for example, by calling

573

res_init(3)). This may cause TclCurl to keep using the older server even

574

if DHCP has updated the server info, and this may look like a DNS cache issue.

575

384

576

<DT>-dnsuseglobalcache

385

577

386

578

<DD>

485

677

486

678

<DD>

487

679

Pass a string as parameter, which should be [username]:[password] to use for

488

the connection. Use httpauth to decide authentication method.

680

the connection. Use -httpauth to decide authentication method.

489

681

490

682

When using NTLM, you can set domain by prepending it to the user name and

491

683

separating the domain and name with a forward (/) or backward slash (\). Like

505

697

Pass a string as parameter, which should be [username]:[password] to use for

506

698

the connection to the HTTP proxy.

507

699

700

<DT>-username

701

702

<DD>

703

Pass a string with the user name to use for the transfer. It sets the user name

704

to be used in protocol authentication. You should not use this option together

705

with the (older) -userpwd option.

706

707

In order to specify the password to be used in conjunction with the user name

708

use the -password option.

709

710

<DT>-password

711

712

<DD>

713

Pass a string with the password to use for the transfer.

714

715

It should be used in conjunction with the -username option.

716

717

<DT>-proxyusername

718

719

<DD>

720

Pass a string with the user name to use for the transfer while connecting to Proxy.

721

722

It should be used in same way as the -proxyuserpwd is used, except that it

723

allows the username to contain a colon, like in the following example:

724

"sip:user@example.com".

725

726

Note the -proxyusername option is an alternative way to set the user name

727

while connecting to Proxy. It doesn't make sense to use them together.

728

729

<DT>-proxypassword

730

731

<DD>

732

Pass a string with the password to use for the transfer while connecting to Proxy. It

733

is meant to use together with -proxyusername.

734

508

735

<DT>-httpauth

509

736

510

737

<DD>

526

753

way to do authentication over public networks than the regular

527

754

old-fashioned Basic method.

528

755

756

<DT>digestie

757

758

<DD>

759

HTTP Digest authentication with an IE flavor. TclCurl will use a special

760

"quirk" that IE is known to have used before version 7 and that some

761

servers require the client to use.

762

529

763

<DT>gssnegotiate

530

764

531

765

<DD>

541

775

It uses a challenge-response and hash concept similar to Digest, to prevent the

542

776

password from being eavesdropped.

543

777

778

<DT>ntlmwb

779

780

<DD>

781

NTLM delegating to winbind helper. Authentication is performed by a separate

782

binary application that is executed when needed. The name of the application is

783

specified at libcurl's compile time but is typically /usr/bin/ntlm_auth.

784

785

Note that libcurl will fork when necessary to run the winbind application and kill

786

it when complete, calling waitpid() to await its exit when done. On POSIX operating

787

systems, killing the process will cause a SIGCHLD signal to be raised

788

(regardless of whether -nosignal is set). This behavior is subject to change

789

in future versions of libcurl.

790

544

791

<DT>any

545

792

546

793

<DD>

555

802

</DL>

556

803

557

804

805

<DT>Use it to tell TclCurl which authentication method(s) you want it to use for TLS authentication.<DD>

806

807

808

<DT><DT>tlsauthsrp

809

810

<DD>

811

<DD>

812

TLS-SRP authentication. Secure Remote Password authentication for TLS is

813

defined in RFC 5054 and provides mutual authentication if both sides have a

814

shared secret. To use TLS-SRP, you must also set the

815

-tlsauthusername and -tlsauthpassword options.

816

817

You need to build libcurl with GnuTLS or OpenSSL with TLS-SRP support for this

818

to work.

819

</DL>

820

</DL>

821

822

823

<DT>-tlsauthusername

824

825

<DD>

826

Pass a string with the username to use for the TLS authentication method specified

827

with the -tlsauthtype option. Requires that the -tlsauthpassword option

828

also be set.

829

830

<DT>-tlsauthpassword

831

832

<DD>

833

Pass a string with the password to use for the TLS authentication method specified

834

with the -tlsauthtype option. Requires that the -tlsauthusername option

835

also be set.

836

558

837

<DT>-proxyauth

559

838

560

839

<DD>

595

874

encoding done by the server is ignored. See the special file

596

875

lib/README.encoding in libcurl docs for details.

597

876

877

<DT>-transferencoding

878

879

<DD>

880

Adds a request for compressed Transfer Encoding in the outgoing HTTP

881

request. If the server supports this and so desires, it can respond with the

882

HTTP resonse sent using a compressed Transfer-Encoding that will be

883

automatically uncompressed by TclCurl on receival.

884

885

Transfer-Encoding differs slightly from the Content-Encoding you ask for with

886

-encoding in that a Transfer-Encoding is strictly meant to

887

be for the transfer and thus MUST be decoded before the data arrives in the

888

client. Traditionally, Transfer-Encoding has been much less used and supported

889

by both HTTP clients and HTTP servers.

890

598

891

<DT>-followlocation

599

892

600

893

<DD>

603

896

604

897

that the server sends as part of a HTTP header.

605

898

606

NOTE: this means that the extension will re-send the same

607

request on the new location and follow new Location: headers

608

all the way until no more such headers are returned.

609

-maxredirs can be used to limit the number of redirects

899

This means that the extension will re-send the same request on the new location

900

and follow new Location: headers all the way until no more such headers are

901

returned. -maxredirs can be used to limit the number of redirects

610

902

TclCurl will follow.

611

903

904

Since 7.19.4, TclCurl can limit what protocols it will automatically follow.

905

The accepted protocols are set with -redirprotocols and it excludes the FILE

906

protocol by default.

907

612

908

<DT>-unrestrictedauth

613

909

614

910

<DD>

629

925

<DT>-post301

630

926

631

927

<DD>

632

An 1 tells TclCurl to respect RFC 2616/10.3.2 and not

633

convert POST requests into GET requests when following a 301 redirection. The

634

non-RFC behaviour is ubiquitous in web browsers, so the conversion is done

635

by default to maintain consistency. However, a server may require

636

a POST to remain a POST after such a redirection. This option is meaningful

637

only when setting -followlocation.

928

Controls how TclCurl acts on redirects after POSTs that get a 301 or 302 response back.

929

A "301" as parameter tells the TclCurl to respect RFC 2616/10.3.2 and not convert POST

930

requests into GET requests when following a 301 redirection. Passing a "302" makes

931

TclCurl maintain the request method after a 302 redirect. "all" is a convenience string

932

that activates both behaviours.

933

934

The non-RFC behaviour is ubiquitous in web browsers, so the extension does the conversion

935

by default to maintain consistency. However, a server may require a POST to remain a POST

936

after such a redirection.

937

938

This option is meaningful only when setting -followlocation

939

940

The option used to be known as -post301, which should still work but is know

941

deprecated.

638

942

639

943

<DT>-put

640

944

644

948

645

949

This option is deprecated starting with version 0.12.1, you should use -upload.

646

950

951

This option does not limit how much data TclCurl will actually send, as that is

952

controlled entirely by what the read callback returns.

953

647

954

<DT>-post

648

955

649

956

<DD>

851

1158

Set multiple cookies in one string like this: "name1=content1; name2=content2;"

852

1159

etc.

853

1160

854

Note that this option sets the cookie header explictly in the outgoing request(s).

1161

This option sets the cookie header explictly in the outgoing request(s).

855

1162

If multiple requests are done due to authentication, followed redirections or similar,

856

1163

they will all get this cookie passed on.

857

1164

964

1271

965

1272

</DL>

966

1273

1274

<H2>SMTP options</H2>

1275

1276

1277

1278

<DT>-mailfrom

1279

1280

<DD>

1281

Pass a string to specify the sender address in a mail when sending an SMTP mail with TclCurl.

1282

1283

<DT>-mailrcpt

1284

1285

<DD>

1286

Pass a list of recipients to pass to the server in your SMTP mail request.

1287

1288

Each recipient in SMTP lingo is specified with angle brackets (<>), but should you not use an

1289

angle bracket as first letter, TclCurl will assume you provide a single email address only and

1290

enclose that with angle brackets for you.

1291

1292

</DL>

1293

1294

<H2>TFTP option</H2>

1295

1296

1297

1298

<DT>tftpblksize

1299

1300

<DD>

1301

1302

Specify the block size to use for TFTP data transmission. Valid range as per RFC 2348 is 8-65464 bytes.

1303

The default of 512 bytes will be used if this option is not specified. The specified block size will

1304

only be used pending support by the remote server. If the server does not return an option acknowledgement

1305

or returns an option acknowledgement with no blksize, the default of 512 bytes will be used.

1306

1307

</DL>

1308

967

1309

<H2>FTP options</H2>

968

1310

969

1311

978

1320

just a '-' to let the library use your systems default IP address. Default FTP

979

1321

operations are passive, and thus will not use PORT.

980

1322

1323

The address can be followed by a ':' to specify a port, optionally followed by a '-'

1324

o specify a port range. If the port specified is 0, the operating system will pick

1325

a free port. If a range is provided and all ports in the range are not available,

1326

libcurl will report CURLE_FTP_PORT_FAILED for the handle. Invalid port/range settings

1327

are ignored. IPv6 addresses followed by a port or portrange have to be in brackets.

1328

IPv6 addresses without port/range specifier can be in brackets.

1329

1330

Examples with specified ports:

1331

1332

eth0:0   192.168.1.2:32000-33000   curl.se:32123   [::1]:1234-4567

1333

1334

You disable PORT again and go back to using the passive version by setting this option to

1335

an empty string.

1336

981

1337

<DT>-quote

982

1338

983

1339

<DD>

986

1342

before the CWD command).If you do not want to transfer any files, set

987

1343

nobody to '1' and header to '0'.

988

1344

1345

Prefix the command with an asterisk (*) to make TclCurl continue even if the command

1346

fails as by default TclCurl will stop.

1347

1348

Disable this operation again by setting an empty string to this option.

1349

989

1350

Keep in mind the commands to send must be 'raw' ftp commands, for example, to

990

1351

create a directory you need to send mkd Test, not mkdir Test.

991

1352

1016

1377

only files in their response to NLST, they might not include subdirectories

1017

1378

and symbolic links.

1018

1379

1380

Setting this option to 1 also implies a directory listing even if the URL

1381

doesn't end with a slash, which otherwise is necessary.

1382

1383

Do NOT use this option if you also use -wildcardmatch as it will

1384

effectively break that feature.

1385

1019

1386

<DT>-append

1020

1387

1021

1388

<DD>

1022

1389

A 1 parameter tells the extension to append to the remote file instead of

1023

1390

overwriting it. This is only useful when uploading to a ftp site.

1024

1391

1025

<DT>-ftpuseeprt

1392

<DT>-ftpusepret

1026

1393

1027

1394

<DD>

1028

1395

Set to 1 to tell TclCurl to use the EPRT (and LPRT) command when doing

1038

1405

first attempt to use EPSV before using PASV, but if you pass a zero to this

1039

1406

option, it will not try using EPSV, only plain PASV.

1040

1407

1408

<DT>-ftpusepret

1409

1410

<DD>

1411

1412

Set to one to tell TclCurl to send a PRET command before PASV (and EPSV). Certain

1413

FTP servers, mainly drftpd, require this non-standard command for directory listings

1414

as well as up and downloads in PASV mode. Has no effect when using the active FTP

1415

transfers mode.

1416

1041

1417

<DT>-ftpcreatemissingdirs

1042

1418

1043

1419

<DD>

1049

1425

creation will fail if a file of the same name as the directory to create

1050

1426

already exists or lack of permissions prevents creation.

1051

1427

1428

If set to 2, TclCurl will retry the CWD command again if the subsequent MKD

1429

command fails. This is especially useful if you're doing many simultanoeus

1430

connections against the same server and they all have this option enabled,

1431

as then CWD may first fail but then another connection does MKD before this

1432

connection and thus MKD fails but trying CWD works

1433

1052

1434

<DT>-ftpresponsetimeout

1053

1435

1054

1436

<DD>

1077

1459

1078

1460

This option has no effect if PORT, EPRT or EPSV is used instead of PASV.

1079

1461

1080

<DT>-usessl

1081

1082

<DD>

1083

You can use ftps:// URLs to explicitly switch on SSL/TSL for the control

1084

connection and the data connection.

1085

1086

Alternatively, and what seems to be the recommended way, you can set the

1087

option to one of these values:

1088

1089

1090

1091

<DT>nope

1092

1093

<DD>

1094

Do not attempt to use SSL

1095

<DT>try

1096

1097

<DD>

1098

Try using SSL, proceed anyway otherwise.

1099

<DT>control

1100

1101

<DD>

1102

Use SSL for the control conecction or fail with "use ssl failed" (64).

1103

<DT>all

1104

1105

<DD>

1106

Use SSL for all communication or fail with "use ssl failed" (64).

1107

</DL>

1108

</DL>

1109

1110

1111

1462

<DT>-ftpsslauth

1112

1463

1113

1464

<DD>

1115

1466

Pass TclCurl one of the values from below, to alter how TclCurl issues

1116

1467

"AUTH TLS" or "AUTH SSL" when FTP over SSL is activated (see -ftpssl).

1117

1468

1118

You may need this option because of servers like BSDFTPD-SSL from

1119

<A HREF="http://bsdftpd-ssl.sc.ru/">http://bsdftpd-ssl.sc.ru/</A> "which won't work properly when "AUTH SSL" is issued

1469

You may need this option because of servers like <a href="http://bsdftpd-ssl.sc.ru/">BSDFTPD-SSL</A>

1470

which won't work properly when "AUTH SSL" is issued

1120

1471

(although the server responds fine and everything) but requires "AUTH TLS"

1121

instead".

1472

instead.

1122

1473

1123

1474

1124

1475

1198

1549

1199

1550

1200

1551

</DL>

1201

1552

1202

1553

<H2>Protocol options</H2>

1203

1554

1204

1555

1228

1579

<DT>-crlf

1229

1580

1230

1581

<DD>

1231

Convert unix newlines to CRLF newlines on FTP transfers.

1582

If set to '1', TclCurl converts Unix newlines to CRLF newlines on transfers. Disable

1583

this option again by setting the value to '0'.

1232

1584

1233

1585

<DT>-range

1234

1586

1256

1608

For FTP, set this option to -1 to make the transfer start from the end of the

1257

1609

target file (useful to continue an interrupted upload).

1258

1610

1611

When doing uploads with FTP, the resume position is where in the local/source

1612

file TclCurl should try to resume the upload from and it will then append the

1613

source file to the remote target file.

1614

1259

1615

<DT>-customrequest

1260

1616

1261

1617

<DD>

1330

1686

<DD>

1331

1687

This defines how the timevalue value is treated. You can set this

1332

1688

parameter to ifmodsince or ifunmodsince. This feature applies to

1333

HTTP and FTP.

1689

HTTP, FTP and FILE.

1334

1690

1335

1691

<DT>-timevalue

1336

1692

1340

1696

1341

1697

1342

1698

</DL>

1343

1699

1344

1700

<H2>Connection options</H2>

1345

1701

1346

1702

1412

1768

1413

1769

than before may cause open connections to unnecessarily get closed.

1414

1770

1415

Note that if you add this easy handle to a multi handle, this setting is not

1771

If you add this easy handle to a multi handle, this setting is not

1416

1772

being acknowledged, instead you must configure the multi handle its own

1417

1773

maxconnects option.

1418

1774

1459

1815

</DL>

1460

1816

1461

1817

1462

</DL>

1463

1818

<DT>-resolve

1819

1820

<DD>

1821

Pass a list of strings with host name resolve information to use for requests with

1822

this handle.

1823

1824

Each single name resolve string should be written using the format

1825

HOST:PORT:ADDRESS where HOST is the name TclCurl will try to resolve, PORT is

1826

the port number of the service where TclCurl wants to connect to the HOST and

1827

ADDRESS is the numerical IP address. If libcurl is built to support IPv6,

1828

ADDRESS can be either IPv4 or IPv6 style addressing.

1829

1830

This option effectively pre-populates the DNS cache with entries for the

1831

host+port pair so redirects and everything that operations against the

1832

HOST+PORT will instead use your provided ADDRESS.

1833

1834

You can remove names from the DNS cache again, to stop providing these fake

1835

resolves, by including a string in the linked list that uses the format

1836

"-HOST:PORT". The host name must be prefixed with a dash, and the host name

1837

and port number must exactly match what was already added previously.

1838

1839

<DT>-usessl

1840

1841

<DD>

1842

Pass a one of the values from below to make TclCurl use your desired level of SSL for the transfer.

1843

This is for enabling SSL/TLS when you use FTP, SMTP, POP3, IMAP etc.

1844

1845

You can use ftps:// URLs to explicitly switch on SSL/TSL for the control

1846

connection and the data connection.

1847

1848

Alternatively you can set the option to one of these values:

1849

1850

1851

1852

<DT>nope

1853

1854

<DD>

1855

Do not attempt to use SSL

1856

<DT>try

1857

1858

<DD>

1859

Try using SSL, proceed anyway otherwise.

1860

<DT>control

1861

1862

<DD>

1863

Use SSL for the control conecction or fail with "use ssl failed" (64).

1864

<DT>all

1865

1866

<DD>

1867

Use SSL for all communication or fail with "use ssl failed" (64).

1868

</DL>

1869

</DL>

1870

1871

1872

</DL>

1873

1464

1874

<H2>SSL and security options</H2>

1465

1875

1466

1876

1472

1882

The default format is "PEM" and can be changed with -sslcerttype.

1473

1883

1474

1884

With NSS this is the nickname of the certificate you wish to authenticate with.

1885

If you want to use a file from the current directory, please precede it with the

1886

"./" prefix, in order to avoid confusion with a nickname.

1475

1887

1476

1888

<DT>-sslcerttype

1477

1889

1565

1977

alternate certificates with the -cainfo or the -capath options.

1566

1978

1567

1979

When -sslverifypeer is nonzero, and the verification fails to prove that the certificate

1568

is authentic, the connection fails. When the option is zero, the connection succeeds regardless.

1980

is authentic, the connection fails. When the option is zero, the peer certificate verification

1981

succeeds regardless.

1569

1982

1570

1983

Authenticating the certificate is not by itself very useful. You typically want to ensure

1571

1984

that the server, as authentically identified by its certificate, is the server you mean to

1572

be talking to, use -sslverifyhost to control that.

1985

be talking to, use -sslverifyhost to control that. The check that the host name in

1986

the certificate is valid for the host name you're connecting to is done

1987

independently of this option.

1573

1988

1574

1989

<DT>-cainfo

1575

1990

1578

1993

makes sense when used in combination with the -sslverifypeer option, if

1579

1994

it is set to zero -cainfo need not even indicate an accessible file.

1580

1995

1996

This option is by default set to the system path where libcurl's cacert bundle

1997

is assumed to be stored, as established at build time.

1998

1581

1999

When built against NSS this is the directory that the NSS certificate database

1582

2000

resides in.

1583

2001

1597

2015

1598

2016

<DD>

1599

2017

Pass the directory holding multiple CA certificates to verify the peer with.

1600

The certificate directory must be prepared using the openssl c_rehash utility.

2018

If libcurl is built against OpenSSL, the certificate directory must be prepared

2019

using the openssl c_rehash utility.

1601

2020

This only makes sense when used in combination with the -sslverifypeer

1602

2021

option, if it is set to zero, -capath need not even indicate an accessible

1603

2022

path.

1605

2024

This option apparently does not work in Windows due to some limitation in openssl.

1606

2025

1607

2026

This option is OpenSSL-specific and does nothing if libcurl is built to use GnuTLS.

2027

NSS-powered libcurl provides the option only for backward compatibility.

1608

2028

1609

2029

<DT>-crlfile

1610

2030

1620

2040

This option makes sense only when used in combination with the -sslverifypeer

1621

2041

option.

1622

2042

1623

<DT>-randomfile

1624

1625

<DD>

1626

Pass a file name. The file will be used to read from to seed the random engine

1627

for SSL. The more random the specified file is, the more secure will the SSL

1628

connection become.

1629

1630

<DT>-egdsocket

1631

1632

<DD>

1633

Pass a path name to the Entropy Gathering Daemon socket. It will be used to seed

1634

the random engine for SSL.

2043

A specific error code (CURLE_SSL_CRL_BADFILE) is defined with the option. It is returned

2044

when the SSL exchange fails because the CRL file cannot be loaded. A failure in certificate

2045

verification due to a revocation information found in the CRL does not trigger this specific

2046

error.

1635

2047

1636

2048

<DT>-sslverifyhost

1637

2049

1657

2069

When the value is 0, the connection succeeds regardless of the names in

1658

2070

the certificate.

1659

2071

1660

The default is 2.

2072

The default value for this option is 2.

1661

2073

1662

2074

This option controls the identity that the server claims. The server

1663

could be lying. To control lying, see sslverifypeer.

2075

could be lying. To control lying, see -sslverifypeer. If libcurl is built

2076

against NSS and -verifypeer is zero, -verifyhost is ignored.

2077

2078

<DT>-certinfo

2079

2080

<DD>

2081

Set to '1' to enable TclCurl's certificate chain info gatherer. With this enabled, TclCurl

2082

(if built with OpenSSL) will extract lots of information and data about the certificates

2083

in the certificate chain used in the SSL connection. This data can then be to extracted

2084

after a transfer using the getinfo command and its option certinfo.

2085

2086

<DT>-randomfile

2087

2088

<DD>

2089

Pass a file name. The file will be used to read from to seed the random engine

2090

for SSL. The more random the specified file is, the more secure the SSL

2091

connection becomes.

2092

2093

<DT>-egdsocket

2094

2095

<DD>

2096

Pass a path name to the Entropy Gathering Daemon socket. It will be used to seed

2097

the random engine for SSL.

1664

2098

1665

2099

<DT>-sslcypherlist

1666

2100

1687

2121

1688

2122

<DD>

1689

2123

Pass a 0 to disable TclCurl's use of SSL session-ID caching or a 1 to enable it.

1690

By default all transfers are done using the cache. Note that while nothing ever

2124

By default all transfers are done using the cache. While nothing ever

1691

2125

should get hurt by attempting to reuse SSL session-IDs, there seem to be broken SSL

1692

2126

implementations in the wild that may require you to disable this in order for you to

1693

2127

succeed.

1701

2135

to NULL to disable kerberos4. Set the string to "" to disable kerberos

1702

2136

support for FTP.

1703

2137

2138

<DT>-gssapidelegation

2139

2140

<DD>

2141

Set the option to 'flag' to allow unconditional GSSAPI credential delegation. The delegation

2142

is disabled by default since 7.21.7. Set the parameter to 'policyflag' to delegate only if

2143

the OK-AS-DELEGATE flag is set in the service ticket in case this feature is supported by the

2144

GSSAPI implementation and the definition of GSS_C_DELEG_POLICY_FLAG was available at compile-time.

2145

2146

1704

2147

</DL>

1705

2148

1706

2149

<H2>SSH options</H2>

1707

2150

1708

2151

1745

2188

<DT>-publickeyfile

1746

2189

1747

2190

<DD>

1748

Pass the file name for your public key. If not used, TclCurl defaults to using ~/.ssh/id_dsa.pub.

2191

Pass the file name for your public key. If not used, TclCurl defaults to using $HOME/.ssh/id_dsa.pub.

2192

HOME environment variable is set, and just id_dsa in the current directory if not.

1749

2193

1750

2194

<DT>-privatekeyfile

1751

2195

1752

2196

<DD>

1753

Pass the file name for your private key. If not used, TclCurl defaults to using ~/.ssh/id_dsa.

2197

Pass the file name for your private key. If not used, TclCurl defaults to using $HOME/.ssh/id_dsa.pub.

2198

HOME environment variable is set, and just id_dsa in the current directory if not.

1754

2199

If the file is password-protected, set the password with -keypasswd.

1755

2200

1756

</DL>

1757

2201

<DT>-sshknownhosts

2202

2203

<DD>

2204

Pass a string holding the file name of the known_host file to use. The known_hosts

2205

file should use the OpenSSH file format as supported by libssh2. If this file is

2206

specified, TclCurl will only accept connections with hosts that are known and present

2207

in that file, with a matching public key. Use -sshkeyproc to alter the default

2208

behavior on host and key (mis)matching.

2209

2210

<DT>-sshkeyproc

2211

2212

<DD>

2213

Pass a the name of the procedure that will be called when the known_host matching has

2214

been done, to allow the application to act and decide for TclCurl how to proceed. The

2215

callback will only be called if -knownhosts is also set.

2216

2217

It gets passed a list with three elements, the first one is a list with the type of the

2218

key from the known_hosts file and the key itself, the second is another list with

2219

the type of the key from the remote site and the key itslef, the third tells you

2220

what TclCurl thinks about the matching status.

2221

2222

The known key types are: "rsa", "rsa1" and "dss", in any other case "unknown" is given.

2223

2224

TclCurl opinion about how they match may be: "match", "mismatch", "missing" or "error".

2225

2226

The procedure must return:

2227

2228

2229

<DT>0

2230

2231

<DD>

2232

The host+key is accepted and TclCurl will append it to the known_hosts file before

2233

continuing with the connection. This will also add the host+key combo to the known_host

2234

pool kept in memory if it wasn't already present there. The adding of data to

2235

the file is done by completely replacing the file with a new copy, so the permissions of

2236

the file must allow this.

2237

<DT>1

2238

2239

<DD>

2240

The host+key is accepted, TclCurl will continue with the connection. This will also add

2241

the host+key combo to the known_host pool kept in memory if it wasn't already present

2242

there.

2243

<DT>2

2244

2245

<DD>

2246

The host+key is rejected. TclCurl will close the connection.

2247

<DT>3

2248

2249

<DD>

2250

The host+key is rejected, but the SSH connection is asked to be kept alive. This feature

2251

could be used when the app wants to somehow return back and act on the host+key situation

2252

and then retry without needing the overhead of setting it up from scratch again.

2253

</DL>

2254

</DL>

2255

2256

2257

Any other value will cause the connection to be closed.

2258

2259

</DL>

2260

1758

2261

<H2>Other options</H2>

1759

2262

1760

2263

1765

2268

Name of the Tcl array variable where TclCurl will store the headers returned

1766

2269

by the server.

1767

2270

1768

When a server sends a chunked encoded transfer, it may contain a

1769

trailer. That trailer is identical to a HTTP header and if such a trailer is

1770

received it is passed to the application using this callback as well. There

1771

are several ways to detect it being a trailer and not an ordinary header: 1)

1772

it comes after the response-body. 2) it comes after the final header line (CR

1773

LF) 3) a Trailer: header among the response-headers mention what header to

1774

expect in the trailer.

1775

1776

2271

<DT>-bodyvar

1777

2272

1778

2273

<DD>

1804

2299

<DD>

1805

2300

Pass a number as a parameter, containing the value of the permissions that will

1806

2301

be assigned to newly created files on the remote server. The default value is 0644,

1807

but any valid value can be used. The only protocols that can use this are <A HREF="sftp://,">sftp://,</A>

1808

scp:// and <A HREF="file://.">file://.</A>

2302

but any valid value can be used. The only protocols that can use this are sftp://,

2303

scp:// and file://.

1809

2304

1810

2305

<DT>-newdirectoryperms

1811

2306

1812

2307

<DD>

1813

2308

Pass a number as a parameter, containing the value of the permissions that will be

1814

2309

assigned to newly created directories on the remote server. The default value is 0755,

1815

but any valid value can be used. The only protocols that can use this are <A HREF="sftp://,">sftp://,</A> scp://

1816

and <A HREF="file://.">file://.</A>

1817

1818

</DL>

1819

2310

but any valid value can be used. The only protocols that can use this are sftp://, scp://

2311

and file://.

2312

2313

</DL>

2314

2315

<H2>Telnet options</H2>

2316

2317

2318

2319

<DT>-telnetoptions

2320

2321

<DD>

2322

Pass a list with variables to pass to the telnet negotiations. The variables should be in

2323

the format <option=value>. TclCurl supports the options 'TTYPE', 'XDISPLOC' and 'NEW_ENV'.

2324

See the TELNET standard for details.

2325

2326

</DL>

2327

1820

2328

<H2>NOT SUPPORTED</H2>

1821

2329

1822

2330

Some of the options libcurl offers are not supported, I don't think them

1830

2338

CURLOPT_CONNECT_ONLY, CURLOPT_OPENSOCKETFUNCTION, CURLOPT_OPENSOCKETDATA.

1831

2339

1832

2340

1833

2341

1834

2342

<H2>curlHandle perform</H2>

1835

2343

1836

2344

This procedure is called after the

1871

2379

Unsupported protocol. This build of TclCurl has no support for this protocol.

1872

2380

1873

2381

Very early initialization code failed. This is likely to be and internal error

1874

or problem.

2382

or a resource problem where something fundamental couldn't get done at init time.

1875

2383

1876

2384

URL malformat. The syntax was not correct.

2385

2386

A requested feature, protocol or option was not found built-in in this libcurl

2387

due to a build-time decision. This means that a feature or option was not

2388

enabled or explicitly disabled when libcurl was built and in order to get it

2389

to function you have to get a rebuilt libcurl.

1877

2390

1878

2391

Couldn't resolve proxy. The given proxy host could not be resolved.

1879

2392

1939

2452

SSL connect error. The SSL handshaking failed, the error buffer may have

1940

2453

a clue to the reason, could be certificates, passwords, ...

1941

2454

1942

FTP bad download resume. Couldn't continue an earlier aborted download, probably

1943

because you are trying to resume beyond the file size.

2455

The download could not be resumed because the specified offset was out of the

2456

file boundary.

1944

2457

1945

2458

A file given with FILE:// couldn't be read. Did you checked the permissions?

1946

2459

1959

2472

Too many redirects. When following redirects, TclCurl hit the maximum amount, set

1960

2473

your limit with --maxredirs

1961

2474

1962

Unknown TELNET option specified.

2475

An option passed to TclCurl is not recognized/known. Refer to the appropriate

2476

documentation. This is most likely a problem in the program that uses

2477

TclCurl. The error buffer might contain more specific information about which

2478

exact option it concerns.

1963

2479

1964

2480

A telnet option string was illegally formatted.

1965

2481

2008

2524

2009

2525

TFTP file already exists and will not be overwritten.

2010

2526

2011

No such user in the TFTP server and good behaving TFTP server

2527

No such user in the TFTP server and good behaving TFTP servers

2012

2528

should never return this.

2013

2529

2014

2530

Character conversion failed.

2024

2540

Failed to load CRL file

2025

2541

2026

2542

Issuer check failed

2543

2544

The FTP server does not understand the PRET command at all or does not support

2545

the given argument. Be careful when using -customrequest, a

2546

custom LIST command will be sent with PRET CMD before PASV as well.

2547

2548

Mismatch of RTSP CSeq numbers.

2549

2550

Mismatch of RTSP Session Identifiers.

2551

2552

Unable to parse FTP file list (during FTP wildcard downloading).

2553

2554

Chunk callback reported error.

2027

2555

2028

2556

</DL>

2029

2557

2030

2558

<H2>curlHandle getinfo option</H2>

2031

2559

2032

2560

Request internal information from the curl session with this procedure.

2145

2673

Returns the IP address of the most recent connection done with this handle.

2146

2674

This string may be IPv6 if that's enabled.

2147

2675

2676

<DT>primaryport

2677

2678

<DD>

2679

Returns the destination port of the most recent connection done with this handle.

2680

2681

<DT>localip

2682

2683

<DD>

2684

Returns the local (source) IP address of the most recent connection done

2685

with this handle. This string may be IPv6 if that's enabled.

2686

2687

<DT>localport

2688

2689

<DD>

2690

Returns the local (source) port of the most recent connection done with this handle.

2691

2148

2692

<DT>sizeupload

2149

2693

2150

2694

<DD>

2196

2740

Returns the content-length of the download. This is the value read from the

2197

2741

Content-Length:

2198

2742

2199

field.

2743

field. If the size isn't known, it returns -1.

2200

2744

2201

2745

<DT>contentlengthupload

2202

2746

2225

2769

<DT>oserrno

2226

2770

2227

2771

<DD>

2228

Returns the errno value from a connect failure.

2772

Returns the errno value from a connect failure. This value is only set on

2773

failure, it is no reset after a successfull operation.

2229

2774

2230

2775

<DT>cookielist

2231

2776

2241

2786

TclCurl ended up in when logging on to the remote FTP server. Returns an empty

2242

2787

string if something is wrong.

2243

2788

2789

<DT>certinfo

2790

2791

<DD>

2792

Returns list with information about the certificate chain, assuming you had the

2793

-certinfo option enabled when the previous request was done. The list

2794

first item reports how many certs it found and then you can extract info for each

2795

of those certs by following the list. The info chain is provided in a series of data

2796

in the format "name:content" where the content is for the specific named data.

2797

2798

NOTE: this option is only available in libcurl built with OpenSSL support.

2799

2800

<DT>conditionunmet

2801

2802

<DD>

2803

Returns the number 1 if the condition provided in the previous request

2804

didn't match (see timecondition), you will get a zero if the condition

2805

instead was met.

2806

2244

2807

</DL>

2245

2808

2246

2809

<H2>curlHandle cleanup</H2>

2247

2810

2248

2811

This procedure must be the last one to call for a curl session. It is the

2257

2820

has kept open until now. Don't call this procedure if you intend to transfer

2258

2821

more files.

2259

2822

2260

2823

2261

2824

<H2>curlHandle reset</H2>

2262

2825

2263

2826

2270

2833

It does not change the following information kept in the handle: live

2271

2834

connections, the Session ID cache, the DNS cache, the cookies and shares.

2272

2835

2273

2836

2274

2837

<H2>curlHandle duphandle</H2>

2275

2838

2276

2839

This procedure will return a new curl handle, a duplicate,

2288

2851

A new curl handle or an error message if the copy fails.

2289

2852

2290

2853

</DL>

2291

2854

2292

2855

<H2>curlHandle pause</H2>

2293

2856

2294

2857

You can use this command from within a progress callback procedure

2295

2858

to pause the transfer.

2296

2859

2297

2860

2298

2861

<H2>curlHandle resume</H2>

2299

2862

2300

2863

Resumes a transfer paused with curlhandle pause

2301

2864

2302

2865

2303

2866

<H2>curl::transfer</H2>

2304

2867

2305

2868

In case you do not want to use persistant connections you can use this

2316

2879

The same error code perform would return.

2317

2880

2318

2881

</DL>

2319

2882

2320

2883

<H2>curl::version</H2>

2321

2884

2322

2885

Returns a string with the version number of tclcurl, libcurl and some of

2328

2891

The string with the version info.

2329

2892

2330

2893

</DL>

2331

2894

2332

2895

<H2>curl::escape url</H2>

2333

2896

2334

2897

This procedure will convert the given input string to an URL encoded string and

2341

2904

<DD>

2342

2905

The converted string.

2343

2906

</DL>

2344

2907

2345

2908

<H2>curl::unescape url</H2>

2346

2909

2347

2910

This procedure will convert the given URL encoded input string to a "plain

2355

2918

The string unencoded.

2356

2919

2357

2920

</DL>

2358

2921

2359

2922

<H2>curl::curlConfig option</H2>

2360

2923

2361

2924

Returns some information about how you have

2388

2951

0c0d0e...

2389

2952

2390

2953

</DL>

2391

2954

2392

2955

<H2>curl::versioninfo option</H2>

2393

2956

2394

2957

Returns information about various run-time features in TclCurl.

2482

3045

makes libcurl use Windows-provided functions for NTLM authentication. It also

2483

3046

allows libcurl to use the current user and the current user's password without

2484

3047

the app having to pass them on.

3048

<DT>TLSAUTH_SRP

3049

3050

<DD>

3051

Libcurl was built with support for TLS-SRP.

3052

NTLM_WB

3053

3054

Libcurl was built with support for NTLM delegation to a winbind helper.

2485

3055

</DL>

2486

3056

</DL>

2487

3057

2513

3083

in the list.

2514

3084

2515

3085

</DL>

2516

3086

2517

3087

<H2>curl::easystrerror errorCode</H2>

2518

3088

2519

3089

This procedure returns a string describing the error code passed in the argument.

2520

3090

2521

3091

2522

3092

2523

3093

2524

curl, <A HREF="http://curl.haxx.se/docs/httpscripting.html">The art of HTTP scripting</A> RFC 2396,

3094

curl, <a href="http://curl.haxx.se/docs/httpscripting.html">The art of HTTP scripting</A>, RFC 2396,

2525

3095

2526

3096

2527

3097

2539

3109

<DT><A HREF="#lbAJ">Network options</A><DD>

2540

3110

<DT><A HREF="#lbAK">Names and Passwords options</A><DD>

2541

3111

<DT><A HREF="#lbAL">HTTP options</A><DD>

2542

<DT><A HREF="#lbAM">FTP options</A><DD>

2543

<DT><A HREF="#lbAN">Protocol options</A><DD>

2544

<DT><A HREF="#lbAO">Connection options</A><DD>

2545

<DT><A HREF="#lbAP">SSL and security options</A><DD>

2546

<DT><A HREF="#lbAQ">SSH options</A><DD>

2547

<DT><A HREF="#lbAR">Other options</A><DD>

2548

<DT><A HREF="#lbAS">NOT SUPPORTED</A><DD>

2549

<DT><A HREF="#lbAT">curlHandle perform</A><DD>

2550

<DT><A HREF="#lbAU">curlHandle getinfo option</A><DD>

2551

<DT><A HREF="#lbAV">curlHandle cleanup</A><DD>

2552

<DT><A HREF="#lbAW">curlHandle reset</A><DD>

2553

<DT><A HREF="#lbAX">curlHandle duphandle</A><DD>

2554

<DT><A HREF="#lbAY">curlHandle pause</A><DD>

2555

<DT><A HREF="#lbAZ">curlHandle resume</A><DD>

2556

<DT><A HREF="#lbBA">curl::transfer</A><DD>

2557

<DT><A HREF="#lbBB">curl::version</A><DD>

2558

<DT><A HREF="#lbBC">curl::escape url</A><DD>

2559

<DT><A HREF="#lbBD">curl::unescape url</A><DD>

2560

<DT><A HREF="#lbBE">curl::curlConfig option</A><DD>

2561

<DT><A HREF="#lbBF">curl::versioninfo option</A><DD>

2562

<DT><A HREF="#lbBG">curl::easystrerror errorCode</A><DD>

2563

3112

<DT><A HREF="#lbAM">SMTP options</A><DD>

3113

<DT><A HREF="#lbAN">TFTP option</A><DD>

3114

<DT><A HREF="#lbAO">FTP options</A><DD>

3115

<DT><A HREF="#lbAP">Protocol options</A><DD>

3116

<DT><A HREF="#lbAQ">Connection options</A><DD>

3117

<DT><A HREF="#lbAR">SSL and security options</A><DD>

3118

<DT><A HREF="#lbAS">SSH options</A><DD>

3119

<DT><A HREF="#lbAT">Other options</A><DD>

3120

<DT><A HREF="#lbAU">Telnet options</A><DD>

3121

<DT><A HREF="#lbAV">NOT SUPPORTED</A><DD>

3122

<DT><A HREF="#lbAW">curlHandle perform</A><DD>

3123

<DT><A HREF="#lbAX">curlHandle getinfo option</A><DD>

3124

<DT><A HREF="#lbAY">curlHandle cleanup</A><DD>

3125

<DT><A HREF="#lbAZ">curlHandle reset</A><DD>

3126

<DT><A HREF="#lbBA">curlHandle duphandle</A><DD>

3127

<DT><A HREF="#lbBB">curlHandle pause</A><DD>

3128

<DT><A HREF="#lbBC">curlHandle resume</A><DD>

3129

<DT><A HREF="#lbBD">curl::transfer</A><DD>

3130

<DT><A HREF="#lbBE">curl::version</A><DD>

3131

<DT><A HREF="#lbBF">curl::escape url</A><DD>

3132

<DT><A HREF="#lbBG">curl::unescape url</A><DD>

3133

<DT><A HREF="#lbBH">curl::curlConfig option</A><DD>

3134

<DT><A HREF="#lbBI">curl::versioninfo option</A><DD>

3135

<DT><A HREF="#lbBJ">curl::easystrerror errorCode</A><DD>

3136

2564

3137

</DL>

2565

3138

<HR>

2566

This document was created by man2html,

2567

using the manual pages.

3139

This document was created by man2html, using the manual pages.

2568

3140

</BODY>

2569

3141

</HTML>