src/input/services_discovery.c

   1 /*****************************************************************************
   2  * services_discovery.c : Manage playlist services_discovery modules
   3  *****************************************************************************
   4  * Copyright (C) 1999-2004 VLC authors and VideoLAN
   5  *
   6  * Authors: Clément Stenac <zorglub@videolan.org>
   7  *
   8  * This program is free software; you can redistribute it and/or modify it
   9  * under the terms of the GNU Lesser General Public License as published by
  10  * the Free Software Foundation; either version 2.1 of the License, or
  11  * (at your option) any later version.
  12  *
  13  * This program is distributed in the hope that it will be useful,
  14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  16  * GNU Lesser General Public License for more details.
  17  *
  18  * You should have received a copy of the GNU Lesser General Public License
  19  * along with this program; if not, write to the Free Software Foundation,
  20  * Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
  21  *****************************************************************************/
  22 #ifdef HAVE_CONFIG_H
  23 # include "config.h"
  24 #endif
  25 #include <assert.h>
  26
  27 #include <vlc_common.h>
  28 #include <vlc_services_discovery.h>
  29 #include <vlc_probe.h>
  30 #include <vlc_modules.h>
  31 #include "../libvlc.h"
  32
  33 typedef struct
  34 {
  35     char *name;
  36     char *longname;
  37     int category;
  38 } vlc_sd_probe_t;
  39
  40 int vlc_sd_probe_Add (vlc_probe_t *probe, const char *name,
  41                       const char *longname, int category)
  42 {
  43     vlc_sd_probe_t names = { strdup(name), strdup(longname), category };
  44
  45     if (unlikely (names.name == NULL || names.longname == NULL
  46                || vlc_probe_add (probe, &names, sizeof (names))))
  47     {
  48         free (names.name);
  49         free (names.longname);
  50         return VLC_ENOMEM;
  51     }
  52     return VLC_PROBE_CONTINUE;
  53 }
  54
  55 #undef vlc_sd_GetNames
  56
  57 /**
  58  * Gets the list of available services discovery plugins.
  59  */
  60 char **vlc_sd_GetNames (vlc_object_t *obj, char ***pppsz_longnames, int **pp_categories)
  61 {
  62     size_t count;
  63     vlc_sd_probe_t *tab = vlc_probe (obj, "services probe", &count);
  64
  65     if (count == 0)
  66     {
  67         free (tab);
  68         return NULL;
  69     }
  70
  71     char **names = vlc_alloc (count + 1, sizeof(char *));
  72     char **longnames = vlc_alloc (count + 1, sizeof(char *));
  73     int *categories = vlc_alloc (count + 1, sizeof(int));
  74
  75     if (unlikely (names == NULL || longnames == NULL || categories == NULL))
  76     {
  77         free(names);
  78         free(longnames);
  79         free(categories);
  80         free(tab);
  81         return NULL;
  82     }
  83     for( size_t i = 0; i < count; i++ )
  84     {
  85         names[i] = tab[i].name;
  86         longnames[i] = tab[i].longname;
  87         categories[i] = tab[i].category;
  88     }
  89     free (tab);
  90     names[count] = longnames[count] = NULL;
  91     categories[count] = 0;
  92     *pppsz_longnames = longnames;
  93     if( pp_categories ) *pp_categories = categories;
  94     else free( categories );
  95     return names;
  96 }
  97
  98 /*
  99  * Services discovery
 100  * Basically you just listen to Service discovery event through the
 101  * sd's event manager.
 102  * That's how the playlist get's Service Discovery information
 103  */
 104
 105 #undef vlc_sd_Create
 106 services_discovery_t *vlc_sd_Create(vlc_object_t *parent, const char *cfg,
 107     const struct services_discovery_owner_t *restrict owner)
 108 {
 109     services_discovery_t *sd = vlc_custom_create(parent, sizeof (*sd),
 110                                                  "services discovery");
 111     if (unlikely(sd == NULL))
 112         return NULL;
 113
 114     free(config_ChainCreate(&sd->psz_name, &sd->p_cfg, cfg));
 115     sd->description = NULL;
 116     sd->owner = *owner;
 117
 118     sd->p_module = module_need(sd, "services_discovery",
 119                                sd->psz_name, true);
 120     if (sd->p_module == NULL)
 121     {
 122         msg_Err(sd, "no suitable services discovery module");
 123         vlc_sd_Destroy(sd);
 124         sd = NULL;
 125     }
 126
 127     return sd;
 128 }
 129
 130 void vlc_sd_Destroy(services_discovery_t *sd)
 131 {
 132     if (sd->p_module != NULL)
 133         module_unneed(sd, sd->p_module);
 134     config_ChainDestroy(sd->p_cfg);
 135     free(sd->psz_name);
 136     vlc_object_release(sd);
 137 }