* fix include file names in installed header files

* add browsing API
* add new tool pabrowse
* add typeid subsystem 
* bump API version
* split off random.c
* add an identification cookie


git-svn-id: file:///home/lennart/svn/public/pulseaudio/trunk@320 fefdeb5f-60dc-0310-8127-8f9354f1896f

polyp/polyplib-browser.h

@@ -0,0 +1,65 @@
+#ifndef foopolyplibbrowserhfoo
+#define foopolyplibbrowserhfoo
+
+/* $Id$ */
+
+/***
+  This file is part of polypaudio.
+ 
+  polypaudio is free software; you can redistribute it and/or modify
+  it under the terms of the GNU Lesser General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  polypaudio is distributed in the hope that it will be useful, but
+  WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+  General Public License for more details.
+ 
+  You should have received a copy of the GNU Lesser General Public
+  License along with polypaudio; if not, write to the Free Software
+  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
+  USA.
+***/
+
+#include <polyp/mainloop-api.h>
+#include <polyp/sample.h>
+#include <polyp/cdecl.h>
+#include <polyp/typeid.h>
+
+PA_C_DECL_BEGIN
+
+struct pa_browser;
+
+enum pa_browse_opcode {
+    PA_BROWSE_NEW_SERVER,
+    PA_BROWSE_NEW_SINK,
+    PA_BROWSE_NEW_SOURCE,
+    PA_BROWSE_REMOVE
+};
+
+struct pa_browser *pa_browser_new(struct pa_mainloop_api *mainloop);
+struct pa_browser *pa_browser_ref(struct pa_browser *z);
+void pa_browser_unref(struct pa_browser *z);
+
+struct pa_browse_info {
+    /* Unique service name */
+    const char *name;  /* always available */
+
+    /* Server info */
+    const char *server; /* always available */
+    const char *server_version, *user_name, *fqdn; /* optional */
+    const uint32_t *cookie;  /* optional */
+
+    /* Device info */
+    const char *device; /* always available when this information is of a sink/source */
+    const char *description;  /* optional */
+    const pa_typeid_t *typeid;  /* optional */
+    const struct pa_sample_spec *sample_spec;  /* optional */
+};
+
+void pa_browser_set_callback(struct pa_browser *z, void (*cb)(struct pa_browser *z, enum pa_browse_opcode c, const struct pa_browse_info *i, void *userdata), void *userdata);
+
+PA_C_DECL_END
+
+#endif