PAPER(1) User Commands PAPER(1)

# [NAME](#NAME)

paper - print paper size information

# [SYNOPSIS](#SYNOPSIS)

**paper** \[*OPTION*...] \[*PAPER*...*|--all*]

# [DESCRIPTION](#DESCRIPTION)

Print paper size information.

[**--all**](#all)

show information about all known paper sizes

[**--no-size**](#no)

do not show paper sizes (width followed by height)

[**--unit** UNIT](#unit)

unit in which to show sizes \[pt, mm, in; default: natural units]

[**--help**](#help)

display this help message and exit

[**--version**](#version)

display version information and exit

**paper** prints information about the given paper sizes, which can include the standard form of its name, its width and height. The output is designed to be both human- and machine-readable. The name is matched case-insensitively, and ignoring spaces.

If neither a paper size nor the **--all** option is given, the current paper size is used.

The current paper size is obtained by looking in order at the following values until a non-empty value is found. If no paper size is configured, paper exits with an error.

•

The **PAPERSIZE** environment variable

•

The user's default paper size in **$XDG\_CONFIG\_HOME/papersize**

•

The current locale's default paper size (if supported by the system)

•

The system default paper size in **/etc/papersize**

•

The first paper size in the system list

•

The first paper size in the user's list

# [ENVIRONMENT VARIABLES](#ENVIRONMENT_VARIABLES)

[**PAPERSIZE**](#PAPERSIZE)

Paper size to use.

# [FILES](#FILES)

**/etc/papersize**

System default paper size.

**$XDG\_CONFIG\_HOME/papersize**

User's default paper size.

# [AUTHOR](#AUTHOR)

Written by Reuben Thomas.

# [REPORTING BUGS](#REPORTING_BUGS)

Report bugs at https://github.com/rrthomas/libpaper

# [COPYRIGHT](#COPYRIGHT)

Copyright © 2013-2022 Reuben Thomas <rrt@sc3d.org>. paper comes with ABSOLUTELY NO WARRANTY. You may redistribute copies of paper under the terms of the GNU General Public License version 3, or, at your option, any later version.See <https://www.gnu.org/licenses/gpl-3.0.html>.

# [SEE ALSO](#SEE_ALSO)

[**paperspecs**(5)](/man/os/libpaper/paperspecs.5)

October 2026 paper 2.2.8

---

Document: paper(1) from libpaper 2.2.8-r4 (Chainguard OS)
Source: https://github.com/rrthomas/libpaper