/*

    Copyright (C) ABRT Team

    Copyright (C) RedHat inc.

    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.

*/

#include <glib.h>

#include "libabrt.h"

/*

 * Function called for each problem directory in @for_each_problem_in_dir

 *

 * @param dd A dump directory

 * @param arg User's arguments

 * @returns 0 if everything is OK, a non zero value in order to break the iterator

 */

typedef int (* for_each_problem_in_dir_callback)(struct dump_dir *dd, void *arg);

/*

 * Iterates over all dump directories placed in @path and call @callback.

 *

 * @param path Dump directories location

 * @param caller_uid UID for access check. -1 for disabling this check

 * @param callback Called for each applicable dump directory. Non zero

 * value returned from @callback will breaks the iteration.

 * @param arg User's arguments passed to @callback

 * @returns 0 or the first non zero value returned from @callback

 */

int for_each_problem_in_dir(const char *path,

                        uid_t caller_uid,

                        for_each_problem_in_dir_callback callback,

                        void *arg);

/* Retrieves the list of directories currently used as a problem storage

 * The result must be freed by caller

 * @returns List of strings representing the full path to dirs

 */

GList *get_problem_storages(void);

GList *get_problem_dirs_for_uid(uid_t uid, const char *dump_location);

/*

 * Gets list of problem directories not accessible by user

 *

 * @param uid User's uid

 * @param dump_location Dump directories location

 * @returns GList with mallocated absolute paths to dump directories

 */

GList *get_problem_dirs_not_accessible_by_uid(uid_t uid, const char *dump_location);

/*

 * Checks if problem dump directory contains all necessary data

 *

 * @param dd Dump directory

 * @returns Non zero if problem data are complete, otherwise false

 */

int problem_dump_dir_is_complete(struct dump_dir *dd);