aboutsummaryrefslogtreecommitdiff
path: root/misc/cstream
diff options
context:
space:
mode:
authorJimmy Olgeni <olgeni@FreeBSD.org>2012-11-25 21:31:37 +0000
committerJimmy Olgeni <olgeni@FreeBSD.org>2012-11-25 21:31:37 +0000
commita6bded1e4d5affde1ae0458bf50df8a1ec594d27 (patch)
treebc8ac3e198ec8cfc939c0c4d39c9769cbc2e5c03 /misc/cstream
parent41f7fb55ff0ccb9a3aeccc030535e785185d95ac (diff)
downloadports-a6bded1e4d5affde1ae0458bf50df8a1ec594d27.tar.gz
ports-a6bded1e4d5affde1ae0458bf50df8a1ec594d27.zip
Notes
Diffstat (limited to 'misc/cstream')
-rw-r--r--misc/cstream/Makefile3
-rw-r--r--misc/cstream/files/patch-cstream.1126
2 files changed, 128 insertions, 1 deletions
diff --git a/misc/cstream/Makefile b/misc/cstream/Makefile
index e030ba190271..3a50e58f6f29 100644
--- a/misc/cstream/Makefile
+++ b/misc/cstream/Makefile
@@ -3,10 +3,11 @@
PORTNAME= cstream
PORTVERSION= 3.0.0
+PORTREVISION= 1
CATEGORIES= misc
MASTER_SITES= http://www.cons.org/cracauer/download/
-MAINTAINER= ports@FreeBSD.org
+MAINTAINER= olgeni@FreeBSD.org
COMMENT= Like dd(1) tool, precise bandwidth limiting/reporting, fifo, TCP
LICENSE= MIT
diff --git a/misc/cstream/files/patch-cstream.1 b/misc/cstream/files/patch-cstream.1
new file mode 100644
index 000000000000..5c291e5fa280
--- /dev/null
+++ b/misc/cstream/files/patch-cstream.1
@@ -0,0 +1,126 @@
+
+$FreeBSD$
+
+--- cstream.1.orig
++++ cstream.1
+@@ -46,9 +46,9 @@
+ .Ar num
+ bytes before writing. The default is the blocksize. It is an error to
+ set this to anything below the blocksize. Useful when writing tapes
+-and simlilar that prefer few large writes of many small.
++and similar that prefer few large writes of many small.
+ .It Fl c Ar num
+-Concurrent operation. Use a seperate process for outout. This is
++Concurrent operation. Use a separate process for output. This is
+ especially useful in combination with the -B option.
+ .Bl -tag -compact -width " "
+ .It 0 = use one process only (default)
+@@ -56,13 +56,13 @@
+ .It 2 = write process will buffer
+ .It 3 = both processes will buffer.
+ In combination with a large buffer size this will often load your memory
+-heavily, everytime the reader transfers the buffer it collected to the
++heavily, every time the reader transfers the buffer it collected to the
+ writer. If you use -c 3 and have a buffer size of 128 Megabytes 256 MB of
+ memory will be touched at once.
+ .El
+ .It Fl i Ar num
+ .It Fl o Ar num
+-Set the file names to use for input or output, respectivly. If the
++Set the file names to use for input or output, respectively. If the
+ output file name is "-", data will just be discarded. If the input
+ file name is "-", data will be generated 'out of the void'. If these
+ options aren't given, stdin/stout will be used. If you need to give
+@@ -81,7 +81,7 @@
+ has other network filters, anyone will be able to connect.
+ .It Fl I Ar string
+ .It Fl O Ar string
+-Specify the type of input and output file, respectivly.
++Specify the type of input and output file, respectively.
+ .Bl -tag -compact -width " "
+ .It If string
+ includes 'f', a fifo will be created.
+@@ -109,7 +109,7 @@
+ .It Fl p Ar filename
+ Write the process id of cstream to
+ .Ar filename .
+-If cstream uses a seperate writer process (option -c), this is the pid
++If cstream uses a separate writer process (option -c), this is the pid
+ of the parent (reader) process.
+ .It Fl t Ar num
+ Limit the throughput of the data stream to
+@@ -132,7 +132,7 @@
+ and throughput will be displayed at the end of program run. A value of
+ 2 means the transfer rate since the end of the first read/write pair
+ will also be reported (useful when there is an initial delay). A value
+-of 3 means there will also be seperate measurements for read and
++of 3 means there will also be separate measurements for read and
+ write. This option is resource-consuming and currently isn't
+ implemented. A value of 4 means that notices about each single
+ read/write will be displayed. High values include all message types of
+@@ -144,13 +144,13 @@
+ be used as input file if -i has not been used.
+ .It Ic SIGUSR1
+ .It Ic SIGINFO
+-Sending SIGUSR1 (or SIGINFO, which is usually mappend to Control-T on
++Sending SIGUSR1 (or SIGINFO, which is usually mapped to Control-T on
+ you keyboard) to cstream causes it to display throughput rates to
+-stderr. The stream will continue as if nothing happend.
++stderr. The stream will continue as if nothing happened.
+ .It Ic SIGUSR2
+ Exit and report throughput rates, if requested.
+ .It Ic SIGHUP
+-I found myself sending SIGHUP accidentially too often. But ignoring or
++I found myself sending SIGHUP accidentally too often. But ignoring or
+ misusing SIGHUP is not an option for me. Thus, when
+ .Nm cstream
+ received
+@@ -191,19 +191,18 @@
+ .It Ic "cstream -Oa -o /dev/dsp0 myhost.mydomain.com:17324"
+ Connects port 3333 on host myhost.mydomain.com and whatever data it
+ finds there will be sent to the soundcard, with appropriate settings
+-for CD quality stero play.
++for CD quality stereo play.
+ .It Ic "cstream -i myaudiofile.raw -o :17324"
+ This will open a TCP server on port 17324 and waits until someone
+ connects (for example, the commandline from the previous
+ example). Then it will send the contents of myaudiofile.raw down the
+-TCP stream (for the previous audio example, typically a CD audiotrack
++TCP stream (for the previous audio example, typically a CD audio track
+ like you get from the tosha or cdparanoia utilities).
+ .It Ic "cstream -OD -o myfile"
+-
+ Write to file myfile with O_DIRECT. That usually means that the
+ filesystem buffer cache will not try to cache this file. You can use
+ that to prevent copying operations from eating up physical memory.
+-Note that when cstream encouters a write error it will switch the
++Note that when cstream encounters a write error it will switch the
+ output file from O_DIRECT to a normal file and write all further
+ blocks without O_DIRECT if writes without O_DIRECT succeed. In
+ practice that usually means that your last block, if not a multiple of
+@@ -222,7 +221,7 @@
+ you want to ensure that O_DIRECT stays in effect, you need a buffer
+ between the TCP stream and the O_DIRECT stream. Since cstream does
+ not yet support different input and output block sizes, dd is
+-suitable here. Note that this is only neccessary if the OS requires
++suitable here. Note that this is only necessary if the OS requires
+ multiples of the filesystem block size for O_DIRECT. At the time of
+ this writing this construct is needed on Linux for using TCP
+ streams with O_DIRECT, but it is not needed on FreeBSD.
+@@ -234,6 +233,7 @@
+ both Linux and FreeBSD is very slow (1/5th to 1/10th of normal write)
+ and O_DIRECT is reasonably fast (1/4th to 1/2 of normal write). You
+ can combined O_SYNC and O_DIRECT.
++.El
+ .Sh ERRORS
+ .Bl -tag -width "-l num "
+ .It Exit code 0 means success.
+@@ -252,7 +252,7 @@
+ blocksize to whatever the filesystem of the output file is in) and page
+ alignment requirements (I/O will happen from a page-aligned buffer).
+ However, the combination of concurrent read/writes (-c options) and
+-O_DIRECT has not been tested bejond basic verification that it gets
++O_DIRECT has not been tested beyond basic verification that it gets
+ some tests right.
+ .Sh SEE ALSO
+ .Xr dd 1 ,