Manpages

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>

SEE ALSO

cat(1)