OS Manuals

/usr/bin/nl

GNU core utilities

From coreutils 9.12-r7 (os), captured 2026-11-05 by running nl --help (exit 0). permalink

Also provided by 1 other package version
Usage: /usr/bin/nl [OPTION]... [FILE]...
Write each FILE to standard output, with line numbers added.

With no FILE, or when FILE is -, read standard input.

Mandatory arguments to long options are mandatory for short options too.
  -b, --body-numbering=STYLE      use STYLE for numbering body lines
  -d, --section-delimiter=CC      use CC for logical page delimiters
  -f, --footer-numbering=STYLE    use STYLE for numbering footer lines
  -h, --header-numbering=STYLE    use STYLE for numbering header lines
  -i, --line-increment=NUMBER     line number increment at each line
  -l, --join-blank-lines=NUMBER   group of NUMBER empty lines counted as one
  -n, --number-format=FORMAT      insert line numbers according to FORMAT
  -p, --no-renumber               do not reset line numbers for each section
  -s, --number-separator=STRING   add STRING after (possible) line number
  -v, --starting-line-number=NUMBER  first line number for each section
  -w, --number-width=NUMBER       use NUMBER columns for line numbers
      --help
         display this help and exit
      --version
         output version information and exit

Default options are: -bt -d'\:' -fn -hn -i1 -l1 -n'rn' -s<TAB> -v1 -w6

CC are two delimiter characters used to construct logical page delimiters;
a missing second character implies ':'.  As a GNU extension one can specify
more than two characters, and also specifying the empty string (-d '')
disables section matching.

STYLE is one of:

  a      number all lines
  t      number only nonempty lines
  n      number no lines
  pBRE   number only lines that contain a match for the basic regular
         expression, BRE

FORMAT is one of:

  ln     left justified, no leading zeros
  rn     right justified, no leading zeros
  rz     right justified, leading zeros


Report bugs to: <bug-coreutils@gnu.org>.
GNU coreutils home page: <https://www.gnu.org/software/coreutils/>
General help using GNU software: <https://www.gnu.org/gethelp/>
Full documentation <https://www.gnu.org/software/coreutils/nl>
or available locally via: info '(coreutils) nl invocation'
Options (13)
OptionDescriptionSource
-b, --body-numbering STYLEuse STYLE for numbering body lineshelp + man
-d, --section-delimiter CCuse CC for logical page delimitershelp + man
-f, --footer-numbering STYLEuse STYLE for numbering footer lineshelp + man
-h, --header-numbering STYLEuse STYLE for numbering header lineshelp + man
-i, --line-increment NUMBERline number increment at each linehelp + man
-l, --join-blank-lines NUMBERgroup of NUMBER empty lines counted as onehelp + man
-n, --number-format FORMATinsert line numbers according to FORMAThelp + man
-p, --no-renumberdo not reset line numbers for each sectionhelp + man
-s, --number-separator STRINGadd STRING after (possible) line numberhelp + man
-v, --starting-line-number NUMBERfirst line number for each sectionhelp + man
-w, --number-width NUMBERuse NUMBER columns for line numbershelp + man
--helpdisplay this help and exithelp + man
--versionoutput version information and exithelp + man

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.