DOG
Section: User Manuals (1)
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 at least 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 conjunction 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 conjunction with --translate to convert from DOS, MAC, or UNIX line ending styles between each other.
-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@photodex.com
AUTHORS
Jason Cohen <dogboy@photodex.com>
Manual page, web page, and source package:
Jacob Leverich <leverich@photodex.com>
SEE ALSO
cat(1)
Bottom left of the banner