Updated FSF's address
[platform/upstream/glib.git] / gio / gapplicationcommandline.h
1 /* GIO - GLib Input, Output and Streaming Library
2  *
3  * Copyright © 2010 Codethink Limited
4  *
5  * This program is free software: you can redistribute it and/or modify
6  * it under the terms of the GNU Lesser General Public License as published
7  * by the Free Software Foundation; either version 2 of the licence or (at
8  * your option) any later version.
9  *
10  * This library is distributed in the hope that it will be useful,
11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
13  * Lesser General Public License for more details.
14  *
15  * You should have received a copy of the GNU Lesser General
16  * Public License along with this library; if not, see <http://www.gnu.org/licenses/>.
17  *
18  * Authors: Ryan Lortie <desrt@desrt.ca>
19  */
20
21 #ifndef __G_APPLICATION_COMMAND_LINE_H__
22 #define __G_APPLICATION_COMMAND_LINE_H__
23
24 #if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION)
25 #error "Only <gio/gio.h> can be included directly."
26 #endif
27
28 #include <gio/giotypes.h>
29
30 G_BEGIN_DECLS
31
32 #define G_TYPE_APPLICATION_COMMAND_LINE                     (g_application_command_line_get_type ())
33 #define G_APPLICATION_COMMAND_LINE(inst)                    (G_TYPE_CHECK_INSTANCE_CAST ((inst),                     \
34                                                              G_TYPE_APPLICATION_COMMAND_LINE,                        \
35                                                              GApplicationCommandLine))
36 #define G_APPLICATION_COMMAND_LINE_CLASS(class)             (G_TYPE_CHECK_CLASS_CAST ((class),                       \
37                                                              G_TYPE_APPLICATION_COMMAND_LINE,                        \
38                                                              GApplicationCommandLineClass))
39 #define G_IS_APPLICATION_COMMAND_LINE(inst)                 (G_TYPE_CHECK_INSTANCE_TYPE ((inst),                     \
40                                                              G_TYPE_APPLICATION_COMMAND_LINE))
41 #define G_IS_APPLICATION_COMMAND_LINE_CLASS(class)          (G_TYPE_CHECK_CLASS_TYPE ((class),                       \
42                                                              G_TYPE_APPLICATION_COMMAND_LINE))
43 #define G_APPLICATION_COMMAND_LINE_GET_CLASS(inst)          (G_TYPE_INSTANCE_GET_CLASS ((inst),                      \
44                                                              G_TYPE_APPLICATION_COMMAND_LINE,                        \
45                                                              GApplicationCommandLineClass))
46
47 typedef struct _GApplicationCommandLinePrivate               GApplicationCommandLinePrivate;
48 typedef struct _GApplicationCommandLineClass                 GApplicationCommandLineClass;
49
50 struct _GApplicationCommandLine
51 {
52   /*< private >*/
53   GObject parent_instance;
54
55   GApplicationCommandLinePrivate *priv;
56 };
57
58 struct _GApplicationCommandLineClass
59 {
60   /*< private >*/
61   GObjectClass parent_class;
62
63   void                  (* print_literal)       (GApplicationCommandLine *cmdline,
64                                                  const gchar             *message);
65   void                  (* printerr_literal)    (GApplicationCommandLine *cmdline,
66                                                  const gchar             *message);
67   GInputStream *        (* get_stdin)           (GApplicationCommandLine *cmdline);
68
69   gpointer padding[11];
70 };
71
72 GLIB_AVAILABLE_IN_ALL
73 GType                   g_application_command_line_get_type             (void) G_GNUC_CONST;
74
75 GLIB_AVAILABLE_IN_ALL
76 gchar **                g_application_command_line_get_arguments        (GApplicationCommandLine   *cmdline,
77                                                                          int                       *argc);
78
79 GLIB_AVAILABLE_IN_2_36
80 GInputStream *          g_application_command_line_get_stdin            (GApplicationCommandLine   *cmdline);
81
82 GLIB_AVAILABLE_IN_ALL
83 const gchar * const *   g_application_command_line_get_environ          (GApplicationCommandLine   *cmdline);
84
85 GLIB_AVAILABLE_IN_ALL
86 const gchar *           g_application_command_line_getenv               (GApplicationCommandLine   *cmdline,
87                                                                          const gchar               *name);
88
89 GLIB_AVAILABLE_IN_ALL
90 const gchar *           g_application_command_line_get_cwd              (GApplicationCommandLine   *cmdline);
91
92 GLIB_AVAILABLE_IN_ALL
93 gboolean                g_application_command_line_get_is_remote        (GApplicationCommandLine   *cmdline);
94
95 GLIB_AVAILABLE_IN_ALL
96 void                    g_application_command_line_print                (GApplicationCommandLine   *cmdline,
97                                                                          const gchar               *format,
98                                                                          ...) G_GNUC_PRINTF(2, 3);
99 GLIB_AVAILABLE_IN_ALL
100 void                    g_application_command_line_printerr             (GApplicationCommandLine   *cmdline,
101                                                                          const gchar               *format,
102                                                                          ...) G_GNUC_PRINTF(2, 3);
103
104 GLIB_AVAILABLE_IN_ALL
105 int                     g_application_command_line_get_exit_status      (GApplicationCommandLine   *cmdline);
106 GLIB_AVAILABLE_IN_ALL
107 void                    g_application_command_line_set_exit_status      (GApplicationCommandLine   *cmdline,
108                                                                          int                        exit_status);
109
110 GLIB_AVAILABLE_IN_ALL
111 GVariant *              g_application_command_line_get_platform_data    (GApplicationCommandLine   *cmdline);
112
113 GLIB_AVAILABLE_IN_2_36
114 GFile *                 g_application_command_line_create_file_for_arg  (GApplicationCommandLine   *cmdline,
115                                                                          const gchar               *arg);
116
117 G_END_DECLS
118
119 #endif /* __G_APPLICATION_COMMAND_LINE_H__ */