---
name: "pfcat"
section: "1p"
platform: "linux"
package: "pmtools"
version: "2.2.0-3"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/pfcat"
---

# pfcat(1p)

grep out function definitions from perlfunc

## NAME

pfcat - grep out function definitions from perlfunc

## DESCRIPTION

This program uses *podgrep* program to search your configuration's perlfunc for function definitions.  It honors a **-f** flag to  format through *pod2text* and a **-p** flag to send the output through the pager.  (Actually, it just passes these to *podgrep*.)

## EXAMPLES

```
    $ pfcat seek
    (find all seek functions (including sysseek))
    $ pfcat -pf sprintf
    (sprintf function is formatted and sent to pager)
    $ pfcat -f '\bint\b'
    /usr/local/devperl/lib/5.00554/pod/perlfunc.pod chunk 506
    int EXPR
    int
    Returns the integer portion of EXPR. If EXPR is omitted, uses
    `$_'. You should not use this for rounding, because it truncates
    towards `0', and because machine representations of floating point
    numbers can sometimes produce counterintuitive results. Usually
    `sprintf()' or `printf()', or the `POSIX::floor' or `POSIX::ceil'
    functions, would serve you better.
```

You can also run this using alternate perl binaries, like so:

```
    $ oldperl -S pfcat open
    ....
```

## SEE ALSO

**podgrep**(1)

## AUTHORS and COPYRIGHTS

Copyright (C) 1999 Tom Christiansen.

Copyright (C) 2006-2014 Mark Leighton Fisher.

## LICENSE

This is free software; you can redistribute it and/or modify it under the terms of either: (a) the GNU General Public License as published by the Free Software Foundation; either version 1, or (at your option) any later version, or (b) the Perl "Artistic License". (This is the Perl 5 licensing scheme.)

Please note this is a change from the original pmtools-1.00 (still available on CPAN), as pmtools-1.00 were licensed only under the Perl "Artistic License".