Ugrep is compatible with GNU grep and supports GNU grep command-line options. But ugrep also offers new options and features. In general, command-line options can be mixed and specified in any order. Long options --OPTION may start with --no-OPTION to disable them. All short options have long alternatives. This page shows short options for the most part. Specify --stats to output a final summary search report of options, patterns, and search statistics.
| actionscript | = | -O as,mxml |
| ada | = | -O ada,adb,ads |
| asm | = | -O asm,s,S |
| asp | = | -O asp |
| aspx | = | -O master,ascx,asmx,aspx,svc |
| autoconf | = | -O ac,in |
| automake | = | -O am,in |
| awk | = | -O awk |
| Awk | = | -O awk |
| | | -M '#!\h*/.*\Wg?awk(\W.*)?\n' |
| basic | = | -O bas,BAS,cls,frm,ctl,vb,resx |
| batch | = | -O bat,BAT,cmd,CMD |
| bison | = | -O y,yy,ymm,ypp,yxx |
| c | = | -O c,h,H,hdl,xs |
| c++ | = | -O cpp,CPP,cc,cxx,CXX,h,hh,H,hpp,hxx,Hxx,HXX |
| clojure | = | -O clj |
| cpp | = | -O cpp,CPP,cc,cxx,CXX,h,hh,H,hpp,hxx,Hxx,HXX |
| csharp | = | -O cs |
| css | = | -O css |
| csv | = | -O csv |
| dart | = | -O dart |
| Dart | = | -O dart |
| | | -M '#!\h*/.*\Wdart(\W.*)?\n' |
| delphi | = | -O pas,int,dfm,nfm,dof,dpk,dproj,groupproj,bdsgroup,bdsproj |
| elisp | = | -O el |
| elixir | = | -O ex,exs |
| erlang | = | -O erl,hrl |
| fortran | = | -O for,ftn,fpp,f,F,f77,F77,f90,F90,f95,F95,f03,F03 |
| gif | = | -O gif |
| Gif | = | -O gif |
| | | -M 'GIF87a|GIF89a' |
| go | = | -O go |
| groovy | = | -O groovy,gtmpl,gpp,grunit,gradle |
| gsp | = | -O gsp |
| haskell | = | -O hs,lhs |
| html | = | -O htm,html,xhtml |
| jade | = | -O jade |
| java | = | -O java,properties |
| jpeg | = | -O jpg,jpeg |
| Jpeg | = | -O jpg,jpeg |
| | | -M '\xff\xd8\xff[\xdb\xe0\xe1\xee]' |
| js | = | -O js |
| json | = | -O json |
| jsp | = | -O jsp,jspx,jthm,jhtml |
| julia | = | -O jl |
| kotlin | = | -O kt,kts |
| less | = | -O less |
| lex | = | -O l,ll,lmm,lpp,lxx |
| lisp | = | -O lisp,lsp |
| lua | = | -O lua |
| m4 | = | -O m4 |
| make | = | -O mk,mak |
| | | -g makefile,Makefile,Makefile.Debug,Makefile.Release |
| markdown | = | -O md |
| matlab | = | -O m |
| node | = | -O js |
| Node | = | -O js |
| | | -M '#!\h*/.*\Wnode(\W.*)?\n' |
| objc | = | -O m,h |
| objc++ | = | -O mm,h |
| ocaml | = | -O ml,mli,mll,mly |
| parrot | = | -O pir,pasm,pmc,ops,pod,pg,tg |
| pascal | = | -O pas,pp |
| pdf | = | -O pdf |
| Pdf | = | -O pdf |
| | | -M '\x25\x50\x44\x46\x2d' |
| perl | = | -O pl,PL,pm,pod,t,psgi
| Perl | = | -O pl,PL,pm,pod,t,psgi |
| | | -M '#!\h*/.*\Wperl(\W.*)?\n' |
| php | = | -O php,php3,php4,phtml |
| Php | = | -O php,php3,php4,phtml |
| | | -M '#!\h*/.*\Wphp(\W.*)?\n' |
| png | = | -O png |
| Png | = | -O png |
| | | -M '\x89PNG\x0d\x0a\x1a\x0a' |
| prolog | = | -O pl,pro |
| python | = | -O py |
| Python | = | -O py |
| | | -M '#!\h*/.*\Wpython[23]?(\W.*)?\n' |
| r | = | -O R |
| rpm | = | -O rpm |
| Rpm | = | -O rpm |
| | | -M '\xed\xab\xee\xdb' |
| rst | = | -O rst |
| rtf | = | -O rtf |
| Rtf | = | -O rtf |
| | | -M '\{\rtf1' |
| ruby | = | -O rb,rhtml,rjs,rxml,erb,rake,spec |
| | | -g Rakefile |
| Ruby | = | -O rb,rhtml,rjs,rxml,erb,rake,spec |
| | | -g Rakefile |
| | | -M '#!\h*/.*\Wruby(\W.*)?\n' |
| rust | = | -O rs |
| scala | = | -O scala |
| scheme | = | -O scm,ss |
| shell | = | -O sh,bash,dash,csh,tcsh,ksh,zsh,fish |
| Shell | = | -O sh,bash,dash,csh,tcsh,ksh,zsh,fish |
| | | -M '#!\h*/.*\W(ba|da|t?c|k|z|fi)?sh(\W.*)?\n' |
| smalltalk | = | -O st |
| sql | = | -O sql,ctl |
| svg | = | -O svg |
| swift | = | -O swift |
| tcl | = | -O tcl,itcl,itk |
| tex | = | -O tex,cls,sty,bib |
| text | = | -O text,txt,TXT,md,rst |
| tiff | = | -O tif,tiff |
| Tiff | = | -O tif,tiff |
| | | -M '\x49\x49\x2a\x00|\x4d\x4d\x00\x2a' |
| tt | = | -O tt,tt2,ttml |
| typescript | = | -O ts,tsx |
| verilog | = | -O v,vh,sv |
| vhdl | = | -O vhd,vhdl |
| vim | = | -O vim |
| xml | = | -O xml,xsd,xsl,xslt,wsdl,rss,svg,ent,plist |
| Xml | = | -O xml,xsd,xsl,xslt,wsdl,rss,svg,ent,plist |
| | | -M '<\?xml ' |
| yacc | = | -O y |
| yaml | = | -O yaml,yml |
| zig | = | -O zig,zon |
|
A filter utility is associated with one or more filename extensions using the syntax --filter="ext1,ext2,ext3:command". Options to the specified command may be included. The special option % is expanded into the pathname of the file to search. Filters are applied first when the filename extension matches one of the specified filters, then the output of the filter is searched. Some examples:
| %F | if option -H is used: the file pathname and separator |
| %[TEXT]F | if option -H is used: TEXT, the file pathname and separator |
| %f | the file pathname |
| %a | the file basename without directory path |
| %p | the directory path to the file |
| %z | the pathname in a (compressed) archive, without { and } |
| %H | if option -H is used: the quoted pathname and separator, \" and \\ replace " and \ |
| %[TEXT]H | if option -H is used: TEXT, the quoted pathname and separator, \" and \\ replace " and \ |
| %h | the quoted file pathname, \" and \\ replace " and \ |
| %N | if option -n is used: the line number and separator |
| %[TEXT]N | if option -n is used: TEXT, the line number and separator |
| %n | the line number of the match |
| %K | if option -k is used: the column number and separator |
| %[TEXT]K | if option -k is used: TEXT, the column number and separator |
| %k | the column number of the match |
| %B | if option -b is used: the byte offset and separator |
| %[TEXT]B | if option -b is used: TEXT, the byte offset and separator |
| %b | the byte offset of the match |
| %T | if option -T is used: TEXT and a tab character |
| %[TEXT]T | if option -T is used: TEXT and a tab character |
| %t | a tab character |
| %[SEP]$ | set field separator to SEP for the rest of the format fields |
| %[TEXT]< | if the first match: TEXT |
| %[TEXT]> | if not the first match: TEXT |
| %, | if not the first match: a comma, same as %[,]< |
| %: | if not the first match: a colon, same as %[:]> |
| %; | if not the first match: a semicolon, same as %[;]> |
| %| | if not the first match: a vertical bar, same as %[|]> |
| %S | if not the first match: separator, see also %[SEP]$ |
| %[TEXT]S | if not the first match: TEXT and separator, see also %[SEP]$ |
| %s | the separator, see also %[TEXT]S and %[SEP]$ |
| %~ | a newline character |
| %+ | if option --heading is used: %F and a newline character, suppress all %F and %H afterward |
| %m | the number of matches, sequential (or number of matching files with --format-end) |
| %M | the number of matching lines (or number of matching files with --format-end) |
| %O | the matching line is output as is (a raw string of bytes) |
| %o | the match is output as is (a raw string of bytes) |
| %Q | the matching line as a quoted string, \" and \\ replace " and \ |
| %q | the match as a quoted string, \" and \\ replace " and \ |
| %C | the matching line formatted as a quoted C/C++ string |
| %c | the match formatted as a quoted C/C++ string |
| %J | the matching line formatted as a quoted JSON string |
| %j | the match formatted as a quoted JSON string |
| %V | the matching line formatted as a quoted CSV string |
| %v | the match formatted as a quoted CSV string |
| %X | the matching line formatted as XML character data |
| %x | the match formatted as XML character data |
| %w | the width of the match, counting (wide) characters |
| %d | the size of the match, counting bytes |
| %e | the ending byte offset of the match |
| %Z | the edit distance cost of an approximate match with option -Z |
| %u | select unique lines only unless option -u is used |
| %1 %2 ... %9 | the first regex group capture of the match, and so on up to group %9, requires option -P |
| %[NUM]# | the regex group capture NUM; requires option -P |
| %[NUM]b | the byte offset of the group capture NUM; requires option -P |
| %[NUM]e | the ending byte offset of the group capture NUM; requires option -P |
| %[NUM]d | the byte length of the group capture NUM; requires option -P |
| %[NUM1|NUM2|...]# | the first group capture NUM that matched; requires option -P |
| %[NUM1|NUM2|...]b | the byte offset of the first group capture NUM that matched; requires option -P |
| %[NUM1|NUM2|...]e | the ending byte offset of the first group capture NUM that matched; requires option -P |
| %[NUM1|NUM2|...]d | the byte length of the first group capture NUM that matched; requires option -P |
| %[NAME]# | the NAMEd group capture; requires option -P and capturing pattern (?<NAME>PATTERN) |
| %[NAME]b | the byte offset of the NAMEd group capture; requires option -P and capturing pattern (?<NAME>PATTERN) |
| %[NAME]e | the ending byte offset of the NAMEd group capture; requires option -P and capturing pattern (?<NAME>PATTERN) |
| %[NAME]d | the byte length of the NAMEd group capture; requires option -P and capturing pattern (?<NAME>PATTERN) |
| %[NAME1|NAME2|...]# | the first NAMEd group capture that matched; requires option -P and capturing pattern (?<NAME>PATTERN) |
| %[NAME1|NAME2|...]b | the byte offset of the first NAMEd group capture that matched; requires option -P and capturing pattern (?<NAME>PATTERN) |
| %[NAME1|NAME2|...]e | the ending byte offset of the first NAMEd group capture that matched; requires option -P and capturing pattern (?<NAME>PATTERN) |
| %[NAME1|NAME2|...]d | the byte length of the first NAMEd group capture that matched; requires option -P and capturing pattern (?<NAME>PATTERN) |
| %G | all group capture indices/names of the match |
| %[TEXT1|TEXT2|...]G | all TEXT indexed by group capture indices that matched; requires option -P |
| %g | the group capture index of the match or 1 |
| %[TEXT1|TEXT2|...]g | the TEXT indexed by the first group capture index that matched; requires option -P |
| %% | the percentage sign |
