sdate(1)

Usage

sdate [{-e | --epoch yyyy-mm}] [{-c | --covid vv}] [{-l | --lib library}] [--] [command]

Overview

sdate runs a command in an environment wherein it wraps the libc localtime() and gmtime() calls such that the program will use the eternal September date. The wrapper functions are in a shared library /usr/lib/libsdate/libsdate.so* which is loaded through the LD_PRELOAD mechanism of the dynamic loader. (See ld.so(8))

Options

-e yyyy-mm, --epoch yyyy-mm: Specify an alternative epoch, default is 1993-09.

-c vv, --covid vv: Enable COVID mode, for the specified variant. Sets epoch to an appropriate value for the variant.

-l library, --lib library: Specify an alternative wrapper library.

[--] command: Any command you want to be ran. Use ‘--’ if in the command you have other options that may confuse sdate's option parsing.

-h: Display help.

-v: Display version.

Files

/usr/lib/libsdate/* The shared library containing the wrapper functions.

Environment

LD_PRELOAD

Limitations

Library versions: Every command executed within sdate needs to be linked to the same version of the C library as sdate itself.

Copying

sdate is distributed under the GNU General Public License. (GPL v2 or later).

Releases

10 releases since Debian 4.0 (Etch); the text changed 1 time.

--covid since Debian 11 (Bullseye); -c since Debian 11 (Bullseye).