123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253 |
- /***************************************************************************
- * _ _ ____ _
- * Project ___| | | | _ \| |
- * / __| | | | |_) | |
- * | (__| |_| | _ <| |___
- * \___|\___/|_| \_\_____|
- *
- * Copyright (C) 1998 - 2022, Daniel Stenberg, <daniel@haxx.se>, et al.
- *
- * This software is licensed as described in the file COPYING, which
- * you should have received as part of this distribution. The terms
- * are also available at https://curl.se/docs/copyright.html.
- *
- * You may opt to use, copy, modify, merge, publish, distribute and/or sell
- * copies of the Software, and permit persons to whom the Software is
- * furnished to do so, under the terms of the COPYING file.
- *
- * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
- * KIND, either express or implied.
- *
- * SPDX-License-Identifier: curl
- *
- ***************************************************************************/
- #include "tool_setup.h"
- #define ENABLE_CURLX_PRINTF
- /* use our own printf() functions */
- #include "curlx.h"
- #include "tool_panykey.h"
- #include "tool_help.h"
- #include "tool_libinfo.h"
- #include "tool_util.h"
- #include "tool_version.h"
- #include "memdebug.h" /* keep this as LAST include */
- #ifdef MSDOS
- # define USE_WATT32
- #endif
- struct category_descriptors {
- const char *opt;
- const char *desc;
- curlhelp_t category;
- };
- static const struct category_descriptors categories[] = {
- {"auth", "Different types of authentication methods", CURLHELP_AUTH},
- {"connection", "Low level networking operations",
- CURLHELP_CONNECTION},
- {"curl", "The command line tool itself", CURLHELP_CURL},
- {"dns", "General DNS options", CURLHELP_DNS},
- {"file", "FILE protocol options", CURLHELP_FILE},
- {"ftp", "FTP protocol options", CURLHELP_FTP},
- {"http", "HTTP and HTTPS protocol options", CURLHELP_HTTP},
- {"imap", "IMAP protocol options", CURLHELP_IMAP},
- /* important is left out because it is the default help page */
- {"misc", "Options that don't fit into any other category", CURLHELP_MISC},
- {"output", "Filesystem output", CURLHELP_OUTPUT},
- {"pop3", "POP3 protocol options", CURLHELP_POP3},
- {"post", "HTTP Post specific options", CURLHELP_POST},
- {"proxy", "All options related to proxies", CURLHELP_PROXY},
- {"scp", "SCP protocol options", CURLHELP_SCP},
- {"sftp", "SFTP protocol options", CURLHELP_SFTP},
- {"smtp", "SMTP protocol options", CURLHELP_SMTP},
- {"ssh", "SSH protocol options", CURLHELP_SSH},
- {"telnet", "TELNET protocol options", CURLHELP_TELNET},
- {"tftp", "TFTP protocol options", CURLHELP_TFTP},
- {"tls", "All TLS/SSL related options", CURLHELP_TLS},
- {"upload", "All options for uploads",
- CURLHELP_UPLOAD},
- {"verbose", "Options related to any kind of command line output of curl",
- CURLHELP_VERBOSE},
- {NULL, NULL, CURLHELP_HIDDEN}
- };
- extern const struct helptxt helptext[];
- struct feat {
- const char *name;
- int bitmask;
- };
- static const struct feat feats[] = {
- {"AsynchDNS", CURL_VERSION_ASYNCHDNS},
- {"Debug", CURL_VERSION_DEBUG},
- {"TrackMemory", CURL_VERSION_CURLDEBUG},
- {"IDN", CURL_VERSION_IDN},
- {"IPv6", CURL_VERSION_IPV6},
- {"Largefile", CURL_VERSION_LARGEFILE},
- {"Unicode", CURL_VERSION_UNICODE},
- {"SSPI", CURL_VERSION_SSPI},
- {"GSS-API", CURL_VERSION_GSSAPI},
- {"Kerberos", CURL_VERSION_KERBEROS5},
- {"SPNEGO", CURL_VERSION_SPNEGO},
- {"NTLM", CURL_VERSION_NTLM},
- {"NTLM_WB", CURL_VERSION_NTLM_WB},
- {"SSL", CURL_VERSION_SSL},
- {"libz", CURL_VERSION_LIBZ},
- {"brotli", CURL_VERSION_BROTLI},
- {"zstd", CURL_VERSION_ZSTD},
- {"CharConv", CURL_VERSION_CONV},
- {"TLS-SRP", CURL_VERSION_TLSAUTH_SRP},
- {"HTTP2", CURL_VERSION_HTTP2},
- {"HTTP3", CURL_VERSION_HTTP3},
- {"UnixSockets", CURL_VERSION_UNIX_SOCKETS},
- {"HTTPS-proxy", CURL_VERSION_HTTPS_PROXY},
- {"MultiSSL", CURL_VERSION_MULTI_SSL},
- {"PSL", CURL_VERSION_PSL},
- {"alt-svc", CURL_VERSION_ALTSVC},
- {"HSTS", CURL_VERSION_HSTS},
- {"gsasl", CURL_VERSION_GSASL},
- {"threadsafe", CURL_VERSION_THREADSAFE},
- };
- static void print_category(curlhelp_t category)
- {
- unsigned int i;
- size_t longopt = 5;
- size_t longdesc = 5;
- for(i = 0; helptext[i].opt; ++i) {
- size_t len;
- if(!(helptext[i].categories & category))
- continue;
- len = strlen(helptext[i].opt);
- if(len > longopt)
- longopt = len;
- len = strlen(helptext[i].desc);
- if(len > longdesc)
- longdesc = len;
- }
- if(longopt + longdesc > 80)
- longopt = 80 - longdesc;
- for(i = 0; helptext[i].opt; ++i)
- if(helptext[i].categories & category) {
- printf(" %-*s %s\n", (int)longopt, helptext[i].opt, helptext[i].desc);
- }
- }
- /* Prints category if found. If not, it returns 1 */
- static int get_category_content(const char *category)
- {
- unsigned int i;
- for(i = 0; categories[i].opt; ++i)
- if(curl_strequal(categories[i].opt, category)) {
- printf("%s: %s\n", categories[i].opt, categories[i].desc);
- print_category(categories[i].category);
- return 0;
- }
- return 1;
- }
- /* Prints all categories and their description */
- static void get_categories(void)
- {
- unsigned int i;
- for(i = 0; categories[i].opt; ++i)
- printf(" %-11s %s\n", categories[i].opt, categories[i].desc);
- }
- void tool_help(char *category)
- {
- puts("Usage: curl [options...] <url>");
- /* If no category was provided */
- if(!category) {
- const char *category_note = "\nThis is not the full help, this "
- "menu is stripped into categories.\nUse \"--help category\" to get "
- "an overview of all categories.\nFor all options use the manual"
- " or \"--help all\".";
- print_category(CURLHELP_IMPORTANT);
- puts(category_note);
- }
- /* Lets print everything if "all" was provided */
- else if(curl_strequal(category, "all"))
- /* Print everything except hidden */
- print_category(~(CURLHELP_HIDDEN));
- /* Lets handle the string "category" differently to not print an errormsg */
- else if(curl_strequal(category, "category"))
- get_categories();
- /* Otherwise print category and handle the case if the cat was not found */
- else if(get_category_content(category)) {
- puts("Invalid category provided, here is a list of all categories:\n");
- get_categories();
- }
- free(category);
- }
- void tool_version_info(void)
- {
- const char *const *proto;
- printf(CURL_ID "%s\n", curl_version());
- #ifdef CURL_PATCHSTAMP
- printf("Release-Date: %s, security patched: %s\n",
- LIBCURL_TIMESTAMP, CURL_PATCHSTAMP);
- #else
- printf("Release-Date: %s\n", LIBCURL_TIMESTAMP);
- #endif
- if(curlinfo->protocols) {
- printf("Protocols: ");
- for(proto = curlinfo->protocols; *proto; ++proto) {
- /* Special case: do not list rtmp?* protocols.
- They may only appear together with "rtmp" */
- if(!curl_strnequal(*proto, "rtmp", 4) || !proto[0][4])
- printf("%s ", *proto);
- }
- puts(""); /* newline */
- }
- if(curlinfo->features) {
- char *featp[ sizeof(feats) / sizeof(feats[0]) + 1];
- size_t numfeat = 0;
- unsigned int i;
- printf("Features:");
- for(i = 0; i < sizeof(feats)/sizeof(feats[0]); i++) {
- if(curlinfo->features & feats[i].bitmask)
- featp[numfeat++] = (char *)feats[i].name;
- }
- qsort(&featp[0], numfeat, sizeof(char *), struplocompare4sort);
- for(i = 0; i< numfeat; i++)
- printf(" %s", featp[i]);
- puts(""); /* newline */
- }
- if(strcmp(CURL_VERSION, curlinfo->version)) {
- printf("WARNING: curl and libcurl versions do not match. "
- "Functionality may be affected.\n");
- }
- }
- void tool_list_engines(void)
- {
- CURL *curl = curl_easy_init();
- struct curl_slist *engines = NULL;
- /* Get the list of engines */
- curl_easy_getinfo(curl, CURLINFO_SSL_ENGINES, &engines);
- puts("Build-time engines:");
- if(engines) {
- for(; engines; engines = engines->next)
- printf(" %s\n", engines->data);
- }
- else {
- puts(" <none>");
- }
- /* Cleanup the list of engines */
- curl_slist_free_all(engines);
- curl_easy_cleanup(curl);
- }
|