pkg://torrentutils-0.3.0nb2.tgz:10667/man/man1/defrag.1  downloads

.\"                                      Hey, EMACS: -*- nroff -*-
.TH torrenttool 1 "August 18, 2003"
.\" Please adjust this date whenever revising the manpage.
.SH NAME
defrag \- Defrag files
.SH SYNOPSIS
.B defrag
.RI [ OPTION ]... " " "" FILE ...
.SH DESCRIPTION
\fBdefrag\fP defrags files simply by making a copy of the file, and
then replacing the original file with the copy.

Due to the fact that BitTorrent splits files in pieces,
and downloads these pieces in random order, the downloaded files
are often severely fragmented. This means that reading these files
will be slower, sometimes as much as 30% slower. defrag can
also recurse directories when the `-r' option is given.

Note that newer versions of the official BitTorrent client
does not allocate file contents in advance. It will instead
write pieces in the order they were downloaded, and reorder
them later. This makes defrag unnecessary for files downloaded
with this client. (However, defrag might still be useful as a
file defragmentation tool.)
.SH OPTIONS
These programs follow the usual GNU command line syntax, with long
options starting with two dashes (`-').
A summary of options is included below.
.TP
.B \-v, \-\-verbose
Explain more in detail what is being done. This option makes defrag
print the name of each file prior to defragging it.
.TP
.B \-r, \-\-recrusive
Travel directories, defragging each file in the directory, its
subdirectories and so on.
.TP
.B \-\-help
Show summary of options.
.TP
.B \-\-version
Output version information and exit.
.SH EXAMPLES
Defrag all files in the directory `downloads' recursively, and
print the name of each file defragged:
.br
	\fBdefrag -r -v downloads\fP
.SH KNOWN BUGS
There are no known bugs at the moment.
.PP
If you find a bug not listed here, please report it to <oskar@osk.mine.nu>.
.SH AUTHOR
torrenttool was written by Oskar Liljeblad <oskar@osk.mine.nu>.