mirror of
https://github.com/curl/curl.git
synced 2026-04-14 13:01:42 +08:00
193cb00ce9
Before this patch curl used the C preprocessor to override standard memory allocation symbols: malloc, calloc, strdup, realloc, free. The goal of these is to replace them with curl's debug wrappers in `CURLDEBUG` builds, another was to replace them with the wrappers calling user-defined allocators in libcurl. This solution needed a bunch of workarounds to avoid breaking external headers: it relied on include order to do the overriding last. For "unity" builds it needed to reset overrides before external includes. Also in test apps, which are always built as single source files. It also needed the `(symbol)` trick to avoid overrides in some places. This would still not fix cases where the standard symbols were macros. It was also fragile and difficult to figure out which was the actual function behind an alloc or free call in a specific piece of code. This in turn caused bugs where the wrong allocator was accidentally called. To avoid these problems, this patch replaces this solution with `curlx_`-prefixed allocator macros, and mapping them _once_ to either the libcurl wrappers, the debug wrappers or the standard ones, matching the rest of the code in libtests. This concludes the long journey to avoid redefining standard functions in the curl codebase. Note: I did not update `packages/OS400/*.c` sources. They did not `#include` `curl_setup.h`, `curl_memory.h` or `memdebug.h`, meaning the overrides were never applied to them. This may or may not have been correct. For now I suppressed the direct use of standard allocators via a local `.checksrc`. Probably they (except for `curlcl.c`) should be updated to include `curl_setup.h` and use the `curlx_` macros. This patch changes mappings in two places: - `lib/curl_threads.c` in libtests: Before this patch it mapped to libcurl allocators. After, it maps to standard allocators, like the rest of libtests code. - `units`: before this patch it mapped to standard allocators. After, it maps to libcurl allocators. Also: - drop all position-dependent `curl_memory.h` and `memdebug.h` includes, and delete the now unnecessary headers. - rename `Curl_tcsdup` macro to `curlx_tcsdup` and define like the other allocators. - map `curlx_strdup()` to `_strdup()` on Windows (was: `strdup()`). To fix warnings silenced via `_CRT_NONSTDC_NO_DEPRECATE`. - multibyte: map `curlx_convert_*()` to `_strdup()` on Windows (was: `strdup()`). - src: do not reuse the `strdup` name for the local replacement. - lib509: call `_strdup()` on Windows (was: `strdup()`). - test1132: delete test obsoleted by this patch. - CHECKSRC.md: update text for `SNPRINTF`. - checksrc: ban standard allocator symbols. Follow-up to |
||
|---|---|---|
| .. | ||
| .checksrc | ||
| .gitignore | ||
| 10-at-a-time.c | ||
| adddocsref.pl | ||
| address-scope.c | ||
| altsvc.c | ||
| anyauthput.c | ||
| block_ip.c | ||
| cacertinmem.c | ||
| certinfo.c | ||
| chkspeed.c | ||
| CMakeLists.txt | ||
| connect-to.c | ||
| cookie_interface.c | ||
| crawler.c | ||
| debug.c | ||
| default-scheme.c | ||
| ephiperfifo.c | ||
| evhiperfifo.c | ||
| externalsocket.c | ||
| fileupload.c | ||
| ftp-delete.c | ||
| ftp-wildcard.c | ||
| ftpget.c | ||
| ftpgetinfo.c | ||
| ftpgetresp.c | ||
| ftpsget.c | ||
| ftpupload.c | ||
| ftpuploadfrommem.c | ||
| ftpuploadresume.c | ||
| getinfo.c | ||
| getinmemory.c | ||
| getredirect.c | ||
| getreferrer.c | ||
| ghiper.c | ||
| headerapi.c | ||
| hiperfifo.c | ||
| hsts-preload.c | ||
| htmltidy.c | ||
| htmltitle.cpp | ||
| http2-download.c | ||
| http2-pushinmemory.c | ||
| http2-serverpush.c | ||
| http2-upload.c | ||
| http3-present.c | ||
| http3.c | ||
| http-options.c | ||
| http-post.c | ||
| httpcustomheader.c | ||
| httpput-postfields.c | ||
| httpput.c | ||
| https.c | ||
| imap-append.c | ||
| imap-authzid.c | ||
| imap-copy.c | ||
| imap-create.c | ||
| imap-delete.c | ||
| imap-examine.c | ||
| imap-fetch.c | ||
| imap-list.c | ||
| imap-lsub.c | ||
| imap-multi.c | ||
| imap-noop.c | ||
| imap-search.c | ||
| imap-ssl.c | ||
| imap-store.c | ||
| imap-tls.c | ||
| interface.c | ||
| ipv6.c | ||
| keepalive.c | ||
| localport.c | ||
| log_failed_transfers.c | ||
| Makefile.am | ||
| Makefile.example | ||
| Makefile.inc | ||
| maxconnects.c | ||
| multi-app.c | ||
| multi-debugcallback.c | ||
| multi-double.c | ||
| multi-event.c | ||
| multi-formadd.c | ||
| multi-legacy.c | ||
| multi-post.c | ||
| multi-single.c | ||
| multi-uv.c | ||
| multithread.c | ||
| netrc.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 | ||
| protofeats.c | ||
| range.c | ||
| README.md | ||
| resolve.c | ||
| rtsp-options.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 | ||
| smtp-expn.c | ||
| smtp-mail.c | ||
| smtp-mime.c | ||
| smtp-multi.c | ||
| smtp-ssl.c | ||
| smtp-tls.c | ||
| smtp-vrfy.c | ||
| sslbackend.c | ||
| synctime.c | ||
| threaded-ssl.c | ||
| unixsocket.c | ||
| url2file.c | ||
| urlapi.c | ||
| usercertinmem.c | ||
| version-check.pl | ||
| websocket-cb.c | ||
| websocket-updown.c | ||
| websocket.c | ||
| xmlstream.c | ||
libcurl examples
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 website.
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-my example.c
Some compilers do not like having the arguments in this order but instead want you do reorganize them like:
`curl-config --cc` -o example-my example.c `curl-config --cflags --libs`
Please do not use the curl.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 does not mean that the URLs work or that we expect you to
actually torture our website 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.