NAME
dog − better than cat
SYNOPSIS
dog [−AbBeEnstTuv] [−w cols] [−l lines] [−−show−all] [−−number−nonblank] [−−no−blanks] [−−bind=port] [−−dos] [−−show−ends] [−−hang−up] [−−images] [−−krad] [−−links] [−−lower] [−−mac] [−−number] [−−no−header] [−−squeeze−blank] [−−strfry] [−−sock=domain:port] [−−sock−test] [−−show−tabs] [−−raw] [−−rot=num] [−−udp] [−−unix] [−−upper] [−−show−nonprinting] [−−hide−nonprinting] [−−help] [−−hex] [−−skip−tags] [−−oog] [−−version] file | URL | -
DESCRIPTION
dog writes the contents of each given file, URL, or the standard input if none are given or when a file named ’-’ is given, to the standard output. It currently supports the file, http, and raw URL types. It is designed as a compatible, but enhanced, replacement of cat(1).
OPTIONS
−A, −−show−all
Equivalent to −vET
−b, −−number-nonblank
Number all nonblank output lines, starting with 1.
−e |
Equivalent to −vE |
−E, −−show−ends
Display a ’$’ at the end of each line.
−n, −−number
Number all output lines, starting with 1.
−s, −−squeeze-blank
Replace multiple adjacent blank lines with a single blank line.
−t |
Equivalent to −vT |
−T, −−show−tabs
Display TAB characters as ’^I’.
−u |
Ignored; for Unix compatibility. |
|||
−w n |
Print first n characters of each line (default=80) |
−v, −−show−nonprinting
Display control characters except for LFD and TAB using ’^’ notation and precede characters that have the high bit set with ’M-’.
−−hide−nonprinting
Strip nonprinting characters when printing to output.
−B, −−no−blanks
Only print lines that contain atleast one non-whitespace character.
−−udp |
Use UDP instead of TCP with sockets. |
−−sock=domain:port
Connection, dump input data to remote port, and print response.
−−sock−test
With −−sock , test whether port is available or not, and print result.
−−bind=port
Bind to a port, dump input data to connecting client, and print all incoming data from client. −−hang−up will cause dog to exit after dumping input data to connecting client, not waiting for multiple clients or printing data from clients. −−no−header will cause dog to not display info on each connection.
−−hang−up
Do not wait for socket input during −−bind
−−no−header
Do not display header on HTTP data. In conjuction with −−bind , do not display info on each connection.
−−images
Treats input as HTML and lists unique, absolute image links from input data.
−−links
Treats input as HTML and lists unique, absolute URL links from input data.
−−skip−tags
Skips tags for formatting options. Tags are still included in output, but only non-tag data will be affected by the various formatting options.
−−upper
Convert all lower-case characters to upper-case.
−−lower
Convert all upper-case characters to lower-case.
−−translate
Convert DOS, MAC, and UNIX line endings to style specified by −−dos , −−mac , or −−unix is running under.
−−dos, −−mac −−unix
Respectively convert line endings to DOS-style, MAC-style, and UNIX-style. Use in conjuction with −−translate to convert from DOS, MAC, or UNIX line ending styles between eachother.
−l lines
Specify list of lines to print, with ranges, comma delimited. All of the ranges are inclusive. For example, to display lines 5, 7 through 10, 25, 32 through 50, and 72 through 300, you would use the argument "-l 5,7-10,25,32-50,72-300". If you wanted to print all lines up to 10 (inclusive), you would use the argument "-l -10". Finally, if you would like to print all lines after line 50, you would use the argument "-l 50-".
−−strfry
Stir-fry each line.
−−krad |
Convert lines to "k−rad" format. |
−−rot=num
Rotate character values (can be negative).
−−help |
Print a usage message and exit. | ||
−−hex |
Dump the input data as a hex dump. Other formatting flags will not apply. | ||
−−oog |
TRANSLATE INPUT LIKE OOG!!! OOG OPEN SOURCE OPTION!!! OOG BREAK DOG HEAD!!! |
−−version
Print version information on standard output, then exit.
BUGS
Please report
any bugs you may find to:
dog-bugs [AT] photodex.com
AUTHORS
Jason Cohen <dogboy [AT] photodex.com>
Manual page, web page, and source package:
Jacob Leverich <leverich [AT] photodex.com>