root/jack2/branches/pipelining/example-clients/lsp.c

/*
 This program is free software; you can redistribute it and/or modify
 it under the terms of the GNU General Public License as published by
 the Free Software Foundation; either version 2 of the License, or
 (at your option) any later version.

 This program 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 General Public License
 along with this program; if not, write to the Free Software
 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
*/

#include <stdio.h>
#include <stdlib.h>
#ifndef WIN32
#include <unistd.h>
#endif
#include <string.h>
#include <getopt.h>
#include <jack/jack.h>

char * my_name;

static void
show_version (void)
{
        //fprintf (stderr, "%s: JACK Audio Connection Kit version " VERSION "\n", my_name);
}

static void
show_usage (void)
{
        show_version ();
        fprintf (stderr, "\nUsage: %s [options] [filter string]\n", my_name);
        fprintf (stderr, "List active Jack ports, and optionally display extra information.\n");
        fprintf (stderr, "Optionally filter ports which match ALL strings provided after any options.\n\n");
        fprintf (stderr, "Display options:\n");
        fprintf (stderr, "        -A, --aliases         List aliases for each port\n");
        fprintf (stderr, "        -c, --connections     List connections to/from each port\n");
        fprintf (stderr, "        -l, --latency         Display per-port latency in frames at each port\n");
        fprintf (stderr, "        -L, --latency         Display total latency in frames at each port\n");
        fprintf (stderr, "        -p, --properties      Display port properties. Output may include:\n"
                         "                              input|output, can-monitor, physical, terminal\n\n");
        fprintf (stderr, "        -t, --type            Display port type\n");
        fprintf (stderr, "        -h, --help            Display this help message\n");
        fprintf (stderr, "        --version             Output version information and exit\n\n");
        fprintf (stderr, "For more information see http://jackaudio.org/\n");
}

int
main (int argc, char *argv[])
{
        jack_client_t *client;
        jack_status_t status;
        const char **ports, **connections;
        unsigned int i, j, k;
        int skip_port;
        int show_aliases = 0;
        int show_con = 0;
        int show_port_latency = 0;
        int show_total_latency = 0;
        int show_properties = 0;
        int show_type = 0;
        int c;
        int option_index;
        char* aliases[2];
        jack_port_t *port;
        
        struct option long_options[] = {
                { "aliases", 0, 0, 'A' },
                { "connections", 0, 0, 'c' },
                { "port-latency", 0, 0, 'l' },
                { "total-latency", 0, 0, 'L' },
                { "properties", 0, 0, 'p' },
                { "type", 0, 0, 't' },
                { "help", 0, 0, 'h' },
                { "version", 0, 0, 'v' },
                { 0, 0, 0, 0 }
        };

        my_name = strrchr(argv[0], '/');
        if (my_name == 0) {
                my_name = argv[0];
        } else {
                my_name ++;
        }

        while ((c = getopt_long (argc, argv, "AclLphvt", long_options, &option_index)) >= 0) {
                switch (c) {
                case 'A':
                        aliases[0] = (char *) malloc (jack_port_name_size());
                        aliases[1] = (char *) malloc (jack_port_name_size());
                        show_aliases = 1;
                        break;
                case 'c':
                        show_con = 1;
                        break;
                case 'l':
                        show_port_latency = 1;
                        break;
                case 'L':
                        show_total_latency = 1;
                        break;
                case 'p':
                        show_properties = 1;
                        break;
                case 't':
                        show_type = 1;
                        break;
                case 'h':
                        show_usage ();
                        return 1;
                        break;
                case 'v':
                        show_version ();
                        return 1;
                        break;
                default:
                        show_usage ();
                        return 1;
                        break;
                }
        }

        /* Open a client connection to the JACK server.  Starting a
         * new server only to list its ports seems pointless, so we
         * specify JackNoStartServer. */
        //JOQ: need a new server name option

        client = jack_client_open ("lsp", JackNoStartServer, &status);
        if (client == NULL) {
                if (status & JackServerFailed) {
                        fprintf (stderr, "JACK server not running\n");
                } else {
                        fprintf (stderr, "jack_client_open() failed, "
                                 "status = 0x%2.0x\n", status);
                }
                return 1;
        }

        ports = jack_get_ports (client, NULL, NULL, 0);
    if (!ports) 
        goto error;

        for (i = 0; ports[i]; ++i) {
                // skip over any that don't match ALL of the strings presented at command line
                skip_port = 0;
                for(k = optind; k < argc; k++){
                        if(strstr(ports[i], argv[k]) == NULL ){
                                skip_port = 1;
                        }
                }
                if (skip_port) continue;

                printf ("%s\n", ports[i]);
                port = jack_port_by_name (client, ports[i]);

                if (show_aliases) {
                        int cnt;
                        int i;

                        cnt = jack_port_get_aliases (port, aliases);
                        for (i = 0; i < cnt; ++i) {
                                printf ("   %s\n", aliases[i]);
                        }
                }
                                
                if (show_con) {
                        if ((connections = jack_port_get_all_connections (client, jack_port_by_name(client, ports[i]))) != 0) {
                                for (j = 0; connections[j]; j++) {
                                        printf ("   %s\n", connections[j]);
                                }
                                free (connections);
                        } 
                }
                if (show_port_latency) {
                        if (port) {
                                printf ("       port latency = %d frames\n",
                                        jack_port_get_latency (port));
                        }
                }
                if (show_total_latency) {
                        if (port) {
                                printf ("       total latency = %d frames\n",
                                        jack_port_get_total_latency (client, port));
                        }
                }
                if (show_properties) {
                        if (port) {
                                int flags = jack_port_flags (port);
                                printf ("       properties: ");
                                if (flags & JackPortIsInput) {
                                        fputs ("input,", stdout);
                                }
                                if (flags & JackPortIsOutput) {
                                        fputs ("output,", stdout);
                                }
                                if (flags & JackPortCanMonitor) {
                                        fputs ("can-monitor,", stdout);
                                }
                                if (flags & JackPortIsPhysical) {
                                        fputs ("physical,", stdout);
                                }
                                if (flags & JackPortIsTerminal) {
                                        fputs ("terminal,", stdout);
                                }
                
                if (flags & JackPortIsActive) {
                    fputs ("active,", stdout);
                } else {
                    fputs ("non-active,", stdout);
                }
                                putc ('\n', stdout);
                        }
                }
                if (show_type) {
                        if (port) {
                                putc ('\t', stdout);
                                fputs (jack_port_type (port), stdout);
                                putc ('\n', stdout);
                        }
                }
        }
    
error:
        jack_client_close (client);
        exit (0);
}