Merged revisions 81012 via svnmerge from
[asterisk/asterisk.git] / utils / streamplayer.c
old mode 100755 (executable)
new mode 100644 (file)
index 90447a6..fb0d055
@@ -1,17 +1,46 @@
 /*
-* streamplayer.c
-*
-* A utility for reading from a stream
-* 
-* Copyright (C) 2005, Digium, Inc.
-*
-* Russell Bryant <russell@digium.com>
-*
-* This program is free software, distributed under the terms of
-* the GNU General Public License
-*
-* $Revision$ 
-*/
+ * Asterisk -- An open source telephony toolkit.
+ *
+ * Copyright (C) 1999 - 2005, Digium, Inc.
+ *
+ * Russell Bryant <russell@digium.com>
+ *
+ * See http://www.asterisk.org for more information about
+ * the Asterisk project. Please do not directly contact
+ * any of the maintainers of this project for assistance;
+ * the project provides a web site, mailing lists and IRC
+ * channels for your use.
+ *
+ * This program is free software, distributed under the terms of
+ * the GNU General Public License Version 2. See the LICENSE file
+ * at the top of the source tree.
+ */
+
+/*!
+ * \file
+ * \author Russell Bryant <russell@digium.com>
+ * 
+ * \brief A utility for reading from a raw TCP stream
+ *
+ * This application is intended for use when a raw TCP stream is desired to be
+ * used as a music on hold source for Asterisk.  Some devices are capable of
+ * taking some kind of audio input and provide it as a raw TCP stream over the
+ * network, which is what inspired someone to fund this to be written.
+ * However, it would certainly be possible to write your own server application
+ * to provide music over a TCP stream from a centralized location.
+ *
+ * This application is quite simple.  It just reads the data from the TCP
+ * stream and dumps it straight to stdout.  Due to the way Asterisk handles
+ * music on hold sources, this application checks to make sure writing
+ * to stdout will not be a blocking operation before doing so.  If so, the data
+ * is just thrown away.  This ensures that the stream will continue to be
+ * serviced, even if Asterisk is not currently using the source.
+ *
+ * \todo Update this application to be able to connect to a stream via HTTP,
+ * since that is the #1 most requested feature, and it would be quite useful.
+ * A lot of people think that is what this is for and email me when it does
+ * not work.  :)
+ */
 
 #include <stdlib.h>
 #include <stdio.h>
@@ -20,7 +49,7 @@
 #include <unistd.h>
 #include <sys/types.h>
 #include <sys/socket.h>
-#if defined(__FreeBSD__)
+#if defined(__FreeBSD__) || defined(__OpenBSD__) || defined(__NetBSD__) || defined(__Darwin__) || defined(__CYGWIN__)
 #include <netinet/in.h>
 #endif
 #include <sys/time.h>
@@ -37,6 +66,9 @@ int main(int argc, char *argv[])
        struct timeval tv;
 
        if (argc != 3) {
+               fprintf(stderr, "streamplayer -- A utility for reading from a raw TCP stream.\n");
+               fprintf(stderr, "Written for use with Asterisk (http://www.asterisk.org)\n");
+               fprintf(stderr, "Copyright (C) 2005 -- Russell Bryant -- Digium, Inc.\n\n");
                fprintf(stderr, "Usage: ./streamplayer <ip> <port>\n");
                exit(1);
        }