---
name: "upscli_set_default_connect_timeout"
section: "3"
platform: "linux"
package: "nut"
version: "2.8.5-2"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/upscli_set_default_connect_timeout"
---

# upscli\_set\_default\_connect\_timeout(3)

Configure upsclient module aspect of default timeout for initial connections.

## NAME

upscli\_set\_default\_connect\_timeout - Configure upsclient module aspect of default timeout for initial connections.

## SYNOPSIS

```
        #include <upsclient.h>
        int upscli_set_default_connect_timeout(const char *secs);
```

## DESCRIPTION

The **upscli\_set\_default\_connect\_timeout()** function assigns upsclient module internal default connection timeout for [**upscli\_connect**(3)](/upscli_connect/3.md) from a C string which represents a floating-point non-negative number (invalid parsing is ignored and does not modify the previously stored value), a NULL argument value sets the internal timeout to *0* meaning indefinitely blocking (NUT default for this method over at least 20 years).

While this method can be called explicitly, it is recommended to call the [**upscli\_init\_default\_connect\_timeout**(3)](/upscli_init_default_connect_timeout/3.md) for consistent setting from a number of sources with different priority.

## RETURN VALUE

The **upscli\_set\_default\_connect\_timeout()** function returns *0* on success (either if the strings was NULL so the built-in default *0* is applied, or if its content was valid and its value got applied), or *-1* if an error occurs (string was not NULL, and its content was not valid — not a number, negative, etc.)

## SEE ALSO

[**upscli\_connect**(3)](/upscli_connect/3.md), **upscli\_tryconnect**(3), [**upscli\_init\_default\_connect\_timeout**(3)](/upscli_init_default_connect_timeout/3.md), [**upscli\_get\_default\_connect\_timeout**(3)](/upscli_get_default_connect_timeout/3.md)