---
name: "hostgrep"
section: "1"
platform: "linux"
package: "python3-hostlist"
version: "2.2.1-2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/hostgrep"
---

# hostgrep(1)

print lines matching hostlist

## NAME

hostgrep - print lines matching hostlist

## SYNOPSIS

**hostgrep** \[*OPTION*\]... *HOSTLIST* \[*FILE*\]...

## DESCRIPTION

Search the files for lines matching the given hostlist. If no files are given, search the standard input.

For each line, the program tries to find all hostnames and hostlists. Hostlists are then expanded to hostnames. The set of hostnames in a line is then compared to the set of hostnames given by the  *HOSTLIST* on the command line. By default, the line is printed if any hostname from the *HOSTLIST* is found in the line.

## OPTIONS

- **--all**

  Print a line if all hostnames in the given *HOSTLIST* is found in the line.

- **--any**

  Print a line if any hostname in the given *HOSTLIST* is found in the line (the default).

- **-h, --no-filename**

  Do not show the filename in front of matching line. This is the default if at most one *FILE* is given.

- **-H, --with-filename**

  Show the filename in front of matching lines. This is the default if two or more *FILES* are given.

- **-v, --invert-match**

  Invert the sense of matching, to select non-matching lines.

- **-n, --line-number**

  Show line number before match.

- **--restrict=***REGEXP*

  Restrict host matching to the part of the line that is matched as group 1 by this regexp.

## EXAMPLES

- Search for lines in an accounting file where any of the three hosts is present (as a hostname or part of a hostlist):

  **hostgrep** n\[100-102\] /var/log/slurm/accounting/2009-02-22

- Search for lines in the accounting files where all of the three hosts are present (as a hostname or part of a hostlist). Do not show filenames:

  **hostgrep** -h --all n\[100-102\] /var/log/slurm/accounting/\*

- Search for lines on stdin where nodes in n\[1-8\] are mentioned in the part of the line that comes before the first colon:

  **hostgrep** --restrict='^(\[^:\]\*):' n\[1-8\]

## BUGS

The program has a rather naive notion of what constitutes hostnames and hostlist.

For version 1.21 and earlier, hostnames were allowed to contain exactly upper and lower case A-Z and the digits 0-9. This meant that you could not grep for names like "rack02-pos13". From version 1.22, the code dynamically adds additional characters from the hostlist provided on the command line, so that it will work to grep for hostnames containing those characters.

## AUTHOR

Written by Kent Engström \<kent@nsc.liu.se\>.

The program is published at http://www.nsc.liu.se/~kent/python-hostlist/

## SEE ALSO

*hostlist* (1)

The hostlist expression syntax is used by several programs developed at  **LLNL** (https://computing.llnl.gov/linux/), for example **SLURM** (https://computing.llnl.gov/linux/slurm/) and  **Pdsh** (https://computing.llnl.gov/linux/pdsh.html).

See the **HOSTLIST EXPRESSIONS** section of the [**pdsh**(1)](/pdsh/1.md) manual page for a short introduction to the hostlist syntax.