daemon/appdb.h

   1 /* -*- Mode: C ; c-basic-offset: 2 -*- */
   2 /*
   3  * LADI Session Handler (ladish)
   4  *
   5  * Copyright (C) 2008 Nedko Arnaudov <nedko@arnaudov.name>
   6  *
   7  **************************************************************************
   8  * This file contains interface to the application database code
   9  **************************************************************************
  10  *
  11  * LADI Session Handler is free software; you can redistribute it and/or modify
  12  * it under the terms of the GNU General Public License as published by
  13  * the Free Software Foundation; either version 2 of the License, or
  14  * (at your option) any later version.
  15  *
  16  * LADI Session Handler is distributed in the hope that it will be useful,
  17  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  18  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  19  * GNU General Public License for more details.
  20  *
  21  * You should have received a copy of the GNU General Public License
  22  * along with LADI Session Handler. If not, see <http://www.gnu.org/licenses/>
  23  * or write to the Free Software Foundation, Inc.,
  24  * 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  25  */
  26
  27 #ifndef APPDB_H__4839D031_68EF_43F5_BDE2_2317C6B956A9__INCLUDED
  28 #define APPDB_H__4839D031_68EF_43F5_BDE2_2317C6B956A9__INCLUDED
  29
  30 #include "../common/klist.h"
  31
  32 /* all strings except name can be not present (NULL) */
  33 /* all strings are utf-8 */
  34 struct lash_appdb_entry
  35 {
  36   struct list_head siblings;
  37   char * name;    /* Specific name of the application, for example "Ingen" */
  38   char * generic_name;  /* Generic name of the application, for example "Audio Editor" */
  39   char * comment;   /* Tooltip for the entry, for example "Record and edit audio files" */
  40   char * icon;    /* Icon */
  41   char * exec;    /* Program to execute, possibly with arguments. */
  42   char * path;    /* The working directory to run the program in. */
  43   bool terminal;    /* Wheter to run application in terminal */
  44 };
  45
  46 /* parses .desktop entries in suitable XDG directories and returns list of lash_appdb_entry structs in appdb parameter */
  47 /* returns success status */
  48 bool
  49 lash_appdb_load(
  50   struct list_head * appdb);
  51
  52 /* free list of lash_appdb_entry structs, as returned by lash_appdb_load() */
  53 void
  54 lash_appdb_free(
  55   struct list_head * appdb);
  56
  57 #endif /* #ifndef APPDB_H__4839D031_68EF_43F5_BDE2_2317C6B956A9__INCLUDED */