TRUE(1P)

📦 version 2017a, in alpine 3.22, alpine 3.23, alpine 3.24, arch rolling, nixpkgs unstable, opensuse-leap 16.0

💖 TRUE(1P) 💖

okay bestie, welcome to the POSIX Programmer's Manual — this is the TRUE(1P) page, and yes it is about a command that does literally nothing and that is iconic of it 💅

🌸 PROLOG 🌸

This manual page is part of the POSIX Programmer's Manual. The Linux implementation of this interface may differ (consult the corresponding Linux manual page for details of Linux behavior), or the interface may not be implemented on Linux.

fr fr, check your local page before you come for me 🫶

✨ NAME ✨

true — return true value

that's it. that's the job. return true. main character energy, zero responsibilities 💀

🎀 SYNOPSIS 🎀

true

no flags. no args. no notes. she simply exists ✨

🦋 DESCRIPTION 🦋

The true utility shall return with exit code zero.

and that's the whole personality bestie. she walks in, she exits zero, she leaves 😌

💜 OPTIONS 💜

None.

not "a few". not "optional". None. not me having nothing to list 🙈

🌸 OPERANDS 🌸

None.

💖 STDIN 💖

Not used.

💜 INPUT FILES 💜

None.

🌈 ENVIRONMENT VARIABLES 🌈

None.

⭐ ASYNCHRONOUS EVENTS ⭐

Default.

🎀 STDOUT 🎀

Not used.

🎀 STDERR 🎀

Not used.

💜 OUTPUT FILES 💜

None.

🧚 EXTENDED DESCRIPTION 🧚

None.

🔥 EXIT STATUS 🔥

Zero.

yes queen, zero, always zero, that's the whole point 👑

💀 CONSEQUENCES OF ERRORS 💀

None.

The following sections are informative.

💅 APPLICATION USAGE 💅

This utility is typically used in shell scripts, as shown in the EXAMPLES section. The special built-in utility : is sometimes more efficient than true.

so like, if you're being a little performance gremlin, : might be your girl, but true is right there and she's readable 🫶

🌟 EXAMPLES 🌟

This command is executed forever:

while true
do
    command
done

forever. FOREVER bestie. do not run this and then be surprised when it does not stop 😭 that's the point of it, that's the assignment 💖

🧠 RATIONALE 🧠

The true utility has been retained in this volume of POSIX.1‐2017, even though the shell special built-in : provides similar functionality, because true is widely used in historical scripts and is less cryptic to novice script readers.

ngl that's so valid of them. keeping the readable one around for the girlies who are new here 🌸

🔮 FUTURE DIRECTIONS 🔮

None.

👀 SEE ALSO 👀

Section 2.9, Shell Commands, false

(her evil twin. or her mirror. or honestly just her with a different exit code, slay 🌈)

Portions of this text are reprinted and reproduced in electronic form from IEEE Std 1003.1-2017, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 7, 2018 Edition, Copyright (C) 2018 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between this version and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html .

Any typographical or formatting errors that appear in this page are most likely to have been introduced during the conversion of the source files to man page format. To report such errors, see https://www.kernel.org/doc/man-pages/reporting_bugs.html .

and that's the whole page bestie — brought to you by IEEE/The Open Group, 2017, on the TRUE(1P) page 💖✨ thanks for reading, exit zero on your way out 🎀

📦 where this page comes from