2 * connect / disconnect two subscriber ports
5 * Copyright (C) 1999 Takashi Iwai
7 * This program is free software; you can redistribute it and/or modify
8 * it under the terms of the GNU General Public License version 2 as
9 * published by the Free Software Foundation.
11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU General Public License for more details.
28 #include <sys/ioctl.h>
29 #include <alsa/asoundlib.h>
34 static void error_handler(const char *file, int line, const char *function, int err, const char *fmt, ...)
38 if (err == ENOENT) /* Ignore those misleading "warnings" */
41 fprintf(stderr, "ALSA lib %s:%i:(%s) ", file, line, function);
42 vfprintf(stderr, fmt, arg);
44 fprintf(stderr, ": %s", snd_strerror(err));
49 static void usage(void)
51 printf(_("aconnect - ALSA sequencer connection manager\n"));
52 printf(_("Copyright (C) 1999-2000 Takashi Iwai\n"));
53 printf(_("Usage:\n"));
54 printf(_(" * Connection/disconnection between two ports\n"));
55 printf(_(" aconnect [-options] sender receiver\n"));
56 printf(_(" sender, receiver = client:port pair\n"));
57 printf(_(" -d,--disconnect disconnect\n"));
58 printf(_(" -e,--exclusive exclusive connection\n"));
59 printf(_(" -r,--real # convert real-time-stamp on queue\n"));
60 printf(_(" -t,--tick # convert tick-time-stamp on queue\n"));
61 printf(_(" * List connected ports (no subscription action)\n"));
62 printf(_(" aconnect -i|-o [-options]\n"));
63 printf(_(" -i,--input list input (readable) ports\n"));
64 printf(_(" -o,--output list output (writable) ports\n"));
65 printf(_(" -a,--all show inactive ports, too\n"));
66 printf(_(" -l,--list list current connections of each port\n"));
67 printf(_(" * Remove all exported connections\n"));
68 printf(_(" -x, --removeall\n"));
72 * check permission (capability) of specified port
78 #define perm_ok(cap,bits) (((cap) & (bits)) == (bits))
80 static int check_direction(snd_seq_port_info_t *pinfo, int bit)
82 int dir = snd_seq_port_info_get_direction(pinfo);
83 return !dir || (dir & bit);
86 static int check_permission(snd_seq_port_info_t *pinfo, int perm)
88 int cap = snd_seq_port_info_get_capability(pinfo);
90 if (cap & SND_SEQ_PORT_CAP_NO_EXPORT)
95 if (perm & LIST_INPUT) {
96 if (perm_ok(cap, SND_SEQ_PORT_CAP_READ|SND_SEQ_PORT_CAP_SUBS_READ) &&
97 check_direction(pinfo, SND_SEQ_PORT_DIR_INPUT))
100 if (perm & LIST_OUTPUT) {
101 if (perm_ok(cap, SND_SEQ_PORT_CAP_WRITE|SND_SEQ_PORT_CAP_SUBS_WRITE) &&
102 check_direction(pinfo, SND_SEQ_PORT_DIR_OUTPUT))
109 * list subscribers of specified type
111 static void list_each_subs(snd_seq_t *seq, snd_seq_query_subscribe_t *subs, int type, const char *msg)
114 snd_seq_query_subscribe_set_type(subs, type);
115 snd_seq_query_subscribe_set_index(subs, 0);
116 while (snd_seq_query_port_subscribers(seq, subs) >= 0) {
117 const snd_seq_addr_t *addr;
119 printf("\t%s: ", msg);
122 addr = snd_seq_query_subscribe_get_addr(subs);
123 printf("%d:%d", addr->client, addr->port);
124 if (snd_seq_query_subscribe_get_exclusive(subs))
126 if (snd_seq_query_subscribe_get_time_update(subs))
128 (snd_seq_query_subscribe_get_time_real(subs) ? "real" : "tick"),
129 snd_seq_query_subscribe_get_queue(subs));
130 snd_seq_query_subscribe_set_index(subs, snd_seq_query_subscribe_get_index(subs) + 1);
139 static void list_subscribers(snd_seq_t *seq, const snd_seq_addr_t *addr)
141 snd_seq_query_subscribe_t *subs;
142 snd_seq_query_subscribe_alloca(&subs);
143 snd_seq_query_subscribe_set_root(subs, addr);
144 list_each_subs(seq, subs, SND_SEQ_QUERY_SUBS_READ, _("Connecting To"));
145 list_each_subs(seq, subs, SND_SEQ_QUERY_SUBS_WRITE, _("Connected From"));
151 typedef void (*action_func_t)(snd_seq_t *seq, snd_seq_client_info_t *cinfo, snd_seq_port_info_t *pinfo, int count);
153 static void do_search_port(snd_seq_t *seq, int perm, action_func_t do_action)
155 snd_seq_client_info_t *cinfo;
156 snd_seq_port_info_t *pinfo;
159 snd_seq_client_info_alloca(&cinfo);
160 snd_seq_port_info_alloca(&pinfo);
161 snd_seq_client_info_set_client(cinfo, -1);
162 while (snd_seq_query_next_client(seq, cinfo) >= 0) {
163 /* reset query info */
164 snd_seq_port_info_set_client(pinfo, snd_seq_client_info_get_client(cinfo));
165 snd_seq_port_info_set_port(pinfo, -1);
167 snd_seq_port_info_set_capability(pinfo, SND_SEQ_PORT_CAP_INACTIVE);
169 while (snd_seq_query_next_port(seq, pinfo) >= 0) {
170 if (check_permission(pinfo, perm)) {
171 do_action(seq, cinfo, pinfo, count);
175 snd_seq_port_info_set_capability(pinfo, SND_SEQ_PORT_CAP_INACTIVE);
181 static void print_port(snd_seq_t *seq ATTRIBUTE_UNUSED,
182 snd_seq_client_info_t *cinfo,
183 snd_seq_port_info_t *pinfo, int count)
186 int card = -1, pid = -1;
188 printf(_("client %d: '%s' [type=%s"),
189 snd_seq_client_info_get_client(cinfo),
190 snd_seq_client_info_get_name(cinfo),
191 (snd_seq_client_info_get_type(cinfo) == SND_SEQ_USER_CLIENT ?
192 _("user") : _("kernel")));
193 switch (snd_seq_client_info_get_midi_version(cinfo)) {
194 case SND_SEQ_CLIENT_UMP_MIDI_1_0:
195 printf(",UMP-MIDI1");
197 case SND_SEQ_CLIENT_UMP_MIDI_2_0:
198 printf(",UMP-MIDI2");
201 card = snd_seq_client_info_get_card(cinfo);
203 printf(",card=%d", card);
205 pid = snd_seq_client_info_get_pid(cinfo);
207 printf(",pid=%d", pid);
210 printf(" %3d '%-16s'",
211 snd_seq_port_info_get_port(pinfo),
212 snd_seq_port_info_get_name(pinfo));
213 if (snd_seq_port_info_get_capability(pinfo) & SND_SEQ_PORT_CAP_INACTIVE)
214 printf(" [INACTIVE]");
218 static void print_port_and_subs(snd_seq_t *seq, snd_seq_client_info_t *cinfo,
219 snd_seq_port_info_t *pinfo, int count)
221 print_port(seq, cinfo, pinfo, count);
222 list_subscribers(seq, snd_seq_port_info_get_addr(pinfo));
227 * remove all (exported) connections
229 static void remove_connection(snd_seq_t *seq,
230 snd_seq_client_info_t *info ATTRIBUTE_UNUSED,
231 snd_seq_port_info_t *pinfo,
232 int count ATTRIBUTE_UNUSED)
234 snd_seq_query_subscribe_t *query;
235 snd_seq_port_info_t *port;
236 snd_seq_port_subscribe_t *subs;
238 snd_seq_query_subscribe_alloca(&query);
239 snd_seq_query_subscribe_set_root(query, snd_seq_port_info_get_addr(pinfo));
240 snd_seq_query_subscribe_set_type(query, SND_SEQ_QUERY_SUBS_READ);
241 snd_seq_query_subscribe_set_index(query, 0);
243 snd_seq_port_info_alloca(&port);
244 snd_seq_port_subscribe_alloca(&subs);
246 while (snd_seq_query_port_subscribers(seq, query) >= 0) {
247 const snd_seq_addr_t *sender = snd_seq_query_subscribe_get_root(query);
248 const snd_seq_addr_t *dest = snd_seq_query_subscribe_get_addr(query);
250 if (snd_seq_get_any_port_info(seq, dest->client, dest->port, port) < 0 ||
251 !(snd_seq_port_info_get_capability(port) & SND_SEQ_PORT_CAP_SUBS_WRITE) ||
252 (snd_seq_port_info_get_capability(port) & SND_SEQ_PORT_CAP_NO_EXPORT)) {
253 snd_seq_query_subscribe_set_index(query, snd_seq_query_subscribe_get_index(query) + 1);
256 snd_seq_port_subscribe_set_queue(subs, snd_seq_query_subscribe_get_queue(query));
257 snd_seq_port_subscribe_set_sender(subs, sender);
258 snd_seq_port_subscribe_set_dest(subs, dest);
259 if (snd_seq_unsubscribe_port(seq, subs) < 0) {
260 snd_seq_query_subscribe_set_index(query, snd_seq_query_subscribe_get_index(query) + 1);
265 static void remove_all_connections(snd_seq_t *seq)
267 do_search_port(seq, 0, remove_connection);
276 SUBSCRIBE, UNSUBSCRIBE, LIST, REMOVE_ALL
279 #define ACONNECT_OPTS "dior:t:elxa"
281 static const struct option long_option[] = {
282 {"disconnect", 0, NULL, 'd'},
283 {"input", 0, NULL, 'i'},
284 {"output", 0, NULL, 'o'},
285 {"real", 1, NULL, 'r'},
286 {"tick", 1, NULL, 't'},
287 {"exclusive", 0, NULL, 'e'},
288 {"list", 0, NULL, 'l'},
289 {"removeall", 0, NULL, 'x'},
290 {"all", 0, NULL, 'a'},
294 int main(int argc, char **argv)
298 int queue = 0, convert_time = 0, convert_real = 0, exclusive = 0;
299 int command = SUBSCRIBE;
303 snd_seq_port_subscribe_t *subs;
304 snd_seq_addr_t sender, dest;
307 setlocale(LC_ALL, "");
311 while ((c = getopt_long(argc, argv, ACONNECT_OPTS, long_option, NULL)) != -1) {
314 command = UNSUBSCRIBE;
318 list_perm |= LIST_INPUT;
322 list_perm |= LIST_OUTPUT;
328 queue = atoi(optarg);
333 queue = atoi(optarg);
342 command = REMOVE_ALL;
354 if (snd_seq_open(&seq, "default", SND_SEQ_OPEN_DUPLEX, 0) < 0) {
355 fprintf(stderr, _("can't open sequencer\n"));
359 snd_lib_error_set_handler(error_handler);
363 do_search_port(seq, list_perm,
364 list_subs ? print_port_and_subs : print_port);
368 remove_all_connections(seq);
373 /* connection or disconnection */
375 if (optind + 2 > argc) {
381 if ((client = snd_seq_client_id(seq)) < 0) {
383 fprintf(stderr, _("can't get client id\n"));
387 /* set client info */
388 if (snd_seq_set_client_name(seq, "ALSA Connector") < 0) {
390 fprintf(stderr, _("can't set client info\n"));
394 /* set subscription */
395 if (snd_seq_parse_address(seq, &sender, argv[optind]) < 0) {
397 fprintf(stderr, _("invalid sender address %s\n"), argv[optind]);
400 if (snd_seq_parse_address(seq, &dest, argv[optind + 1]) < 0) {
402 fprintf(stderr, _("invalid destination address %s\n"), argv[optind + 1]);
405 snd_seq_port_subscribe_alloca(&subs);
406 snd_seq_port_subscribe_set_sender(subs, &sender);
407 snd_seq_port_subscribe_set_dest(subs, &dest);
408 snd_seq_port_subscribe_set_queue(subs, queue);
409 snd_seq_port_subscribe_set_exclusive(subs, exclusive);
410 snd_seq_port_subscribe_set_time_update(subs, convert_time);
411 snd_seq_port_subscribe_set_time_real(subs, convert_real);
413 if (command == UNSUBSCRIBE) {
414 if (snd_seq_get_port_subscription(seq, subs) < 0) {
416 fprintf(stderr, _("No subscription is found\n"));
419 if (snd_seq_unsubscribe_port(seq, subs) < 0) {
421 fprintf(stderr, _("Disconnection failed (%s)\n"), snd_strerror(errno));
425 if (snd_seq_get_port_subscription(seq, subs) == 0) {
427 fprintf(stderr, _("Connection is already subscribed\n"));
430 if (snd_seq_subscribe_port(seq, subs) < 0) {
432 fprintf(stderr, _("Connection failed (%s)\n"), snd_strerror(errno));