elftc_set_timestamps(3)

elftc_set_timestamps3

Set file timestamps

Usage

#include <libelftc.h>

int

elftc_set_timestamps(const char *filename, struct stat *sb);

Library

library “libelftc”

Overview

The elftc_set_timestamps() function is used to set the access and modified time stamps on a file based on the contents of a struct stat descriptor.

Argument filename names an existing file in the file system.

Argument sb points to structure of type struct stat populated by a prior call to fstat(2) or stat(2).

Implementation notes

This function will invoke the high-resolution utimes(2) system call if the underlying operating system supports it. On operating systems lacking support for utimes(2), the function will use lower resolution utime(2) system call.

Examples

To set the access and modified times for a new file to those of an existing file, use:

struct stat sb;
const char *existing_filename, *new_filename;
if (stat(existing_filename, &sb) < 0)
	err(EXIT_FAILURE, "stat failed");
if (elftc_set_timestamps(new_filename, &sb) < 0)
	err(EXIT_FAILURE, "timestamps could not be set");

Releases

24 releases since FreeBSD 11.1-RELEASE; the text changed 1 time.

  1. 11.1–12.0
  2. 12.1–16.0

From base 16.0-CURRENT-20261027-61c70dc16a79 in FreeBSD 16.0-CURRENT (2026-10-27). Parsed by carta from the page's mdoc source.