curl/docs/examples
Radoslav Georgiev abfd154efd
examples/http2-down/upload: add error checks
If `index.html` does not exist in the directory from which the example
is invoked, the fopen(upload, "rb") invocation in `setup` would fail,
returning NULL.  This value is subsequently passed as the FILE* argument
of the `fread` invocation in the `read_callback` function, which is the
actual cause of the crash (apparently `fread` assumes that argument to
be non-null).

In addition, mitigate some possible crashes of similar origin.

Closes #5463
2020-06-02 00:14:08 +02:00
..
.checksrc
.gitignore
10-at-a-time.c
adddocsref.pl
altsvc.c
anyauthput.c all: fix codespell errors 2020-05-25 19:44:04 +00:00
cacertinmem.c
certinfo.c
chkspeed.c
cookie_interface.c
crawler.c src: Remove C99 constructs to ensure C89 compliance 2020-04-19 21:56:52 +02:00
curlgtk.c
curlx.c
debug.c
ephiperfifo.c
evhiperfifo.c
externalsocket.c
fileupload.c copyrights: fix copyright year range 2019-11-08 14:51:42 +01:00
fopen.c
ftp-wildcard.c
ftpget.c
ftpgetinfo.c
ftpgetresp.c
ftpsget.c examples: remove superfluous null-pointer checks 2019-02-14 23:30:43 +01:00
ftpupload.c
ftpuploadfrommem.c examples: fixed too long line and too long string warnings 2017-05-01 09:16:12 +02:00
ftpuploadresume.c examples/ftpuploadresume: checksrc compliance 2017-08-16 14:44:50 -04:00
getinfo.c
getinmemory.c
getredirect.c
ghiper.c
hiperfifo.c
href_extractor.c
htmltidy.c copyrights: update all copyright notices to 2019 on files changed this year 2019-11-02 23:15:56 +01:00
htmltitle.cpp
http2-download.c
http2-pushinmemory.c
http2-serverpush.c
http2-upload.c
http3-present.c
http3.c
http-post.c
httpcustomheader.c
httpput.c
https.c
imap-append.c
imap-authzid.c examples: Added SASL PLAIN authorisation identity (authzid) examples 2019-08-06 11:38:49 -04:00
imap-copy.c
imap-create.c
imap-delete.c
imap-examine.c spelling fixes 2017-03-26 23:56:23 +02:00
imap-fetch.c examples: adhere to curl code style 2016-02-11 09:44:45 +01:00
imap-list.c
imap-lsub.c copyrights: fix copyright year range 2019-11-08 14:51:42 +01:00
imap-multi.c
imap-noop.c
imap-search.c
imap-ssl.c
imap-store.c
imap-tls.c
Makefile.am
makefile.dj
Makefile.example
Makefile.inc
Makefile.m32
Makefile.netware
multi-app.c
multi-debugcallback.c
multi-double.c
multi-event.c
multi-formadd.c
multi-poll.c
multi-post.c
multi-single.c
multi-uv.c checksrc: enhance the ASTERISKSPACE and update code accordingly 2020-05-14 00:02:05 +02:00
multithread.c
opensslthreadlock.c
parseurl.c
persistent.c
pop3-authzid.c
pop3-dele.c
pop3-list.c
pop3-multi.c
pop3-noop.c
pop3-retr.c
pop3-ssl.c
pop3-stat.c
pop3-tls.c
pop3-top.c
pop3-uidl.c
post-callback.c
postinmemory.c
postit2-formadd.c
postit2.c
progressfunc.c
README
resolve.c
rtsp.c
sampleconv.c
sendrecv.c
sepheaders.c
sessioninfo.c
sftpget.c
sftpuploadresume.c
shared-connection-cache.c
simple.c
simplepost.c
simplessl.c
smooth-gtk-thread.c
smtp-authzid.c examples: Added SASL PLAIN authorisation identity (authzid) examples 2019-08-06 11:38:49 -04:00
smtp-expn.c copyrights: fix copyright year range 2019-11-08 14:51:42 +01:00
smtp-mail.c
smtp-mime.c
smtp-multi.c
smtp-ssl.c
smtp-tls.c copyrights: fix copyright year range 2019-11-08 14:51:42 +01:00
smtp-vrfy.c
sslbackend.c
synctime.c
threaded-shared-conn.c
threaded-ssl.c
url2file.c
urlapi.c
usercertinmem.c
version-check.pl
xmlstream.c

                                  _   _ ____  _
                              ___| | | |  _ \| |
                             / __| | | | |_) | |
                            | (__| |_| |  _ <| |___
                             \___|\___/|_| \_\_____|

This directory is for libcurl programming examples. They are meant to show
some simple steps on how you can build your own application to take full
advantage of libcurl.

If you end up with other small but still useful example sources, please mail
them for submission in future packages and on the web site.

BUILDING

The Makefile.example is an example makefile that could be used to build these
examples. Just edit the file according to your system and requirements first.

Most examples should build fine using a command line like this:

  $ `curl-config --cc --cflags --libs` -o example example.c

Some compilers don't like having the arguments in this order but instead
want you do reorganize them like:

  $ `curl-config --cc` -o example example.c `curl-config --cflags --libs`

*PLEASE* do not use the curl.haxx.se site as a test target for your libcurl
applications/experiments. Even if some of the examples use that site as a URL
at some places, it doesn't mean that the URLs work or that we expect you to
actually torture our web site with your tests!  Thanks.

EXAMPLES

Each example source code file is designed to be and work stand-alone and
rather self-explanatory. The examples may at times lack the level of error
checks you need in a real world, but that is then only for the sake of
readability: to make the code smaller and easier to follow.