/src/PROJ/curl/lib/curl_gethostname.c
Line | Count | Source (jump to first uncovered line) |
1 | | /*************************************************************************** |
2 | | * _ _ ____ _ |
3 | | * Project ___| | | | _ \| | |
4 | | * / __| | | | |_) | | |
5 | | * | (__| |_| | _ <| |___ |
6 | | * \___|\___/|_| \_\_____| |
7 | | * |
8 | | * Copyright (C) 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 | | * SPDX-License-Identifier: curl |
22 | | * |
23 | | ***************************************************************************/ |
24 | | |
25 | | #include "curl_setup.h" |
26 | | |
27 | | #include "curl_gethostname.h" |
28 | | |
29 | | /* |
30 | | * Curl_gethostname() is a wrapper around gethostname() which allows |
31 | | * overriding the host name that the function would normally return. |
32 | | * This capability is used by the test suite to verify exact matching |
33 | | * of NTLM authentication, which exercises libcurl's MD4 and DES code |
34 | | * as well as by the SMTP module when a hostname is not provided. |
35 | | * |
36 | | * For libcurl debug enabled builds host name overriding takes place |
37 | | * when environment variable CURL_GETHOSTNAME is set, using the value |
38 | | * held by the variable to override returned host name. |
39 | | * |
40 | | * Note: The function always returns the un-qualified hostname rather |
41 | | * than being provider dependent. |
42 | | * |
43 | | * For libcurl shared library release builds the test suite preloads |
44 | | * another shared library named libhostname using the LD_PRELOAD |
45 | | * mechanism which intercepts, and might override, the gethostname() |
46 | | * function call. In this case a given platform must support the |
47 | | * LD_PRELOAD mechanism and additionally have environment variable |
48 | | * CURL_GETHOSTNAME set in order to override the returned host name. |
49 | | * |
50 | | * For libcurl static library release builds no overriding takes place. |
51 | | */ |
52 | | |
53 | | int Curl_gethostname(char * const name, GETHOSTNAME_TYPE_ARG2 namelen) |
54 | 0 | { |
55 | | #ifndef HAVE_GETHOSTNAME |
56 | | |
57 | | /* Allow compilation and return failure when unavailable */ |
58 | | (void) name; |
59 | | (void) namelen; |
60 | | return -1; |
61 | | |
62 | | #else |
63 | 0 | int err; |
64 | 0 | char *dot; |
65 | |
|
66 | | #ifdef DEBUGBUILD |
67 | | |
68 | | /* Override host name when environment variable CURL_GETHOSTNAME is set */ |
69 | | const char *force_hostname = getenv("CURL_GETHOSTNAME"); |
70 | | if(force_hostname) { |
71 | | strncpy(name, force_hostname, namelen); |
72 | | err = 0; |
73 | | } |
74 | | else { |
75 | | name[0] = '\0'; |
76 | | err = gethostname(name, namelen); |
77 | | } |
78 | | |
79 | | #else /* DEBUGBUILD */ |
80 | | |
81 | | /* The call to system's gethostname() might get intercepted by the |
82 | | libhostname library when libcurl is built as a non-debug shared |
83 | | library when running the test suite. */ |
84 | 0 | name[0] = '\0'; |
85 | 0 | err = gethostname(name, namelen); |
86 | |
|
87 | 0 | #endif |
88 | |
|
89 | 0 | name[namelen - 1] = '\0'; |
90 | |
|
91 | 0 | if(err) |
92 | 0 | return err; |
93 | | |
94 | | /* Truncate domain, leave only machine name */ |
95 | 0 | dot = strchr(name, '.'); |
96 | 0 | if(dot) |
97 | 0 | *dot = '\0'; |
98 | |
|
99 | 0 | return 0; |
100 | 0 | #endif |
101 | |
|
102 | 0 | } |