---
name: "mongoc_socket_connect"
section: "3"
platform: "linux"
package: "libmongoc-doc"
version: "1.30.4-1+deb13u3"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/mongoc_socket_connect"
---

# mongoc\_socket\_connect(3)

## SYNOPSIS

```
int
mongoc_socket_connect (mongoc_socket_t *sock,
                       const struct sockaddr *addr,
                       mongoc_socklen_t addrlen,
                       int64_t expire_at);
```

## PARAMETERS

- •

  **sock**: A *mongoc\_socket\_t*.

- •

  **addr**: A struct sockaddr.

- •

  **addrlen**: A mongoc\_socklen\_t.

- •

  **expire\_at**: A int64\_t containing the absolute timeout using the monotonic clock.

## DESCRIPTION

This function is a wrapper around the BSD socket **connect()** interface. It provides better portability between UNIX-like and Microsoft Windows platforms.

This function performs a socket connection but will fail if **expire\_at** has been reached by the monotonic clock. Keep in mind that this is an absolute timeout in milliseconds. You should add your desired timeout to *System Clock*.

## RETURNS

0 if successful, -1 on failure and errno is set.

## AUTHOR

MongoDB, Inc

## COPYRIGHT

2009-present, MongoDB, Inc.