---
name: "gfgrep"
section: "1"
platform: "linux"
package: "gfarm-client"
version: "2.3.2-1"
release: "Debian 6.0 (Squeeze)"
platforms: ["linux"]
url: "https://new.carta.tech/gfgrep"
---

# gfgrep(1)

search a file for a pattern

## NAME

gfgrep - search a file for a pattern

## SYNOPSIS

**gfrun** **gfarm:gfgrep** **-o** *output-gfarm-URL* *pattern* *input-gfarm-URL ...*

**gfrun** **gfarm:gfgrep** **-o** *output-gfarm-URL* **-e** *pattern* *input-gfarm-URL ...*

## DESCRIPTION

**gfgrep** is a sample program of parallel applications executed by [gfrun(1)](/gfrun/1.md) as well as an example to create a Gfarm file in the local file view.

**gfgrep** searches a *pattern* from *input-gfarm-URL*, and outputs to *output-gfarm-URL*.

Every parallel application executed by **[gfrun(1)](/gfrun/1.md)** should interpret the **-I** and **-N** options that show the rank and the size of the parallel program, respectively, and call **gfs\_pio\_set\_local()**.

## OPTIONS

- **-e** *pattern*

  is useful to protect patterns beginning with -.

- **-o** *gfarm-URL*

  specifies an output Gfarm file.

- **-?**

  displays a list of command options.