Blob Blame History Raw
/*
  Copyright (C) 2015  ABRT team

  This program is free software; you can redistribute it and/or modify
  it under the terms of the GNU General Public License as published by
  the Free Software Foundation; either version 2 of the License, or
  (at your option) any later version.

  This program is distributed in the hope that it will be useful,
  but WITHOUT ANY WARRANTY; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  GNU General Public License for more details.

  You should have received a copy of the GNU General Public License along
  with this program; if not, write to the Free Software Foundation, Inc.,
  51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA

  ------------------------------------------------------------------------------

  This file declares functions for org.freedesktop.Problems2 interface.

  AbrtP2Service is a central point. All other components should communicate to
  each other via AbrtP2Service as much as possible.

  AbrtP2Service manages all D-Bus objects. It register new object paths in
  D-Bus daemon. D-Bus objects are hidden behind AbrtP2Object that links D-Bus
  path with an implementation - node (real object -> Entry, Session, Task) .
*/
#ifndef ABRT_PROBLEMS2_SERVICE_H
#define ABRT_PROBLEMS2_SERVICE_H

#include <glib-object.h>
#include <gio/gio.h>

#define ABRT_P2_BUS "org.freedesktop.problems"
#define ABRT_P2_PATH "/org/freedesktop/Problems2"
#define ABRT_P2_NS "org.freedesktop.Problems2"
#define ABRT_P2_NS_MEMBER(name) ABRT_P2_NS"."name

/*
 * D-Bus object representation
 */
typedef struct _AbrtP2Object AbrtP2Object;
const char *abrt_p2_object_path(AbrtP2Object *obj);
void *abrt_p2_object_get_node(AbrtP2Object *obj);
void abrt_p2_object_destroy(AbrtP2Object *obj);

/*
 * Service - something like object manager
 */
#define TYPE_ABRT_P2_SERVICE abrt_p2_service_get_type ()
G_DECLARE_FINAL_TYPE(AbrtP2Service, abrt_p2_service, ABRT_P2, SERVICE, GObject)

AbrtP2Service *abrt_p2_service_new(GError **error);

int abrt_p2_service_register_objects(AbrtP2Service *service,
            GDBusConnection *connection,
            GError **error);

const char *abrt_p2_service_session_path(AbrtP2Service *service,
            const char *caller,
            GError **error);

uid_t abrt_p2_service_caller_uid(AbrtP2Service *service,
            const char *caller,
            GError **error);

uid_t abrt_p2_service_caller_real_uid(AbrtP2Service *service,
            const char *caller,
            GError **error);

char *abrt_p2_service_save_problem(AbrtP2Service *service,
            GVariant *problem_info,
            GUnixFDList *fd_list,
            uid_t caller_uid,
            GError **error);

int abrt_p2_service_remove_problem(AbrtP2Service *service,
            const char *entry_path,
            uid_t caller_uid,
            GError **error);

GVariant *abrt_p2_service_entry_problem_data(AbrtP2Service *service,
            const char *entry_path,
            uid_t caller_uid,
            GError **error);


enum {
    ABRT_P2_SERVICE_ENTRY_LOOKUP_NOFLAGS  = 0x0, ///< return with error if not found
    ABRT_P2_SERVICE_ENTRY_LOOKUP_OPTIONAL = 0x1, ///< return NULL if not found
} AbrtP2ServiceEntryLookupFlag;

AbrtP2Object *abrt_p2_service_get_entry_for_problem(AbrtP2Service *service,
            const char *problem_id,
            int flags,
            GError **error);

struct _AbrtP2Entry;
AbrtP2Object *abrt_p2_service_register_entry(AbrtP2Service *service,
            struct _AbrtP2Entry *entry,
            GError **error);

void abrt_p2_service_notify_entry_object(AbrtP2Service *service,
            AbrtP2Object *obj,
            GError **error);

int abrt_p2_service_user_can_create_new_problem(AbrtP2Service *service,
            uid_t uid);

GVariant *abrt_p2_service_new_problem(AbrtP2Service *service,
            AbrtP2Object *session_obj,
            GVariant *problem_info,
            gint32 flags,
            uid_t caller_uid,
            GUnixFDList *fd_list,
            GError **error);

void abrt_p2_service_new_problem_async(AbrtP2Service *service,
            GVariant *problem_info,
            gint32 flags,
            uid_t caller_uid,
            GUnixFDList *fd_list,
            GCancellable *cancellable,
            GAsyncReadyCallback callback,
            gpointer user_data);

GVariant *abrt_p2_service_new_problem_finish(AbrtP2Service *service,
            GAsyncResult *result,
            GError **error);

GVariant *abrt_p2_service_callers_session(AbrtP2Service *service,
            const char *caller,
            GError **error);

/*
 * GetProblems
 */
typedef enum
{
    ABRT_P2_SERVICE_GET_PROBLEM_FLAGS_NONE = 0x0,
    ABRT_P2_SERVICE_GET_PROBLEM_FLAGS_FOREIGN = 0x1,
    ABRT_P2_SERVICE_GET_PROBLEM_FLAGS_NEW = 0x2,
} AbrtP2ServiceGetProblemsFlags;

GVariant *abrt_p2_service_get_problems(AbrtP2Service *service,
            uid_t caller_uid,
            gint32 flags,
            GVariant *options,
            GError **error);

GVariant *abrt_p2_service_delete_problems(AbrtP2Service *service,
            GVariant *entries,
            uid_t caller_uid,
            GError **error);

/* Configuration option: D-Bus maximum size of a message, to avoid magical
 *                       disappearing of the service - if you exceed this limit
 *                       D-Bus daemon disconnects you from the bus
 */
long abrt_p2_service_max_message_size(AbrtP2Service *service);

void abrt_p2_service_set_max_message_size(AbrtP2Service *service,
            long max_message_size);

/* Configuration option: D-Bus maximum unix fds in a message, to avoid magical
 *                       disappearing of the service - if you exceed this limit
 *                       D-Bus daemon disconnects you from the bus
 */
long abrt_p2_service_max_message_unix_fds(AbrtP2Service *service);

void abrt_p2_service_set_max_message_unix_fds(AbrtP2Service *service,
            long max_message_unix_fds);

/* Configuration option: maximal number of connected clients per user */
unsigned abrt_p2_service_user_clients_limit(AbrtP2Service *service,
            uid_t uid);

void abrt_p2_service_set_user_clients_limit(AbrtP2Service *service,
            uid_t uid,
            unsigned limit);

/* Configuration option: elements count limit */
unsigned abrt_p2_service_elements_limit(AbrtP2Service *service,
        uid_t uid);

void abrt_p2_service_set_elements_limit(AbrtP2Service *service,
            uid_t uid,
            unsigned limit);

/* Configuration option: data size limit */
off_t abrt_p2_service_data_size_limit(AbrtP2Service *service,
            uid_t uid);

void abrt_p2_service_set_data_size_limit(AbrtP2Service *service,
            uid_t uid,
            off_t limit);

/* Configuration option: user problems limit */
unsigned abrt_p2_service_user_problems_limit(AbrtP2Service *service,
           uid_t uid);

void abrt_p2_service_set_user_problems_limit(AbrtP2Service *service,
            uid_t uid,
            unsigned limit);

/* Configuration option: throttling magnitude */
unsigned abrt_p2_service_new_problem_throttling_magnitude(AbrtP2Service *service,
            uid_t uid);

void abrt_p2_service_set_new_problem_throttling_magnitude(AbrtP2Service *service,
            uid_t uid,
            unsigned limit);

/* Configuration option: new problems batch */
unsigned abrt_p2_service_new_problems_batch(AbrtP2Service *service,
            uid_t uid);

void abrt_p2_service_set_new_problems_batch(AbrtP2Service *service,
            uid_t uid,
            unsigned limit);

#endif/*ABRT_PROBLEMS2_SERVICE_H*/