recv_common.c

   1 /*
   2  * Copyright (C) 2006-2009 Andre Noll <maan@systemlinux.org>
   3  *
   4  * Licensed under the GPL v2. For licencing details see COPYING.
   5  */
   6
   7 /** \file recv_common.c common functions of para_recv and para_audiod */
   8
   9 #include "para.h"
  10
  11 #include "list.h"
  12 #include "sched.h"
  13 #include "ggo.h"
  14 #include "recv.h"
  15 #include "string.h"
  16
  17 DEFINE_RECEIVER_ARRAY;
  18
  19 /**
  20  * Call the init function of each paraslash receiver.
  21  */
  22 void recv_init(void)
  23 {
  24         int i;
  25
  26         FOR_EACH_RECEIVER(i)
  27                 receivers[i].init(&receivers[i]);
  28 }
  29
  30 static void *parse_receiver_args(int receiver_num, char *options)
  31 {
  32         struct receiver *r = &receivers[receiver_num];
  33         char **argv;
  34         int argc, i;
  35         void *conf;
  36
  37
  38         PARA_DEBUG_LOG("%s, options: %s\n", r->name,
  39                 options? options : "(none)");
  40         if (options) {
  41                 PARA_DEBUG_LOG("options: %s\n", options);
  42                 argc = create_argv(options, " \t", &argv);
  43                 if (argc < 0)
  44                         return NULL;
  45                 for (i = argc - 1; i >= 0; i--)
  46                         argv[i + 1] = argv[i];
  47                 argv[0] = NULL;
  48                 argc++;
  49         } else {
  50                 argc = 1;
  51                 argv = para_malloc(2 * sizeof(char*));
  52                 argv[0] = NULL;
  53                 argv[1] = NULL;
  54         }
  55         conf = r->parse_config(argc, argv);
  56         for (i = 1; i < argc; i++)
  57                 free(argv[i]);
  58         free(argv);
  59         return conf;
  60 }
  61
  62 /**
  63  * check if given string is a valid command line for any receiver
  64  *
  65  * \param \ra string of the form receiver_name:options
  66  * \param receiver_num contains the number of the receiver upon success
  67  *
  68  * This function checks whether \a ra starts with the name of a supported
  69  * paraslash receiver, optinally followed by a colon and any options for that
  70  * receiver. If a valid receiver name was found and further are present, the
  71  * remaining part of \a ra is passed to that receiver's config parser.
  72  *
  73  * \return On success, a pointer to the gengetopt args info struct is returned
  74  * and \a receiver_num contains the number of the receiver. Otherwise this function
  75  * returns \p NULL.
  76  */
  77 void *check_receiver_arg(char *ra, int *receiver_num)
  78 {
  79         int j;
  80
  81         PARA_DEBUG_LOG("checking %s\n", ra);
  82         for (j = 0; receivers[j].name; j++) {
  83                 const char *name = receivers[j].name;
  84                 size_t len = strlen(name);
  85                 char c;
  86                 if (strlen(ra) < len)
  87                         continue;
  88                 if (strncmp(name, ra, len))
  89                         continue;
  90                 c = ra[len];
  91                 if (c && c != ' ')
  92                         continue;
  93                 if (c && !receivers[j].parse_config)
  94                         return NULL;
  95                 *receiver_num = j;
  96                 return parse_receiver_args(j, c? ra + len + 1: NULL);
  97         }
  98         PARA_ERROR_LOG("receiver not found\n");
  99         return NULL;
 100 }
 101
 102 /**
 103  * Print out the help texts to all receivers.
 104  *
 105  * \param detailed Whether the detailed help should be printed.
 106  */
 107 void print_receiver_helps(int detailed)
 108 {
 109         int i;
 110
 111         printf_or_die("\nAvailable receivers: \n\t");
 112         FOR_EACH_RECEIVER(i)
 113                 printf_or_die("%s%s", i? " " : "", receivers[i].name);
 114         printf_or_die("\n\n");
 115         FOR_EACH_RECEIVER(i) {
 116                 struct receiver *r = receivers + i;
 117                 if (!r->help.short_help)
 118                         continue;
 119                 printf_or_die("Options for %s:\n", r->name);
 120                 ggo_print_help(&r->help, detailed);
 121         }
 122 }