xref: /aosp_15_r20/external/sandboxed-api/oss-internship-2020/curl/examples/README.md (revision ec63e07ab9515d95e79c211197c445ef84cefa6a) 
1# LibCurl Sandbox Examples
2
3Each example in this folder is the sandboxed version of a code snippet from
4[this page](https://curl.haxx.se/libcurl/c/example.html) on curl's website.
5These examples perform some basic tasks using libcurl, and can be useful both to
6understand how to use LibCurl Sandbox, but also to get an idea of how regular
7and sandboxed code compare to each other.
8
9This is the list of the examples:
10
11-   **example1**: sandboxed version of
12    [simple.c](https://curl.haxx.se/libcurl/c/simple.html). Really simple HTTP
13    request, downloads and prints out the page at
14    [example.com](http://example.com).
15-   **example2**: sandboxed version of
16    [getinmemory.c](https://curl.haxx.se/libcurl/c/getinmemory.html). Same HTTP
17    request as example1. The difference is that this example uses a callback to
18    save the page directly in memory. Only the page size is printed out.
19-   **example3**: sandboxed version of
20    [simplessl.c](https://curl.haxx.se/libcurl/c/simplessl.html). HTTPS request
21    of the [example.com](https://example.com) page, using SSL authentication.
22    This script takes 4 arguments (SSL certificates file, SSL keys file, SSL
23    keys password and CA certificates files), and prints out the page.
24-   **example4**: sandboxed version of
25    [multi-poll.c](https://curl.haxx.se/libcurl/c/multi-poll.html). Same HTTP
26    request as example1, with the addition of a polling method that can be used
27    to track the status of the request. The page is printed out after it is
28    downloaded.
29-   **example5**: sandboxed version of
30    [multithread.c](https://curl.haxx.se/libcurl/c/multithread.html). Four HTTP
31    request of the pages [example.com](http://example.com),
32    [example.edu](http://example.edu), [example.net](http://example.net) and
33    [example.org](http://example.org), performed at the same time using
34    libcurl's multithreading methods. The pages are printed out.
35-   **example6**: sandboxed version of
36    [simple.c](https://curl.haxx.se/libcurl/c/simple.html). Performs the same
37    tasks as example1, but Sandbox API Transactions are used to show how they
38    can be used to perform a simple request.
39