1 /***************************************************************************
2  *                                  _   _ ____  _
3  *  Project                     ___| | | |  _ \| |
4  *                             / __| | | | |_) | |
5  *                            | (__| |_| |  _ <| |___
6  *                             \___|\___/|_| \_\_____|
7  *
8  * Copyright (C) 1998 - 2021, Daniel Stenberg, <daniel@haxx.se>, et al.
9  *
10  * This software is licensed as described in the file COPYING, which
11  * you should have received as part of this distribution. The terms
12  * are also available at https://curl.se/docs/copyright.html.
13  *
14  * You may opt to use, copy, modify, merge, publish, distribute and/or sell
15  * copies of the Software, and permit persons to whom the Software is
16  * furnished to do so, under the terms of the COPYING file.
17  *
18  * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
19  * KIND, either express or implied.
20  *
21  ***************************************************************************/
22 #include "tool_setup.h"
23 
24 #include "strcase.h"
25 
26 #define ENABLE_CURLX_PRINTF
27 /* use our own printf() functions */
28 #include "curlx.h"
29 
30 #include "tool_cfgable.h"
31 #include "tool_msgs.h"
32 #include "tool_getparam.h"
33 #include "tool_helpers.h"
34 
35 #include "memdebug.h" /* keep this as LAST include */
36 
37 /*
38 ** Helper functions that are used from more than one source file.
39 */
40 
param2text(int res)41 const char *param2text(int res)
42 {
43   ParameterError error = (ParameterError)res;
44   switch(error) {
45   case PARAM_GOT_EXTRA_PARAMETER:
46     return "had unsupported trailing garbage";
47   case PARAM_OPTION_UNKNOWN:
48     return "is unknown";
49   case PARAM_OPTION_AMBIGUOUS:
50     return "is ambiguous";
51   case PARAM_REQUIRES_PARAMETER:
52     return "requires parameter";
53   case PARAM_BAD_USE:
54     return "is badly used here";
55   case PARAM_BAD_NUMERIC:
56     return "expected a proper numerical parameter";
57   case PARAM_NEGATIVE_NUMERIC:
58     return "expected a positive numerical parameter";
59   case PARAM_LIBCURL_DOESNT_SUPPORT:
60     return "the installed libcurl version doesn't support this";
61   case PARAM_LIBCURL_UNSUPPORTED_PROTOCOL:
62     return "a specified protocol is unsupported by libcurl";
63   case PARAM_NO_MEM:
64     return "out of memory";
65   case PARAM_NO_PREFIX:
66     return "the given option can't be reversed with a --no- prefix";
67   case PARAM_NUMBER_TOO_LARGE:
68     return "too large number";
69   case PARAM_NO_NOT_BOOLEAN:
70     return "used '--no-' for option that isn't a boolean";
71   case PARAM_CONTDISP_SHOW_HEADER:
72     return "--include and --remote-header-name cannot be combined";
73   case PARAM_CONTDISP_RESUME_FROM:
74     return "--continue-at and --remote-header-name cannot be combined";
75   default:
76     return "unknown error";
77   }
78 }
79 
SetHTTPrequest(struct OperationConfig * config,HttpReq req,HttpReq * store)80 int SetHTTPrequest(struct OperationConfig *config, HttpReq req, HttpReq *store)
81 {
82   /* this mirrors the HttpReq enum in tool_sdecls.h */
83   const char *reqname[]= {
84     "", /* unspec */
85     "GET (-G, --get)",
86     "HEAD (-I, --head)",
87     "multipart formpost (-F, --form)",
88     "POST (-d, --data)"
89   };
90 
91   if((*store == HTTPREQ_UNSPEC) ||
92      (*store == req)) {
93     *store = req;
94     return 0;
95   }
96   warnf(config->global, "You can only select one HTTP request method! "
97         "You asked for both %s and %s.\n",
98         reqname[req], reqname[*store]);
99 
100   return 1;
101 }
102 
customrequest_helper(struct OperationConfig * config,HttpReq req,char * method)103 void customrequest_helper(struct OperationConfig *config, HttpReq req,
104                           char *method)
105 {
106   /* this mirrors the HttpReq enum in tool_sdecls.h */
107   const char *dflt[]= {
108     "GET",
109     "GET",
110     "HEAD",
111     "POST",
112     "POST"
113   };
114 
115   if(!method)
116     ;
117   else if(curl_strequal(method, dflt[req])) {
118     notef(config->global, "Unnecessary use of -X or --request, %s is already "
119           "inferred.\n", dflt[req]);
120   }
121   else if(curl_strequal(method, "head")) {
122     warnf(config->global,
123           "Setting custom HTTP method to HEAD with -X/--request may not work "
124           "the way you want. Consider using -I/--head instead.\n");
125   }
126 }
127