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) manual page for a short introduction to the hostlist
       syntax.

                                                  Version 2.2.1                                      hostgrep(1)