X-Git-Url: http://review.tizen.org/git/?a=blobdiff_plain;f=gst%2Fgst.c;h=f68beee6a0e0414c11be1997065049bea820137f;hb=5470f6df00595f4ab44871e0e633bf15006abc5c;hp=fd676a3c793229dd7c0231037f73467968b94b06;hpb=e3a386e9cff353c6a2a29ba307a8b9e00ccf709c;p=platform%2Fupstream%2Fgstreamer.git diff --git a/gst/gst.c b/gst/gst.c index fd676a3..f68beee 100644 --- a/gst/gst.c +++ b/gst/gst.c @@ -22,11 +22,12 @@ /** * SECTION:gst + * @title: GStreamer * @short_description: Media library supporting arbitrary formats and filter * graphs. * * GStreamer is a framework for constructing graphs of various filters - * (termed elements here) that will handle streaming media. Any discreet + * (termed elements here) that will handle streaming media. Any discrete * (packetizable) media type is supported, with provisions for automatically * determining source type. Formatting/framing information is provided with * a powerful negotiation framework. Plugins are heavily used to provide for @@ -40,9 +41,9 @@ * and argv variables so that GStreamer can process its own command line * options, as shown in the following example. * - * - * Initializing the gstreamer library - * + * ## Initializing the gstreamer library + * + * |[ * int * main (int argc, char *argv[]) * { @@ -50,17 +51,16 @@ * gst_init (&argc, &argv); * ... * } - * - * + * ]| * - * It's allowed to pass two NULL pointers to gst_init() in case you don't want + * It's allowed to pass two %NULL pointers to gst_init() in case you don't want * to pass the command line args to GStreamer. * * You can also use GOption to initialize your own parameters as shown in * the next code fragment: - * - * Initializing own parameters when initializing gstreamer - * + * + * ## Initializing own parameters when initializing gstreamer + * |[ * static gboolean stats = FALSE; * ... * int @@ -81,18 +81,14 @@ * g_option_context_free (ctx); * ... * } - * - * + * ]| * * Use gst_version() to query the library version at runtime or use the * GST_VERSION_* macros to find the version at compile time. Optionally * gst_version_string() returns a printable string. * * The gst_deinit() call is used to clean up all internal resources used - * by GStreamer. It is mostly used in unit tests - * to check for leaks. - * - * Last reviewed on 2006-08-11 (0.10.10) + * by GStreamer. It is mostly used in unit tests to check for leaks. */ #include "gst_private.h" @@ -110,12 +106,17 @@ #define WIN32_LEAN_AND_MEAN /* prevents from including too many things */ #include /* GetStdHandle, windows console */ #endif +#if defined (__APPLE__) +#include "TargetConditionals.h" +#if !TARGET_OS_IPHONE && !TARGET_OS_SIMULATOR && !TARGET_OS_EMBEDDED +#include /* proc_pidpath, PROC_PIDPATHINFO_MAXSIZE */ +#endif +#endif #include "gst-i18n-lib.h" #include /* for LC_ALL */ #include "gst.h" -#include "gsttrace.h" #define GST_CAT_DEFAULT GST_CAT_GST_INIT @@ -125,16 +126,21 @@ static gboolean gst_initialized = FALSE; static gboolean gst_deinitialized = FALSE; +GstClockTime _priv_gst_start_time; + #ifdef G_OS_WIN32 HMODULE _priv_gst_dll_handle = NULL; #endif #ifndef GST_DISABLE_REGISTRY -GList *_priv_gst_plugin_paths = NULL; /* for delayed processing in post_init */ +GList *_priv_gst_plugin_paths = NULL; /* for delayed processing in init_post */ +extern gboolean _priv_gst_disable_registry; extern gboolean _priv_gst_disable_registry_update; #endif +gchar *_gst_executable_path = NULL; + #ifndef GST_DISABLE_GST_DEBUG const gchar *priv_gst_dump_dot_dir; #endif @@ -194,6 +200,17 @@ enum */ #ifdef G_OS_WIN32 +/* Note: DllMain is only called when DLLs are loaded or unloaded, so this will + * never be called if libgstreamer-1.0 is linked statically. Do not add any code + * here to, say, initialize variables or set things up since that will only + * happen for dynamically-built GStreamer. + * + * Also, ideally this should not be defined when GStreamer is built statically. + * i.e., it should be conditional on #ifdef DLL_EXPORT. It will be ignored, but + * if other libraries make the same mistake of defining it when building + * statically, there will be a symbol collision during linking. Fixing this + * requires one to build two object files: one for static linking and another + * for dynamic linking. */ BOOL WINAPI DllMain (HINSTANCE hinstDLL, DWORD fdwReason, LPVOID lpvReserved); BOOL WINAPI DllMain (HINSTANCE hinstDLL, DWORD fdwReason, LPVOID lpvReserved) @@ -220,7 +237,7 @@ DllMain (HINSTANCE hinstDLL, DWORD fdwReason, LPVOID lpvReserved) * threading system as one of the very first things in your program * (see the example at the beginning of this section). * - * Returns: (transfer full): a pointer to GStreamer's option group. + * Returns: (transfer full) (nullable): a pointer to GStreamer's option group. */ GOptionGroup * @@ -240,7 +257,7 @@ gst_init_get_option_group (void) NULL}, {"gst-debug-level", 0, 0, G_OPTION_ARG_CALLBACK, (gpointer) parse_goption_arg, - N_("Default debug level from 1 (only error) to 5 (anything) or " + N_("Default debug level from 1 (only error) to 9 (anything) or " "0 for no output"), N_("LEVEL")}, {"gst-debug", 0, 0, G_OPTION_ARG_CALLBACK, (gpointer) parse_goption_arg, @@ -302,6 +319,73 @@ gst_init_get_option_group (void) #endif } +#if defined(__linux__) +static void +find_executable_path (void) +{ + GError *error = NULL; + + if (_gst_executable_path) + return; + + _gst_executable_path = g_file_read_link ("/proc/self/exe", &error); + if (error) + g_error_free (error); +} +#elif defined(G_OS_WIN32) +static void +find_executable_path (void) +{ + char buffer[MAX_PATH]; + + if (!GetModuleFileName (NULL, buffer, MAX_PATH)) + return; + + _gst_executable_path = g_strdup (buffer); +} +#elif defined(__APPLE__) && !TARGET_OS_IPHONE && !TARGET_OS_SIMULATOR && !TARGET_OS_EMBEDDED +static void +find_executable_path (void) +{ + int ret; + pid_t pid; + char pathbuf[PROC_PIDPATHINFO_MAXSIZE]; + + pid = getpid (); + ret = proc_pidpath (pid, pathbuf, sizeof (pathbuf)); + if (ret > 0) + _gst_executable_path = g_strdup (pathbuf); +} +#else +static void +find_executable_path (void) +{ + GST_FIXME ("Couldn't look up executable path, add support for this platform"); +} +#endif + +/** + * gst_get_main_executable_path: + * + * This helper is mostly helpful for plugins that need to + * inspect the folder of the main executable to determine + * their set of features. + * + * When a plugin is initialized from the gst-plugin-scanner + * external process, the returned path will be the same as from the + * parent process. + * + * Returns: (transfer none) (nullable): The path of the executable that + * initialized GStreamer, or %NULL if it could not be determined. + * + * Since: 1.14 + */ +const gchar * +gst_get_main_executable_path (void) +{ + return _gst_executable_path; +} + /** * gst_init_check: * @argc: (inout) (allow-none): pointer to application's argc @@ -320,14 +404,18 @@ gst_init_get_option_group (void) gboolean gst_init_check (int *argc, char **argv[], GError ** err) { + static GMutex init_lock; #ifndef GST_DISABLE_OPTION_PARSING GOptionGroup *group; GOptionContext *ctx; #endif gboolean res; + g_mutex_lock (&init_lock); + if (gst_initialized) { GST_DEBUG ("already initialized gst"); + g_mutex_unlock (&init_lock); return TRUE; } #ifndef GST_DISABLE_OPTION_PARSING @@ -346,11 +434,7 @@ gst_init_check (int *argc, char **argv[], GError ** err) gst_initialized = res; - if (res) { - GST_INFO ("initialized GStreamer successfully"); - } else { - GST_INFO ("failed to initialize GStreamer"); - } + g_mutex_unlock (&init_lock); return res; } @@ -370,14 +454,12 @@ gst_init_check (int *argc, char **argv[], GError ** err) * Running GStreamer Applications * for how to disable automatic registry updates. * - * - * This function will terminate your program if it was unable to initialize - * GStreamer for some reason. If you want your program to fall back, - * use gst_init_check() instead. - * + * > This function will terminate your program if it was unable to initialize + * > GStreamer for some reason. If you want your program to fall back, + * > use gst_init_check() instead. * * WARNING: This function does not work in the same way as corresponding - * functions in other glib-style libraries, such as gtk_init(). In + * functions in other glib-style libraries, such as gtk_init\(\). In * particular, unknown command line options cause this function to * abort program execution. */ @@ -402,7 +484,7 @@ gst_init (int *argc, char **argv[]) * Use this function to check if GStreamer has been initialized with gst_init() * or gst_init_check(). * - * Returns: TRUE if initialization has been done, FALSE otherwise. + * Returns: %TRUE if initialization has been done, %FALSE otherwise. */ gboolean gst_is_initialized (void) @@ -410,7 +492,8 @@ gst_is_initialized (void) return gst_initialized; } -#ifndef GST_DISABLE_REGISTRY +#ifndef GST_DISABLE_OPTION_PARSING +# ifndef GST_DISABLE_REGISTRY static void add_path_func (gpointer data, gpointer user_data) { @@ -418,6 +501,7 @@ add_path_func (gpointer data, gpointer user_data) _priv_gst_plugin_paths = g_list_append (_priv_gst_plugin_paths, g_strdup (data)); } +# endif #endif #ifndef GST_DISABLE_OPTION_PARSING @@ -461,16 +545,19 @@ static gboolean init_pre (GOptionContext * context, GOptionGroup * group, gpointer data, GError ** error) { + gchar *libdir; if (gst_initialized) { GST_DEBUG ("already initialized"); return TRUE; } -#if !GLIB_CHECK_VERSION(2, 35, 0) - g_type_init (); -#endif + + find_executable_path (); + + _priv_gst_start_time = gst_util_get_timestamp (); #ifndef GST_DISABLE_GST_DEBUG _priv_gst_debug_init (); + priv_gst_dump_dot_dir = g_getenv ("GST_DEBUG_DUMP_DOT_DIR"); #endif #ifdef ENABLE_NLS @@ -478,29 +565,36 @@ init_pre (GOptionContext * context, GOptionGroup * group, gpointer data, bind_textdomain_codeset (GETTEXT_PACKAGE, "UTF-8"); #endif /* ENABLE_NLS */ -#ifndef GST_DISABLE_GST_DEBUG + /* This is the earliest we can make stuff show up in the logs. + * So give some useful info about GStreamer here */ +#ifdef G_OS_WIN32 { - const gchar *debug_list; - const gchar *color_mode; - - if (g_getenv ("GST_DEBUG_NO_COLOR") != NULL) - gst_debug_set_color_mode (GST_DEBUG_COLOR_MODE_OFF); - color_mode = g_getenv ("GST_DEBUG_COLOR_MODE"); - if (color_mode) - gst_debug_set_color_mode_from_string (color_mode); - - debug_list = g_getenv ("GST_DEBUG"); - if (debug_list) { - gst_debug_set_threshold_from_string (debug_list, FALSE); - } - } + gchar *basedir = + g_win32_get_package_installation_directory_of_module + (_priv_gst_dll_handle); - priv_gst_dump_dot_dir = g_getenv ("GST_DEBUG_DUMP_DOT_DIR"); + libdir = g_build_filename (basedir, +#ifdef _DEBUG + "debug" +#endif + "lib", NULL); + g_free (basedir); + } +#else + libdir = g_strdup (LIBDIR); #endif - /* This is the earliest we can make stuff show up in the logs. - * So give some useful info about GStreamer here */ GST_INFO ("Initializing GStreamer Core Library version %s", VERSION); - GST_INFO ("Using library installed in %s", LIBDIR); + GST_INFO ("Using library installed in %s", libdir); + g_free (libdir); + +#ifndef GST_DISABLE_REGISTRY + { + const gchar *disable_registry; + if ((disable_registry = g_getenv ("GST_REGISTRY_DISABLE"))) { + _priv_gst_disable_registry = (strcmp (disable_registry, "yes") == 0); + } + } +#endif /* Print some basic system details if possible (OS/architecture) */ #ifdef HAVE_SYS_UTSNAME_H @@ -539,7 +633,7 @@ gst_register_core_elements (GstPlugin * plugin) /* * this bit handles: - * - initalization of threads if we use them + * - initialization of threads if we use them * - log handler * - initial output * - initializes gst_format @@ -562,12 +656,9 @@ init_post (GOptionContext * context, GOptionGroup * group, gpointer data, llf = G_LOG_LEVEL_CRITICAL | G_LOG_LEVEL_ERROR | G_LOG_FLAG_FATAL; g_log_set_handler (g_log_domain_gstreamer, llf, debug_log_handler, NULL); -#ifndef GST_DISABLE_TRACE - _priv_gst_alloc_trace_initialize (); -#endif - _priv_gst_mini_object_initialize (); _priv_gst_quarks_initialize (); + _priv_gst_allocator_initialize (); _priv_gst_memory_initialize (); _priv_gst_format_initialize (); _priv_gst_query_initialize (); @@ -575,11 +666,13 @@ init_post (GOptionContext * context, GOptionGroup * group, gpointer data, _priv_gst_caps_initialize (); _priv_gst_caps_features_initialize (); _priv_gst_meta_initialize (); + _priv_gst_message_initialize (); g_type_class_ref (gst_object_get_type ()); g_type_class_ref (gst_pad_get_type ()); g_type_class_ref (gst_element_factory_get_type ()); g_type_class_ref (gst_element_get_type ()); + g_type_class_ref (gst_tracer_factory_get_type ()); g_type_class_ref (gst_type_find_factory_get_type ()); g_type_class_ref (gst_bin_get_type ()); g_type_class_ref (gst_bus_get_type ()); @@ -605,6 +698,8 @@ init_post (GOptionContext * context, GOptionGroup * group, gpointer data, g_type_class_ref (gst_state_change_return_get_type ()); g_type_class_ref (gst_state_change_get_type ()); g_type_class_ref (gst_element_flags_get_type ()); + g_type_class_ref (gst_tracer_value_scope_get_type ()); + g_type_class_ref (gst_tracer_value_flags_get_type ()); g_type_class_ref (gst_core_error_get_type ()); g_type_class_ref (gst_library_error_get_type ()); g_type_class_ref (gst_resource_error_get_type ()); @@ -663,22 +758,27 @@ init_post (GOptionContext * context, GOptionGroup * group, gpointer data, g_type_class_ref (gst_meta_flags_get_type ()); g_type_class_ref (gst_toc_entry_type_get_type ()); g_type_class_ref (gst_toc_scope_get_type ()); + g_type_class_ref (gst_toc_loop_type_get_type ()); g_type_class_ref (gst_control_binding_get_type ()); g_type_class_ref (gst_control_source_get_type ()); g_type_class_ref (gst_lock_flags_get_type ()); g_type_class_ref (gst_allocator_flags_get_type ()); g_type_class_ref (gst_stream_flags_get_type ()); + g_type_class_ref (gst_stream_type_get_type ()); + g_type_class_ref (gst_stack_trace_flags_get_type ()); + g_type_class_ref (gst_promise_result_get_type ()); _priv_gst_event_initialize (); _priv_gst_buffer_initialize (); - _priv_gst_message_initialize (); _priv_gst_buffer_list_initialize (); _priv_gst_sample_initialize (); - _priv_gst_value_initialize (); _priv_gst_context_initialize (); + _priv_gst_date_time_initialize (); + _priv_gst_value_initialize (); + _priv_gst_tag_initialize (); + _priv_gst_toc_initialize (); g_type_class_ref (gst_param_spec_fraction_get_type ()); - _priv_gst_tag_initialize (); gst_parse_context_get_type (); _priv_gst_plugin_initialize (); @@ -694,7 +794,7 @@ init_post (GOptionContext * context, GOptionGroup * group, gpointer data, * gstreamer as being initialized, since it is the case from a plugin point of * view. * - * If anything fails, it will be put back to FALSE in gst_init_check(). + * If anything fails, it will be put back to %FALSE in gst_init_check(). * This allows some special plugins that would call gst_init() to not cause a * looping effect (i.e. initializing GStreamer twice). */ @@ -707,11 +807,17 @@ init_post (GOptionContext * context, GOptionGroup * group, gpointer data, glib_minor_version, glib_micro_version); GST_INFO ("GLib headers version: %d.%d.%d", GLIB_MAJOR_VERSION, GLIB_MINOR_VERSION, GLIB_MICRO_VERSION); + GST_INFO ("initialized GStreamer successfully"); + +#ifndef GST_DISABLE_GST_DEBUG + _priv_gst_tracing_init (); +#endif return TRUE; } -#ifndef GST_DISABLE_GST_DEBUG +#ifndef GST_DISABLE_OPTION_PARSING +# ifndef GST_DISABLE_GST_DEBUG static gboolean select_all (GstPlugin * plugin, gpointer user_data) { @@ -741,8 +847,41 @@ gst_debug_help (void) /* FIXME this is gross. why don't debug have categories PluginFeatures? */ for (g = list2; g; g = g_list_next (g)) { GstPlugin *plugin = GST_PLUGIN_CAST (g->data); + GList *features, *orig_features; + + if (GST_OBJECT_FLAG_IS_SET (plugin, GST_PLUGIN_FLAG_BLACKLISTED)) + continue; gst_plugin_load (plugin); + /* Now create one of each feature so the class_init functions + * are called, as that's where most debug categories are + * registered. FIXME: If debug categories were a plugin feature, + * this would be unneeded */ + orig_features = features = + gst_registry_get_feature_list_by_plugin (gst_registry_get (), + gst_plugin_get_name (plugin)); + while (features) { + GstPluginFeature *feature; + + if (G_UNLIKELY (features->data == NULL)) + goto next; + + feature = GST_PLUGIN_FEATURE (features->data); + if (GST_IS_ELEMENT_FACTORY (feature)) { + GstElementFactory *factory; + GstElement *e; + + factory = GST_ELEMENT_FACTORY (feature); + e = gst_element_factory_create (factory, NULL); + if (e) + gst_object_unref (e); + } + + next: + features = g_list_next (features); + } + + gst_plugin_feature_list_free (orig_features); } g_list_free (list2); @@ -800,7 +939,8 @@ gst_debug_help (void) g_slist_free (list); g_print ("\n"); } -#endif +# endif /* GST_DISABLE_OPTION_PARSING */ +#endif /* GST_DISABLE_GST_DEBUG */ #ifndef GST_DISABLE_OPTION_PARSING static gboolean @@ -848,7 +988,8 @@ parse_one_option (gint opt, const gchar * arg, GError ** err) break; case ARG_PLUGIN_PATH: #ifndef GST_DISABLE_REGISTRY - split_and_iterate (arg, G_SEARCHPATH_SEPARATOR_S, add_path_func, NULL); + if (!_priv_gst_disable_registry) + split_and_iterate (arg, G_SEARCHPATH_SEPARATOR_S, add_path_func, NULL); #endif /* GST_DISABLE_REGISTRY */ break; case ARG_PLUGIN_LOAD: @@ -859,7 +1000,8 @@ parse_one_option (gint opt, const gchar * arg, GError ** err) break; case ARG_REGISTRY_UPDATE_DISABLE: #ifndef GST_DISABLE_REGISTRY - _priv_gst_disable_registry_update = TRUE; + if (!_priv_gst_disable_registry) + _priv_gst_disable_registry_update = TRUE; #endif break; case ARG_REGISTRY_FORK_DISABLE: @@ -927,7 +1069,7 @@ parse_goption_arg (const gchar * opt, * This function is therefore mostly used by testsuites and other memory * profiling tools. * - * After this call GStreamer (including this method) should not be used anymore. + * After this call GStreamer (including this method) should not be used anymore. */ void gst_deinit (void) @@ -935,15 +1077,18 @@ gst_deinit (void) GstBinClass *bin_class; GstClock *clock; + if (!gst_initialized) + return; + GST_INFO ("deinitializing GStreamer"); if (gst_deinitialized) { GST_DEBUG ("already deinitialized"); return; } - - bin_class = GST_BIN_CLASS (g_type_class_peek (gst_bin_get_type ())); - if (bin_class->pool != NULL) { + g_thread_pool_set_max_unused_threads (0); + bin_class = (GstBinClass *) g_type_class_peek (gst_bin_get_type ()); + if (bin_class && bin_class->pool != NULL) { g_thread_pool_free (bin_class->pool, FALSE, TRUE); bin_class->pool = NULL; } @@ -959,20 +1104,33 @@ gst_deinit (void) _priv_gst_plugin_paths = NULL; #endif + if (_gst_executable_path) { + g_free (_gst_executable_path); + _gst_executable_path = NULL; + } + clock = gst_system_clock_obtain (); gst_object_unref (clock); gst_object_unref (clock); _priv_gst_registry_cleanup (); + _priv_gst_allocator_cleanup (); -#ifndef GST_DISABLE_TRACE - _priv_gst_alloc_trace_deinit (); + /* We want to destroy tracers as late as possible for the leaks tracer + * but still need to keep the caps system alive as it may have to use + * gst_caps_to_string() to display leaked caps. */ +#ifndef GST_DISABLE_GST_DEBUG + _priv_gst_tracing_deinit (); #endif + _priv_gst_caps_features_cleanup (); + _priv_gst_caps_cleanup (); + g_type_class_unref (g_type_class_peek (gst_object_get_type ())); g_type_class_unref (g_type_class_peek (gst_pad_get_type ())); g_type_class_unref (g_type_class_peek (gst_element_factory_get_type ())); g_type_class_unref (g_type_class_peek (gst_element_get_type ())); + g_type_class_unref (g_type_class_peek (gst_tracer_factory_get_type ())); g_type_class_unref (g_type_class_peek (gst_type_find_factory_get_type ())); g_type_class_unref (g_type_class_peek (gst_bin_get_type ())); g_type_class_unref (g_type_class_peek (gst_bus_get_type ())); @@ -993,6 +1151,8 @@ gst_deinit (void) g_type_class_unref (g_type_class_peek (gst_state_change_return_get_type ())); g_type_class_unref (g_type_class_peek (gst_state_change_get_type ())); g_type_class_unref (g_type_class_peek (gst_element_flags_get_type ())); + g_type_class_unref (g_type_class_peek (gst_tracer_value_scope_get_type ())); + g_type_class_unref (g_type_class_peek (gst_tracer_value_flags_get_type ())); g_type_class_unref (g_type_class_peek (gst_core_error_get_type ())); g_type_class_unref (g_type_class_peek (gst_library_error_get_type ())); g_type_class_unref (g_type_class_peek (gst_plugin_dependency_flags_get_type @@ -1054,14 +1214,18 @@ gst_deinit (void) g_type_class_unref (g_type_class_peek (gst_pad_probe_return_get_type ())); g_type_class_unref (g_type_class_peek (gst_segment_flags_get_type ())); g_type_class_unref (g_type_class_peek (gst_scheduling_flags_get_type ())); + g_type_class_unref (g_type_class_peek (gst_stream_type_get_type ())); g_type_class_unref (g_type_class_peek (gst_control_binding_get_type ())); g_type_class_unref (g_type_class_peek (gst_control_source_get_type ())); g_type_class_unref (g_type_class_peek (gst_toc_entry_type_get_type ())); + g_type_class_unref (g_type_class_peek (gst_toc_loop_type_get_type ())); g_type_class_unref (g_type_class_peek (gst_lock_flags_get_type ())); g_type_class_unref (g_type_class_peek (gst_allocator_flags_get_type ())); g_type_class_unref (g_type_class_peek (gst_stream_flags_get_type ())); g_type_class_unref (g_type_class_peek (gst_debug_color_mode_get_type ())); + g_type_class_unref (g_type_class_peek (gst_stack_trace_flags_get_type ())); + g_type_class_unref (g_type_class_peek (gst_promise_result_get_type ())); gst_deinitialized = TRUE; GST_INFO ("deinitialized GStreamer");