FINDRULE(1) User Contributed Perl Documentation FINDRULE(1)

# [NAME](#NAME)

findrule - command line wrapper to File::Find::Rule

# [USAGE](#USAGE)

```
  findrule [path...] [expression]
```

# [DESCRIPTION](#DESCRIPTION)

"findrule" mostly borrows the interface from GNU [**find**(1)](/man/os/perl-file-find-rule/find.1) to provide a command-line interface onto the File::Find::Rule heirarchy of modules.

The syntax for expressions is the rule name, preceded by a dash, followed by an optional argument. If the argument is an opening parenthesis it is taken as a list of arguments, terminated by a closing parenthesis.

Some examples:

```
 find -file -name ( foo bar )
```

files named "foo" or "bar", below the current directory.

```
 find -file -name foo -bar
```

files named "foo", that have pubs (for this is what our ficticious "bar" clause specifies), below the current directory.

```
 find -file -name ( -bar )
```

files named "-bar", below the current directory. In this case if we'd have omitted the parenthesis it would have parsed as a call to name with no arguments, followed by a call to -bar.

## [Supported switches](#Supported_switches)

I'm very slack. Please consult the File::Find::Rule manpage for now, and prepend - to the commands that you want.

## [Extra bonus switches](#Extra_bonus_switches)

findrule automatically loads all of your installed File::Find::Rule::* extension modules, so check the documentation to see what those would be.

# [AUTHOR](#AUTHOR)

Richard Clamp <richardc@unixbeard.net> from a suggestion by Tatsuhiko Miyagawa

# [COPYRIGHT](#COPYRIGHT)

Copyright (C) 2002 Richard Clamp. All Rights Reserved.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

# [SEE ALSO](#SEE_ALSO)

File::Find::Rule

2026-10-24 perl v5.44.0

---

Document: findrule(1) from perl-file-find-rule 0.35-r3 (Chainguard OS)
Source: https://cpan.metacpan.org/authors/id/R/RC/RCLAMP/File-Find-Rule-0.35.tar.gz