strlcpy(3)

strlcpy3

String return-hypothetical-non-truncated-length copy/catenate (with truncation)

Usage

#include <string.h>

size_t strlcpy(size_t dsize; char dst[restrict dsize], const char *restrict src, size_t dsize); size_t strlcat(size_t dsize; char dst[restrict dsize], const char *restrict src, size_t dsize);

Library

Standard C library (libc, -lc)

Overview

strlcpy() copies the string pointed to by src, into a string at the buffer pointed to by dst.

strlcat() catenates the string pointed to by src, after the string pointed to by dst (overwriting its terminating null byte).

For both functions, if the string doesn't fit in the buffer, it is truncated.

Return value

These functions return the total length of the string they tried to create, as if truncation didn't happen.

Releases

6 releases since Debian 5.0 (Lenny); the text changed 3 times.

  1. 5.0
  2. 6.0
  3. 7–9
  4. Arch

Standards

POSIX.1-2024.

History

OpenBSD 2.4, POSIX.1-2024, glibc 2.38.

Bugs

These functions are vulnerable to denial of service (DoS) attacks, since they read the entire source string.

strscpy(9) is a better function for copying with truncation, as it doesn't have that issue. It's not provided by libc, so users should write their own implementation.

From man-pages 6.19-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.