---
name: "nproc"
section: "1"
platform: "freebsd"
package: "base"
version: "16.0-CURRENT-20261027-61c70dc16a79"
release: "FreeBSD 16.0-CURRENT (2026-10-27)"
platforms: ["linux", "freebsd"]
url: "https://new.carta.tech/nproc"
---

# nproc(1)

print the number of processors

## NAME

**nproc** – print the number of processors

## SYNOPSIS

**nproc** \[**--all**\] \[**--ignore**=*count*\]

**nproc** **--help**

**nproc** **--version**

## DESCRIPTION

The **nproc** utility is used to print the number of processors limited to the [cpuset(2)](/cpuset/2.md) of the current process, unless the **--all** flag is specified.

The available flags are:

- **--all**

  Count all processors currently online.

- **--ignore**=*count*

  The result is decreased by *count*, but never below 1.

- **--version**

  Print the current program version and exit. Do not use this option.

- **--help**

  Print usage information and exit.

## COMPATIBILITY

This program is intended to be compatible with nproc as found in GNU coreutils.

## BUGS

If HyperThreading is enabled in BIOS and disabled in the kernel, the **--all** option on Linux will still report all possible CPU threads. On FreeBSD only active threads will be reported.

## SEE ALSO

[cpuset(1)](/cpuset/1.md)

## HISTORY

The **nproc** utility first appeared in FreeBSD 13.2.

## AUTHORS

Mateusz Guzik ⟨*mjg@FreeBSD.org*⟩ wrote the program and Piotr Paweł Stefaniak ⟨*pstef@FreeBSD.org*⟩ wrote this page.