include/pkgmgr-info.h

   1 /*
   2  * pkgmgr-info
   3  *
   4  * Copyright (c) 2000 - 2011 Samsung Electronics Co., Ltd. All rights reserved.
   5  *
   6  * Contact: Jayoun Lee <airjany@samsung.com>, Sewook Park <sewook7.park@samsung.com>,
   7  * Jaeho Lee <jaeho81.lee@samsung.com>, Shobhit Srivastava <shobhit.s@samsung.com>
   8  *
   9  * Licensed under the Apache License, Version 2.0 (the "License");
  10  * you may not use this file except in compliance with the License.
  11  * You may obtain a copy of the License at
  12  *
  13  * http://www.apache.org/licenses/LICENSE-2.0
  14  *
  15  * Unless required by applicable law or agreed to in writing, software
  16  * distributed under the License is distributed on an "AS IS" BASIS,
  17  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  18  * See the License for the specific language governing permissions and
  19  * limitations under the License.
  20  *
  21  */
  22
  23 /**
  24  * @file                pkgmgr-info.h
  25  * @author              Sewook Park <sewook7.park@samsung.com>
  26  * @author              Shobhit Srivastava <shobhit.s@samsung.com>
  27  * @version             0.1
  28  * @brief               This file declares API of pkgmgr-info library
  29  *
  30  * @addtogroup          APPLICATION_FRAMEWORK
  31  * @{
  32  *
  33  * @defgroup            PackageManagerInfo
  34  * @section             Header Header file to include:
  35  * @code
  36  * #include             <pkgmgr-info.h>
  37  * @endcode
  38  *
  39  * @}
  40  */
  41
  42 #ifndef __PKG_INFO_H__
  43 #define __PKG_INFO_H__
  44
  45 #include <errno.h>
  46 #include <stdbool.h>
  47 #include <unistd.h>
  48 #include <sys/types.h>
  49
  50 #include "pkgmgrinfo_type.h"
  51
  52 #ifdef __cplusplus
  53 extern "C" {
  54 #endif
  55
  56
  57 /**
  58  * @mainpage
  59  *
  60  * This is package information library
  61  *
  62  * Package Information Library is used to get package related information.\n
  63  * It uses the package manifest information database to get any package related information\n
  64  * It also provides API to set information in the package info database\n
  65  *
  66  */
  67
  68 /**
  69  * @file        pkgmgr-info.h
  70  * @brief       Package Information Library Header File
  71  *
  72  * Generated by    Sewook Park <sewook7.park@samsung.com>
  73  */
  74
  75
  76
  77  /** String property for filtering based on package info*/
  78 #define PMINFO_PKGINFO_PROP_PACKAGE_ID          "PMINFO_PKGINFO_PROP_PACKAGE_ID"
  79  /** String property for filtering based on package info*/
  80 #define PMINFO_PKGINFO_PROP_PACKAGE_TYPE        "PMINFO_PKGINFO_PROP_PACKAGE_TYPE"
  81  /** String property for filtering based on package info*/
  82 #define PMINFO_PKGINFO_PROP_PACKAGE_VERSION     "PMINFO_PKGINFO_PROP_PACKAGE_VERSION"
  83  /** String property for filtering based on package info*/
  84 #define PMINFO_PKGINFO_PROP_PACKAGE_INSTALL_LOCATION            "PMINFO_PKGINFO_PROP_PACKAGE_INSTALL_LOCATION"
  85   /** String property for filtering based on package info*/
  86 #define PMINFO_PKGINFO_PROP_PACKAGE_INSTALLED_STORAGE           "PMINFO_PKGINFO_PROP_PACKAGE_INSTALLED_STORAGE"
  87  /** String property for filtering based on package info*/
  88 #define PMINFO_PKGINFO_PROP_PACKAGE_AUTHOR_NAME         "PMINFO_PKGINFO_PROP_PACKAGE_AUTHOR_NAME"
  89  /** String property for filtering based on package info*/
  90 #define PMINFO_PKGINFO_PROP_PACKAGE_AUTHOR_EMAIL                "PMINFO_PKGINFO_PROP_PACKAGE_AUTHOR_EMAIL"
  91  /** String property for filtering based on package info*/
  92 #define PMINFO_PKGINFO_PROP_PACKAGE_AUTHOR_HREF         "PMINFO_PKGINFO_PROP_PACKAGE_AUTHOR_HREF"
  93  /** String property for filtering based on package info*/
  94 #define PMINFO_PKGINFO_PROP_PACKAGE_PRIVILEGE           "PMINFO_PKGINFO_PROP_PACKAGE_PRIVILEGE"
  95
  96  /** Boolean property for filtering based on package info*/
  97 #define PMINFO_PKGINFO_PROP_PACKAGE_REMOVABLE           "PMINFO_PKGINFO_PROP_PACKAGE_REMOVABLE"
  98  /** Boolean property for filtering based on package info*/
  99 #define PMINFO_PKGINFO_PROP_PACKAGE_PRELOAD             "PMINFO_PKGINFO_PROP_PACKAGE_PRELOAD"
 100  /** Boolean property for filtering based on package info*/
 101 #define PMINFO_PKGINFO_PROP_PACKAGE_READONLY            "PMINFO_PKGINFO_PROP_PACKAGE_READONLY"
 102   /** Boolean property for filtering based on package info*/
 103 #define PMINFO_PKGINFO_PROP_PACKAGE_UPDATE              "PMINFO_PKGINFO_PROP_PACKAGE_UPDATE"
 104   /** Boolean property for filtering based on package info*/
 105 #define PMINFO_PKGINFO_PROP_PACKAGE_APPSETTING          "PMINFO_PKGINFO_PROP_PACKAGE_APPSETTING"
 106    /** Boolean property for filtering based on package info*/
 107 #define PMINFO_PKGINFO_PROP_PACKAGE_NODISPLAY_SETTING           "PMINFO_PKGINFO_PROP_PACKAGE_NODISPLAY_SETTING"
 108    /** Boolean property for filtering based on package info*/
 109 #define PMINFO_PKGINFO_PROP_PACKAGE_SUPPORT_DISABLE             "PMINFO_PKGINFO_PROP_PACKAGE_SUPPORT_DISABLE"
 110    /** Boolean property for filtering based on package info*/
 111 #define PMINFO_PKGINFO_PROP_PACKAGE_DISABLE             "PMINFO_PKGINFO_PROP_PACKAGE_DISABLE"
 112    /** Boolean property for filtering based on package info*/
 113 #define PMINFO_PKGINFO_PROP_PACKAGE_CHECK_STORAGE               "PMINFO_PKGINFO_PROP_PACKAGE_CHECK_STORAGE"
 114
 115  /** Integer property for filtering based on package info*/
 116 #define PMINFO_PKGINFO_PROP_PACKAGE_SIZE                "PMINFO_PKGINFO_PROP_PACKAGE_SIZE"
 117
 118  /** String property for filtering based on app info*/
 119 #define PMINFO_APPINFO_PROP_APP_ID              "PMINFO_APPINFO_PROP_APP_ID"
 120  /** String property for filtering based on app info*/
 121 #define PMINFO_APPINFO_PROP_APP_COMPONENT               "PMINFO_APPINFO_PROP_APP_COMPONENT"
 122  /** String property for filtering based on app info*/
 123 #define PMINFO_APPINFO_PROP_APP_EXEC            "PMINFO_APPINFO_PROP_APP_EXEC"
 124  /** String property for filtering based on app info*/
 125 #define PMINFO_APPINFO_PROP_APP_ICON            "PMINFO_APPINFO_PROP_APP_ICON"
 126  /** String property for filtering based on app info*/
 127 #define PMINFO_APPINFO_PROP_APP_TYPE            "PMINFO_APPINFO_PROP_APP_TYPE"
 128  /** String property for filtering based on app info*/
 129 #define PMINFO_APPINFO_PROP_APP_OPERATION       "PMINFO_APPINFO_PROP_APP_OPERATION"
 130  /** String property for filtering based on app info*/
 131 #define PMINFO_APPINFO_PROP_APP_URI                     "PMINFO_APPINFO_PROP_APP_URI"
 132  /** String property for filtering based on app info*/
 133 #define PMINFO_APPINFO_PROP_APP_MIME            "PMINFO_APPINFO_PROP_APP_MIME"
 134  /** String property for filtering based on app info*/
 135 #define PMINFO_APPINFO_PROP_APP_CATEGORY        "PMINFO_APPINFO_PROP_APP_CATEGORY"
 136  /** String property for filtering based on app info*/
 137 #define PMINFO_APPINFO_PROP_APP_HWACCELERATION  "PMINFO_APPINFO_PROP_APP_HWACCELERATION"
 138  /** String property for filtering based on app info*/
 139 #define PMINFO_APPINFO_PROP_APP_SCREENREADER    "PMINFO_APPINFO_PROP_APP_SCREENREADER"
 140  /** String property for filtering based on app info*/
 141 #define PMINFO_APPINFO_PROP_APP_PACKAGE         "PMINFO_APPINFO_PROP_APP_PACKAGE"
 142  /** String property for filtering based on app info*/
 143 #define PMINFO_APPINFO_PROP_APP_INSTALLED_STORAGE               "PMINFO_APPINFO_PROP_APP_INSTALLED_STORAGE"
 144
 145 /** Integer property for filtering app support mode */
 146 #define PMINFO_APPINFO_PROP_APP_SUPPORT_MODE            "PMINFO_APPINFO_PROP_APP_SUPPORT_MODE"
 147
 148  /** Boolean property for filtering based on app info*/
 149 #define PMINFO_APPINFO_PROP_APP_NODISPLAY               "PMINFO_APPINFO_PROP_APP_NODISPLAY"
 150  /** Boolean property for filtering based on app info*/
 151 #define PMINFO_APPINFO_PROP_APP_MULTIPLE                "PMINFO_APPINFO_PROP_APP_MULTIPLE"
 152  /** Boolean property for filtering based on app info*/
 153 #define PMINFO_APPINFO_PROP_APP_ONBOOT                  "PMINFO_APPINFO_PROP_APP_ONBOOT"
 154  /** Boolean property for filtering based on app info*/
 155 #define PMINFO_APPINFO_PROP_APP_AUTORESTART     "PMINFO_APPINFO_PROP_APP_AUTORESTART"
 156  /** Boolean property for filtering based on app info*/
 157 #define PMINFO_APPINFO_PROP_APP_TASKMANAGE      "PMINFO_APPINFO_PROP_APP_TASKMANAGE"
 158  /** Boolean property for filtering based on app info*/
 159 #define PMINFO_APPINFO_PROP_APP_LAUNCHCONDITION "PMINFO_APPINFO_PROP_APP_LAUNCHCONDITION"
 160  /** Boolean property for filtering based on app info*/
 161 #define PMINFO_APPINFO_PROP_APP_UI_GADGET       "PMINFO_APPINFO_PROP_APP_UI_GADGET"
 162  /** Boolean property for filtering based on app info*/
 163 #define PMINFO_APPINFO_PROP_APP_DISABLE "PMINFO_APPINFO_PROP_APP_DISABLE"
 164  /** Boolean property for filtering based on app info*/
 165 #define PMINFO_APPINFO_PROP_APP_SUPPORT_DISABLE "PMINFO_APPINFO_PROP_APP_SUPPORT_DISABLE"
 166  /** Boolean property for filtering based on app info*/
 167 #define PMINFO_APPINFO_PROP_APP_CHECK_STORAGE   "PMINFO_APPINFO_PROP_APP_CHECK_STORAGE"
 168
 169  /** will be updated*/
 170  /** string property for filtering based on pkg info*/
 171 #define PMINFO_PKGINFO_PROP_RANGE_BASIC "PMINFO_PKGINFO_PROP_RANGE_BASIC"
 172
 173 /* For multiuser support */
 174 const char *getIconPath(uid_t uid, bool readonly);
 175 char *getUserPkgParserDBPath(void);
 176 char *getUserPkgParserDBPathUID(uid_t uid);
 177 char *getUserPkgCertDBPath(void);
 178 char *getUserPkgCertDBPathUID(uid_t uid);
 179 const char *getUserManifestPath(uid_t uid, bool readonly);
 180
 181 /**
 182  * @fn  int pkgmgrinfo_pkginfo_get_list(pkgmgrinfo_pkg_list_cb pkg_list_cb, void *user_data)
 183  * @fn  int pkgmgrinfo_pkginfo_get_usr_list(pkgmgrinfo_pkg_list_cb pkg_list_cb, void *user_data, uid_t uid)
 184  * @brief       This API gets list of installed packages
 185  *
 186  * @par         This API is for package-manager client application
 187  * @par Sync (or) Async : Synchronous API
 188  * @param[in]   pkg_list_cb     iteration function for list
 189  * @param[in]   user_data       user data to be passed to callback function
 190  * @param[in]   uid     the addressee user id of the instruction
 191  * @return      0 if success, error code(<0) if fail
 192  * @retval      PMINFO_R_OK     success
 193  * @retval      PMINFO_R_EINVAL invalid argument
 194  * @retval      PMINFO_R_ERROR  internal error
 195  * @pre         None
 196  * @post        None
 197  * @code
 198 int pkg_list_cb(pkgmgrinfo_pkginfo_h handle, void *user_data)
 199 {
 200         char *pkgid1 = NULL;
 201         char *pkgid2 = NULL;
 202         pkgid1 = (char *)user_data;
 203         pkgmgrinfo_pkginfo_get_pkgid(handle, &pkgid2);
 204         if (strcmp(pkgid1, pkgid2) == 0) {
 205                 return -1;
 206         } else {
 207                 return 0;
 208         }
 209 }
 210
 211 static int list_pkgs()
 212 {
 213         int ret = 0;
 214         char *name = "helloworld";
 215         ret = pkgmgrinfo_pkginfo_get_list(pkg_list_cb, (void *)name);
 216         if (ret != PMINFO_R_OK) {
 217                 return -1;
 218         }
 219         return 0;
 220 }
 221  * @endcode
 222  */
 223 int pkgmgrinfo_pkginfo_get_list(pkgmgrinfo_pkg_list_cb pkg_list_cb, void *user_data);
 224 int pkgmgrinfo_pkginfo_get_usr_list(pkgmgrinfo_pkg_list_cb pkg_list_cb, void *user_data, uid_t uid);
 225
 226 /**
 227  * @fn  int pkgmgrinfo_pkginfo_get_disabled_list(pkgmgrinfo_pkg_list_cb pkg_list_cb, void *user_data)
 228  * @fn  int pkgmgrinfo_pkginfo_get_usr_disabled_list(pkgmgrinfo_pkg_list_cb pkg_list_cb, void *user_data, uid_t uid)
 229  * @brief       This API gets list of disabled packages
 230  *
 231  * @par         This API is for package-manager client application
 232  * @par Sync (or) Async : Synchronous API
 233  * @param[in]   pkg_list_cb     iteration function for list
 234  * @param[in]   user_data       user data to be passed to callback function
 235  * @param[in]   uid     the addressee user id of the instruction
 236  * @return      0 if success, error code(<0) if fail
 237  * @retval      PMINFO_R_OK     success
 238  * @retval      PMINFO_R_EINVAL invalid argument
 239  * @retval      PMINFO_R_ERROR  internal error
 240  * @pre         None
 241  * @post        None
 242  */
 243 int pkgmgrinfo_pkginfo_get_disabled_list(pkgmgrinfo_pkg_list_cb pkg_list_cb, void *user_data);
 244 int pkgmgrinfo_pkginfo_get_usr_disabled_list(pkgmgrinfo_pkg_list_cb pkg_list_cb, void *user_data, uid_t uid);
 245
 246 /**
 247  * @fn int pkgmgrinfo_pkginfo_get_pkginfo(const char *pkgid, pkgmgrinfo_pkginfo_h *handle)
 248  * @brief       This API creates the package information handle from db which is not disabled
 249  *
 250  * @par         This API is for package-manager client application
 251  * @par Sync (or) Async : Synchronous API
 252  *
 253  * @param[in]   pkgid   pointer to package ID
 254  * @param[in]   uid     the addressee user id of the instruction
 255  * @param[out] handle           pointer to the package info handle.
 256  * @return      0 if success, error code(<0) if fail
 257  * @retval      PMINFO_R_OK     success
 258  * @retval      PMINFO_R_EINVAL invalid argument
 259  * @retval      PMINFO_R_ERROR  internal error
 260  * @pre         None
 261  * @post                pkgmgrinfo_pkginfo_destroy_pkginfo()
 262  * @see         pkgmgrinfo_pkginfo_get_pkgid()
 263  * @see         pkgmgrinfo_pkginfo_is_removable()
 264  * @code
 265 static int get_pkg_type(const char *pkgid)
 266 {
 267         int ret = 0;
 268         char *type = NULL;
 269         pkgmgrinfo_pkginfo_h handle;
 270         ret = pkgmgrinfo_pkginfo_get_pkginfo(pkgid, &handle);
 271         if (ret != PMINFO_R_OK)
 272                 return -1;
 273         ret = pkgmgrinfo_pkginfo_get_type(handle, &type);
 274         if (ret != PMINFO_R_OK) {
 275                 pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
 276                 return -1;
 277         }
 278         printf("pkgtype: %s\n", type);
 279         pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
 280         return 0;
 281 }
 282  * @endcode
 283  */
 284 int pkgmgrinfo_pkginfo_get_pkginfo(const char *pkgid, pkgmgrinfo_pkginfo_h *handle);
 285 int pkgmgrinfo_pkginfo_get_usr_pkginfo(const char *pkgid, uid_t uid, pkgmgrinfo_pkginfo_h *handle);
 286
 287 /**
 288  * @fn int pkgmgrinfo_pkginfo_get_disabled_pkginfo(const char *pkgid, pkgmgrinfo_pkginfo_h *handle)
 289  * @brief       This API creates the disabled package information handle from db
 290  *
 291  * @par         This API is for package-manager client application
 292  * @par Sync (or) Async : Synchronous API
 293  *
 294  * @param[in]   pkgid   pointer to package ID
 295  * @param[in]   uid     the addressee user id of the instruction
 296  * @param[out] handle           pointer to the package info handle.
 297  * @return      0 if success, error code(<0) if fail
 298  * @retval      PMINFO_R_OK     success
 299  * @retval      PMINFO_R_EINVAL invalid argument
 300  * @retval      PMINFO_R_ERROR  internal error
 301  * @pre         None
 302  * @post                pkgmgrinfo_pkginfo_destroy_pkginfo()
 303  * @see         pkgmgrinfo_pkginfo_get_pkginfo()
 304  */
 305 int pkgmgrinfo_pkginfo_get_disabled_pkginfo(const char *pkgid, pkgmgrinfo_pkginfo_h *handle);
 306 int pkgmgrinfo_pkginfo_get_usr_disabled_pkginfo(const char *pkgid, uid_t uid, pkgmgrinfo_pkginfo_h *handle);
 307
 308 /**
 309  * @fn int pkgmgrinfo_pkginfo_get_all_pkginfo(const char *pkgid, pkgmgrinfo_pkginfo_h *handle)
 310  * @brief       This API creates the package information handle from db regardless of its disable or storage status
 311  *
 312  * @par         This API is for package-manager client application
 313  * @par Sync (or) Async : Synchronous API
 314  *
 315  * @param[in]   pkgid   pointer to package ID
 316  * @param[in]   uid     the addressee user id of the instruction
 317  * @param[out] handle           pointer to the package info handle.
 318  * @return      0 if success, error code(<0) if fail
 319  * @retval      PMINFO_R_OK     success
 320  * @retval      PMINFO_R_EINVAL invalid argument
 321  * @retval      PMINFO_R_ERROR  internal error
 322  * @pre         None
 323  * @post                pkgmgrinfo_pkginfo_destroy_pkginfo()
 324  * @see         pkgmgrinfo_pkginfo_get_pkgid()
 325  * @see         pkgmgrinfo_pkginfo_is_removable()
 326  * @code
 327 static int get_pkg_type(const char *pkgid)
 328 {
 329         int ret = 0;
 330         char *type = NULL;
 331         pkgmgrinfo_pkginfo_h handle;
 332         ret = pkgmgrinfo_pkginfo_get_all_pkginfo(pkgid, &handle);
 333         if (ret != PMINFO_R_OK)
 334                 return -1;
 335         ret = pkgmgrinfo_pkginfo_get_type(handle, &type);
 336         if (ret != PMINFO_R_OK) {
 337                 pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
 338                 return -1;
 339         }
 340         printf("pkgtype: %s\n", type);
 341         pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
 342         return 0;
 343 }
 344  * @endcode
 345  */
 346 int pkgmgrinfo_pkginfo_get_all_pkginfo(const char *pkgid, pkgmgrinfo_pkginfo_h *handle);
 347 int pkgmgrinfo_pkginfo_get_usr_all_pkginfo(const char *pkgid, uid_t uid, pkgmgrinfo_pkginfo_h *handle);
 348
 349 /**
 350  * @fn int pkgmgrinfo_pkginfo_get_pkgname(pkgmgrinfo_pkginfo_h handle, char **pkg_name)
 351  * @brief       This API gets the package name from the package ID
 352  *
 353  * @par         This API is for package-manager client application
 354  * @par Sync (or) Async : Synchronous API
 355  *
 356  * @param[in]   handle  pointer to package info handle
 357  * @param[out]  pkg_name        pointer to hold package name
 358  * @return      0 if success, error code(<0) if fail
 359  * @retval      PMINFO_R_OK     success
 360  * @retval      PMINFO_R_EINVAL invalid argument
 361  * @retval      PMINFO_R_ERROR  internal error
 362  * @pre         pkgmgrinfo_pkginfo_get_pkginfo()
 363  * @post                pkgmgrinfo_pkginfo_destroy_pkginfo()
 364  * @see         pkgmgrinfo_pkginfo_get_type()
 365  * @see         pkgmgrinfo_pkginfo_is_removable()
 366  * @code
 367 static int get_pkg_name(const char *pkgid)
 368 {
 369         int ret = 0;
 370         char *pkgname = NULL;
 371         pkgmgrinfo_pkginfo_h handle;
 372         ret = pkgmgrinfo_pkginfo_get_pkginfo(pkgid, &handle);
 373         if (ret != PMINFO_R_OK)
 374                 return -1;
 375         ret = pkgmgrinfo_pkginfo_get_pkgname(handle, &pkgname);
 376         if (ret != PMINFO_R_OK) {
 377                 pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
 378                 return -1;
 379         }
 380         printf("pkgname: %s\n", pkgname);
 381         pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
 382         return 0;
 383 }
 384  * @endcode
 385  */
 386 int pkgmgrinfo_pkginfo_get_pkgname(pkgmgrinfo_pkginfo_h handle, char **pkg_name);
 387
 388 /**
 389  * @fn int pkgmgrinfo_pkginfo_get_pkgid(pkgmgrinfo_pkginfo_h handle, char **pkgid)
 390  * @brief       This API gets the package id from the package ID
 391  *
 392  * @par         This API is for package-manager client application
 393  * @par Sync (or) Async : Synchronous API
 394  *
 395  * @param[in]   handle  pointer to package info handle
 396  * @param[out]  pkgid   pointer to hold package id
 397  * @return      0 if success, error code(<0) if fail
 398  * @retval      PMINFO_R_OK     success
 399  * @retval      PMINFO_R_EINVAL invalid argument
 400  * @retval      PMINFO_R_ERROR  internal error
 401  * @pre         pkgmgrinfo_pkginfo_get_pkginfo()
 402  * @post                pkgmgrinfo_pkginfo_destroy_pkginfo()
 403  * @see         pkgmgrinfo_pkginfo_get_type()
 404  * @see         pkgmgrinfo_pkginfo_is_removable()
 405  * @code
 406 static int get_pkgid(const char *pkgid)
 407 {
 408         int ret = 0;
 409         char *pkg_id = NULL;
 410         pkgmgrinfo_pkginfo_h handle;
 411         ret = pkgmgrinfo_pkginfo_get_pkginfo(pkgid, &handle);
 412         if (ret != PMINFO_R_OK)
 413                 return -1;
 414         ret = pkgmgrinfo_pkginfo_get_pkgid(handle, &pkg_id);
 415         if (ret != PMINFO_R_OK) {
 416                 pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
 417                 return -1;
 418         }
 419         printf("pkg id: %s\n", pkg_id);
 420         pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
 421         return 0;
 422 }
 423  * @endcode
 424  */
 425 int pkgmgrinfo_pkginfo_get_pkgid(pkgmgrinfo_pkginfo_h handle, char **pkgid);
 426
 427 /**
 428  * @fn int pkgmgrinfo_pkginfo_get_type(pkgmgrinfo_pkginfo_h handle, char **type)
 429  * @brief       This API gets the package type from the package ID
 430  *
 431  * @par         This API is for package-manager client application
 432  * @par Sync (or) Async : Synchronous API
 433  *
 434  * @param[in]   handle  pointer to package info handle
 435  * @param[out] type             pointer to hold package type
 436  * @return      0 if success, error code(<0) if fail
 437  * @retval      PMINFO_R_OK     success
 438  * @retval      PMINFO_R_EINVAL invalid argument
 439  * @retval      PMINFO_R_ERROR  internal error
 440  * @pre         pkgmgrinfo_pkginfo_get_pkginfo()
 441  * @post                pkgmgrinfo_pkginfo_destroy_pkginfo()
 442  * @see         pkgmgrinfo_pkginfo_get_pkgid()
 443  * @see         pkgmgrinfo_pkginfo_is_removable()
 444  * @code
 445 static int get_pkg_type(const char *pkgid)
 446 {
 447         int ret = 0;
 448         char *type = NULL;
 449         pkgmgrinfo_pkginfo_h handle;
 450         ret = pkgmgrinfo_pkginfo_get_pkginfo(pkgid, &handle);
 451         if (ret != PMINFO_R_OK)
 452                 return -1;
 453         ret = pkgmgrinfo_pkginfo_get_type(handle, &type);
 454         if (ret != PMINFO_R_OK) {
 455                 pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
 456                 return -1;
 457         }
 458         printf("pkgtype: %s\n", type);
 459         pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
 460         return 0;
 461 }
 462  * @endcode
 463  */
 464 int pkgmgrinfo_pkginfo_get_type(pkgmgrinfo_pkginfo_h handle, char **type);
 465
 466 /**
 467  * @fn int pkgmgrinfo_pkginfo_get_version(pkgmgrinfo_pkginfo_h handle, char **version)
 468  * @brief       This API gets the package version from the package ID
 469  *
 470  * @par         This API is for package-manager client application
 471  * @par Sync (or) Async : Synchronous API
 472  *
 473  * @param[in]   handle  pointer to package info handle
 474  * @param[out] version          pointer to hold package version
 475  * @return      0 if success, error code(<0) if fail
 476  * @retval      PMINFO_R_OK     success
 477  * @retval      PMINFO_R_EINVAL invalid argument
 478  * @retval      PMINFO_R_ERROR  internal error
 479  * @pre         pkgmgrinfo_pkginfo_get_pkginfo()
 480  * @post                pkgmgrinfo_pkginfo_destroy_pkginfo()
 481  * @see         pkgmgrinfo_pkginfo_get_pkgid()
 482  * @see         pkgmgrinfo_pkginfo_is_removable()
 483  * @code
 484 static int get_pkg_version(const char *pkgid)
 485 {
 486         int ret = 0;
 487         char *version = NULL;
 488         pkgmgrinfo_pkginfo_h handle;
 489         ret = pkgmgrinfo_pkginfo_get_pkginfo(pkgid, &handle);
 490         if (ret != PMINFO_R_OK)
 491                 return -1;
 492         ret = pkgmgrinfo_pkginfo_get_version(handle, &version);
 493         if (ret != PMINFO_R_OK) {
 494                 pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
 495                 return -1;
 496         }
 497         printf("pkg version: %s\n", version);
 498         pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
 499         return 0;
 500 }
 501  * @endcode
 502  */
 503 int pkgmgrinfo_pkginfo_get_version(pkgmgrinfo_pkginfo_h handle, char **version);
 504
 505 /**
 506  * @fn int pkgmgrinfo_pkginfo_get_api_version(pkgmgrinfo_pkginfo_h handle, char **api_version)
 507  * @brief       This API gets the package api_version from the package ID
 508  *
 509  * @par         This API is for package-manager client application
 510  * @par Sync (or) Async : Synchronous API
 511  *
 512  * @param[in]   handle  pointer to package info handle
 513  * @param[out] api_version              pointer to hold package api_version
 514  * @return      0 if success, error code(<0) if fail
 515  * @retval      PMINFO_R_OK     success
 516  * @retval      PMINFO_R_EINVAL invalid argument
 517  * @retval      PMINFO_R_ERROR  internal error
 518  * @pre         pkgmgrinfo_pkginfo_get_pkginfo()
 519  * @post                pkgmgrinfo_pkginfo_destroy_pkginfo()
 520  * @see         pkgmgrinfo_pkginfo_get_pkgid()
 521  * @see         pkgmgrinfo_pkginfo_is_removable()
 522  * @code
 523 static int get_pkg_api_version(const char *pkgid)
 524 {
 525         int ret = 0;
 526         char *api_version = NULL;
 527         pkgmgrinfo_pkginfo_h handle = NULL;
 528         ret = pkgmgrinfo_pkginfo_get_pkginfo(pkgid, &handle);
 529         if (ret != PMINFO_R_OK)
 530                 return -1;
 531         ret = pkgmgrinfo_pkginfo_get_api_version(handle, &api_version);
 532         if (ret != PMINFO_R_OK) {
 533                 pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
 534                 return -1;
 535         }
 536         printf("pkg api_version: %s\n", api_version);
 537         pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
 538         return 0;
 539 }
 540  * @endcode
 541  */
 542 int pkgmgrinfo_pkginfo_get_api_version(pkgmgrinfo_pkginfo_h handle, char **api_version);
 543
 544 /**
 545  * @fn int pkgmgrinfo_pkginfo_get_tep_name(pkgmgrinfo_pkginfo_h handle, char **tep_name)
 546  * @brief       This API gets tep(tizen expansion package) file name associated with the package
 547  *
 548  * @par This API is for package-manager client application
 549  * @par Sync (or) Async : Synchronous API
 550  *
 551  * @param[in] handle    pointer to the pkginfo handle.
 552  * @param[out] tep_name pointer to hold tep name
 553  * @return      0 if success, error code(<0) if fail
 554  * @retval      PMINFO_R_OK success
 555  * @retval      PMINFO_R_EINVAL invalid argument
 556  * @retval      PMINFO_R_ERROR  internal error
 557  * @pre         pkgmgrinfo_pkginfo_get_pkginfo()
 558  * @post        pkgmgrinfo_pkginfo_destroy_pkginfo()
 559  * @see pkgmgrinfo_pkginfo_get_pkgid()
 560  * @code
 561 static int get_tep_name(const char *pkgid)
 562 {
 563         int ret = 0;
 564         char *tep_name = NULL;
 565         pkgmgrinfo_pkginfo_h handle = NULL;
 566         ret = pkgmgrinfo_pkginfo_get_pkginfo(pkgid, &handle);
 567         if (ret != PMINFO_R_OK)
 568                 return -1;
 569         ret = pkgmgrinfo_pkginfo_get_tep_name(handle, &tep_name);
 570         if (ret != PMINFO_R_OK) {
 571                 pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
 572                 return -1;
 573         }
 574         printf("TEP name is: %s\n", tep_name);
 575         pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
 576         return 0;
 577 }
 578  * @endcode
 579  */
 580 int pkgmgrinfo_pkginfo_get_tep_name(pkgmgrinfo_pkginfo_h handle, char **tep_name);
 581
 582 /**
 583  * @fn int pkgmgrinfo_pkginfo_get_zip_mount_file(pkgmgrinfo_pkginfo_h handle, char **zip_mount_file)
 584  * @brief       This API gets package mount point path associated with the package
 585  *                      if package is mount-installed. Otherwise, zip_mount_file is left as NULL value
 586  *
 587  * @par This API is for package-manager client application
 588  * @par Sync (or) Async : Synchronous API
 589  *
 590  * @param[in] handle    pointer to the pkginfo handle.
 591  * @param[out] zip_mount_file   pointer to hold zip mount file
 592  * @return      0 if success, error code(<0) if fail
 593  * @retval      PMINFO_R_OK success
 594  * @retval      PMINFO_R_EINVAL invalid argument
 595  * @retval      PMINFO_R_ERROR  internal error
 596  * @pre pkgmgrinfo_pkginfo_get_pkginfo()
 597  * @post        pkgmgrinfo_pkginfo_destroy_pkginfo()
 598  * @see pkgmgrinfo_pkginfo_get_pkgid()
 599  * @code
 600 static int get_zip_mount_file(const char *pkgid)
 601 {
 602         int ret = 0;
 603         char *zip_mount_file = NULL;
 604         pkgmgrinfo_pkginfo_h handle = NULL;
 605         ret = pkgmgrinfo_pkginfo_get_pkginfo(pkgid, &handle);
 606         if (ret != PMINFO_R_OK)
 607                 return -1;
 608         ret = pkgmgrinfo_pkginfo_get_zip_mount_file(handle, &zip_mount_file);
 609         if (ret != PMINFO_R_OK) {
 610                 pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
 611                 return -1;
 612         }
 613         if (zip_mount_file != NULL)
 614                 printf("Zip mount path is: %s\n", zip_mount_file);
 615         pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
 616         return 0;
 617 }
 618  * @endcode
 619  */
 620 int pkgmgrinfo_pkginfo_get_zip_mount_file(pkgmgrinfo_pkginfo_h handle, char **zip_mount_file);
 621
 622 /**
 623  * @fn int pkgmgrinfo_pkginfo_get_external_image_path(pkgmgrinfo_pkginfo_h handle, char **ext_image_path)
 624  * @brief       This API gets package external image path associated with the package
 625  *                      if package is installed in external storage.
 626  *                      Otherwise, the return value will be PMINFO_R_ENOENT.
 627  *
 628  * @par This API is for package-manager client application
 629  * @par Sync (or) Async : Synchronous API
 630  *
 631  * @param[in] handle    pointer to the pkginfo handle.
 632  * @param[out] ext_image_path   pointer to hold external image path
 633  * @return      0 if success, error code(<0) if fail
 634  * @retval      PMINFO_R_OK success
 635  * @retval      PMINFO_R_EINVAL invalid argument
 636  * @retval      PMINFO_R_ERROR  internal error
 637  * @revall      PMINFO_R_ENOENT no valid data
 638  * @pre pkgmgrinfo_pkginfo_get_pkginfo()
 639  * @post        pkgmgrinfo_pkginfo_destroy_pkginfo()
 640  * @see pkgmgrinfo_pkginfo_get_pkgid()
 641  * @code
 642 static int get_external_image_path(const char *pkgid)
 643 {
 644         int ret = 0;
 645         char *ext_image_path = NULL;
 646         pkgmgrinfo_pkginfo_h handle = NULL;
 647         ret = pkgmgrinfo_pkginfo_get_pkginfo(pkgid, &handle);
 648         if (ret != PMINFO_R_OK)
 649                 return -1;
 650         ret = pkgmgrinfo_pkginfo_get_external_image_path(handle, &ext_image_path);
 651         if (ret != PMINFO_R_OK) {
 652                 pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
 653                 return -1;
 654         }
 655         printf("external image path is: %s\n", ext_image_path);
 656         pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
 657         return 0;
 658 }
 659  * @endcode
 660  */
 661 int pkgmgrinfo_pkginfo_get_external_image_path(pkgmgrinfo_pkginfo_h handle, char **ext_image_path);
 662
 663 /**
 664  * @fn int pkgmgrinfo_pkginfo_get_install_location(pkgmgrinfo_pkginfo_h handle, pkgmgrinfo_install_location *location)
 665  * @brief       This API gets the package install location from the package ID
 666  *
 667  * @par         This API is for package-manager client application
 668  * @par Sync (or) Async : Synchronous API
 669  *
 670  * @param[in] handle    pointer to package info handle
 671  * @param[out] location         pointer to hold package install location
 672  * @return      0 if success, error code(<0) if fail
 673  * @retval      PMINFO_R_OK     success
 674  * @retval      PMINFO_R_EINVAL invalid argument
 675  * @retval      PMINFO_R_ERROR  internal error
 676  * @pre         pkgmgrinfo_pkginfo_get_pkginfo()
 677  * @post                pkgmgrinfo_pkginfo_destroy_pkginfo()
 678  * @see         pkgmgrinfo_pkginfo_get_pkgid()
 679  * @see         pkgmgrinfo_pkginfo_is_removable()
 680  * @code
 681 static int get_pkg_install_location(const char *pkgid)
 682 {
 683         int ret = 0;
 684         pkgmgrinfo_install_location location;
 685         pkgmgrinfo_pkginfo_h handle;
 686         ret = pkgmgrinfo_pkginfo_get_pkginfo(pkgid, &handle);
 687         if (ret != PMINFO_R_OK)
 688                 return -1;
 689         ret = pkgmgrinfo_pkginfo_get_install_location(handle, &location);
 690         if (ret != PMINFO_R_OK) {
 691                 pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
 692                 return -1;
 693         }
 694         printf("pkg install location: %d\n", location);
 695         pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
 696         return 0;
 697 }
 698  * @endcode
 699  */
 700 int pkgmgrinfo_pkginfo_get_install_location(pkgmgrinfo_pkginfo_h handle, pkgmgrinfo_install_location *location);
 701
 702 /**
 703  * @fn int pkgmgrinfo_pkginfo_get_package_size(pkgmgrinfo_pkginfo_h handle, int *size)
 704  * @brief       This API gets the package size from the package ID. size will be 0 if package install location is internal-only.
 705  size will be 0 if package install location is prefer-external but size is not specified in manifest file.Application should check
 706  the return value of pkgmgrinfo_pkginfo_get_install_location() and use it to distinguish the above cases.
 707  *
 708  * @par         This API is for package-manager client application
 709  * @par Sync (or) Async : Synchronous API
 710  *
 711  * @param[in]   handle  pointer to package info handle
 712  * @param[out] size             pointer to hold package size
 713  * @return      0 if success, error code(<0) if fail
 714  * @retval      PMINFO_R_OK     success
 715  * @retval      PMINFO_R_EINVAL invalid argument
 716  * @retval      PMINFO_R_ERROR  internal error
 717  * @pre         pkgmgrinfo_pkginfo_get_pkginfo()
 718  * @post                pkgmgrinfo_pkginfo_destroy_pkginfo()
 719  * @see         pkgmgrinfo_pkginfo_get_pkgid()
 720  * @see         pkgmgrinfo_pkginfo_is_removable()
 721  * @code
 722 static int get_pkg_size(const char *pkgid)
 723 {
 724         int ret = 0;
 725         int size = 0;
 726         pkgmgrinfo_pkginfo_h handle;
 727         ret = pkgmgrinfo_pkginfo_get_pkginfo(pkgid, &handle);
 728         if (ret != PMINFO_R_OK)
 729                 return -1;
 730         ret = pkgmgrinfo_pkginfo_get_package_size(handle, &size);
 731         if (ret != PMINFO_R_OK) {
 732                 pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
 733                 return -1;
 734         }
 735         printf("pkgsize: %d\n", size);
 736         pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
 737         return 0;
 738 }
 739  * @endcode
 740  */
 741 int pkgmgrinfo_pkginfo_get_package_size(pkgmgrinfo_pkginfo_h handle, int *size);
 742
 743 /**
 744  * @fn int pkgmgrinfo_pkginfo_get_icon(pkgmgrinfo_pkginfo_h handle, char **icon)
 745  * @brief       This API gets the package icon from the package ID
 746  *
 747  * @par         This API is for package-manager client application
 748  * @par Sync (or) Async : Synchronous API
 749  *
 750  * @param[in]   handle  pointer to package info handle
 751  * @param[out] icon             pointer to hold package icon
 752  * @return      0 if success, error code(<0) if fail
 753  * @retval      PMINFO_R_OK     success
 754  * @retval      PMINFO_R_EINVAL invalid argument
 755  * @retval      PMINFO_R_ERROR  internal error
 756  * @pre         pkgmgrinfo_pkginfo_get_pkginfo()
 757  * @post                pkgmgrinfo_pkginfo_destroy_pkginfo()
 758  * @see         pkgmgrinfo_pkginfo_get_pkgid()
 759  * @see         pkgmgrinfo_pkginfo_is_removable()
 760  * @code
 761 static int get_pkg_icon(const char *pkgid)
 762 {
 763         int ret = 0;
 764         char *icon = NULL;
 765         pkgmgrinfo_pkginfo_h handle;
 766         ret = pkgmgrinfo_pkginfo_get_pkginfo(pkgid, &handle);
 767         if (ret != PMINFO_R_OK)
 768                 return -1;
 769         ret = pkgmgrinfo_pkginfo_get_icon(handle, &icon);
 770         if (ret != PMINFO_R_OK) {
 771                 pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
 772                 return -1;
 773         }
 774         printf("pkg icon: %s\n", icon);
 775         pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
 776         return 0;
 777 }
 778  * @endcode
 779  */
 780 int pkgmgrinfo_pkginfo_get_icon(pkgmgrinfo_pkginfo_h handle, char **icon);
 781
 782 /**
 783  * @fn int pkgmgrinfo_pkginfo_get_label(pkgmgrinfo_pkginfo_h handle, char **label)
 784  * @brief       This API gets the package label from the package ID
 785  *
 786  * @par         This API is for package-manager client application
 787  * @par Sync (or) Async : Synchronous API
 788  *
 789  * @param[in]   handle  pointer to package info handle
 790  * @param[out] label            pointer to hold package label
 791  * @return      0 if success, error code(<0) if fail
 792  * @retval      PMINFO_R_OK     success
 793  * @retval      PMINFO_R_EINVAL invalid argument
 794  * @retval      PMINFO_R_ERROR  internal error
 795  * @pre         pkgmgrinfo_pkginfo_get_pkginfo()
 796  * @post                pkgmgrinfo_pkginfo_destroy_pkginfo()
 797  * @see         pkgmgrinfo_pkginfo_get_pkgid()
 798  * @see         pkgmgrinfo_pkginfo_is_removable()
 799  * @code
 800 static int get_pkg_label(const char *pkgid)
 801 {
 802         int ret = 0;
 803         char *label = NULL;
 804         pkgmgrinfo_pkginfo_h handle;
 805         ret = pkgmgrinfo_pkginfo_get_pkginfo(pkgid, &handle);
 806         if (ret != PMINFO_R_OK)
 807                 return -1;
 808         ret = pkgmgrinfo_pkginfo_get_label(handle, &label);
 809         if (ret != PMINFO_R_OK) {
 810                 pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
 811                 return -1;
 812         }
 813         printf("pkg label: %s\n", label);
 814         pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
 815         return 0;
 816 }
 817  * @endcode
 818  */
 819 int pkgmgrinfo_pkginfo_get_label(pkgmgrinfo_pkginfo_h handle, char **label);
 820
 821 /**
 822  * @fn int pkgmgrinfo_pkginfo_get_description(pkgmgrinfo_pkginfo_h handle, char **description)
 823  * @brief       This API gets the package description from the package ID
 824  *
 825  * @par         This API is for package-manager client application
 826  * @par Sync (or) Async : Synchronous API
 827  *
 828  * @param[in]   handle  pointer to package info handle
 829  * @param[out] description              pointer to hold package description
 830  * @return      0 if success, error code(<0) if fail
 831  * @retval      PMINFO_R_OK     success
 832  * @retval      PMINFO_R_EINVAL invalid argument
 833  * @retval      PMINFO_R_ERROR  internal error
 834  * @pre         pkgmgrinfo_pkginfo_get_pkginfo()
 835  * @post                pkgmgrinfo_pkginfo_destroy_pkginfo()
 836  * @see         pkgmgrinfo_pkginfo_get_pkgid()
 837  * @see         pkgmgrinfo_pkginfo_is_removable()
 838  * @code
 839 static int get_pkg_description(const char *pkgid)
 840 {
 841         int ret = 0;
 842         char *description = NULL;
 843         pkgmgrinfo_pkginfo_h handle;
 844         ret = pkgmgrinfo_pkginfo_get_pkginfo(pkgid, &handle);
 845         if (ret != PMINFO_R_OK)
 846                 return -1;
 847         ret = pkgmgrinfo_pkginfo_get_description(handle, &description);
 848         if (ret != PMINFO_R_OK) {
 849                 pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
 850                 return -1;
 851         }
 852         printf("pkg description: %s\n", description);
 853         pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
 854         return 0;
 855 }
 856  * @endcode
 857  */
 858 int pkgmgrinfo_pkginfo_get_description(pkgmgrinfo_pkginfo_h handle, char **description);
 859
 860 /**
 861  * @fn int pkgmgrinfo_pkginfo_get_author_name(pkgmgrinfo_pkginfo_h handle, char **author_name)
 862  * @brief       This API gets the package's author name from the package ID
 863  *
 864  * @par         This API is for package-manager client application
 865  * @par Sync (or) Async : Synchronous API
 866  *
 867  * @param[in]   handle  pointer to package info handle
 868  * @param[out] author_name              pointer to hold package author name
 869  * @return      0 if success, error code(<0) if fail
 870  * @retval      PMINFO_R_OK     success
 871  * @retval      PMINFO_R_EINVAL invalid argument
 872  * @retval      PMINFO_R_ERROR  internal error
 873  * @pre         pkgmgrinfo_pkginfo_get_pkginfo()
 874  * @post                pkgmgrinfo_pkginfo_destroy_pkginfo()
 875  * @see         pkgmgrinfo_pkginfo_get_pkgid()
 876  * @see         pkgmgrinfo_pkginfo_is_removable()
 877  * @code
 878 static int get_pkg_author_name(const char *pkgid)
 879 {
 880         int ret = 0;
 881         char *author_name = NULL;
 882         pkgmgrinfo_pkginfo_h handle;
 883         ret = pkgmgrinfo_pkginfo_get_pkginfo(pkgid, &handle);
 884         if (ret != PMINFO_R_OK)
 885                 return -1;
 886         ret = pkgmgrinfo_pkginfo_get_author_name(handle, &author_name);
 887         if (ret != PMINFO_R_OK) {
 888                 pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
 889                 return -1;
 890         }
 891         printf("pkg author name: %s\n", author_name);
 892         pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
 893         return 0;
 894 }
 895  * @endcode
 896  */
 897 int pkgmgrinfo_pkginfo_get_author_name(pkgmgrinfo_pkginfo_h handle, char **author_name);
 898
 899 /**
 900  * @fn int pkgmgrinfo_pkginfo_get_author_email(pkgmgrinfo_pkginfo_h handle, char **author_email)
 901  * @brief       This API gets the package's author email from the package ID
 902  *
 903  * @par         This API is for package-manager client application
 904  * @par Sync (or) Async : Synchronous API
 905  *
 906  * @param[in]   handle  pointer to package info handle
 907  * @param[out] author_email             pointer to hold package author email
 908  * @return      0 if success, error code(<0) if fail
 909  * @retval      PMINFO_R_OK     success
 910  * @retval      PMINFO_R_EINVAL invalid argument
 911  * @retval      PMINFO_R_ERROR  internal error
 912  * @pre         pkgmgrinfo_pkginfo_get_pkginfo()
 913  * @post                pkgmgrinfo_pkginfo_destroy_pkginfo()
 914  * @see         pkgmgrinfo_pkginfo_get_pkgid()
 915  * @see         pkgmgrinfo_pkginfo_is_removable()
 916  * @code
 917 static int get_pkg_author_email(const char *pkgid)
 918 {
 919         int ret = 0;
 920         char *author_email = NULL;
 921         pkgmgrinfo_pkginfo_h handle;
 922         ret = pkgmgrinfo_pkginfo_get_pkginfo(pkgid, &handle);
 923         if (ret != PMINFO_R_OK)
 924                 return -1;
 925         ret = pkgmgrinfo_pkginfo_get_author_email(handle, &author_email);
 926         if (ret != PMINFO_R_OK) {
 927                 pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
 928                 return -1;
 929         }
 930         printf("pkg author email: %s\n", author_email);
 931         pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
 932         return 0;
 933 }
 934  * @endcode
 935  */
 936 int pkgmgrinfo_pkginfo_get_author_email(pkgmgrinfo_pkginfo_h handle, char **author_email);
 937
 938 /**
 939  * @fn int pkgmgrinfo_pkginfo_get_author_href(pkgmgrinfo_pkginfo_h handle, char **author_href)
 940  * @brief       This API gets the package's author href from the package ID
 941  *
 942  * @par         This API is for package-manager client application
 943  * @par Sync (or) Async : Synchronous API
 944  *
 945  * @param[in]   handle  pointer to package info handle
 946  * @param[out] author_href              pointer to hold package author href
 947  * @return      0 if success, error code(<0) if fail
 948  * @retval      PMINFO_R_OK     success
 949  * @retval      PMINFO_R_EINVAL invalid argument
 950  * @retval      PMINFO_R_ERROR  internal error
 951  * @pre         pkgmgrinfo_pkginfo_get_pkginfo()
 952  * @post                pkgmgrinfo_pkginfo_destroy_pkginfo()
 953  * @see         pkgmgrinfo_pkginfo_get_pkgid()
 954  * @see         pkgmgrinfo_pkginfo_is_removable()
 955  * @code
 956 static int get_pkg_author_href(const char *pkgid)
 957 {
 958         int ret = 0;
 959         char *author_href = NULL;
 960         pkgmgrinfo_pkginfo_h handle;
 961         ret = pkgmgrinfo_pkginfo_get_pkginfo(pkgid, &handle);
 962         if (ret != PMINFO_R_OK)
 963                 return -1;
 964         ret = pkgmgrinfo_pkginfo_get_author_href(handle, &author_href);
 965         if (ret != PMINFO_R_OK) {
 966                 pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
 967                 return -1;
 968         }
 969         printf("pkg author href: %s\n", author_href);
 970         pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
 971         return 0;
 972 }
 973  * @endcode
 974  */
 975 int pkgmgrinfo_pkginfo_get_author_href(pkgmgrinfo_pkginfo_h handle, char **author_href);
 976
 977 /**
 978  * @fn int pkgmgrinfo_pkginfo_get_installed_storage(pkgmgrinfo_pkginfo_h handle, pkgmgrinfo_installed_storage *storage)
 979  * @brief       This API gets the package installed storagae value from the package ID
 980  *
 981  * @par         This API is for package-manager client application
 982  * @par Sync (or) Async : Synchronous API
 983  *
 984  * @param[in]   handle  pointer to package info handle
 985  * @param[out] storage          pointer to hold package installed storage
 986  * @return      0 if success, error code(<0) if fail
 987  * @retval      PMINFO_R_OK     success
 988  * @retval      PMINFO_R_EINVAL invalid argument
 989  * @retval      PMINFO_R_ERROR  internal error
 990  * @pre         pkgmgrinfo_pkginfo_get_pkginfo()
 991  * @post                pkgmgrinfo_pkginfo_destroy_pkginfo()
 992  * @see         pkgmgrinfo_pkginfo_get_pkgid()
 993  * @see         pkgmgrinfo_pkginfo_is_removable()
 994  * @code
 995 static int get_pkg_installed_storage(const char *pkgid)
 996 {
 997         int ret = 0;
 998         pkgmgrinfo_installed_storage storage;
 999         pkgmgrinfo_pkginfo_h handle;
1000         ret = pkgmgrinfo_pkginfo_get_pkginfo(pkgid, &handle);
1001         if (ret != PMINFO_R_OK)
1002                 return -1;
1003         ret = pkgmgrinfo_pkginfo_get_installed_storage(handle, &storage);
1004         if (ret != PMINFO_R_OK) {
1005                 pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
1006                 return -1;
1007         }
1008         printf("pkg installed storage: %d\n", storage);
1009         pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
1010         return 0;
1011 }
1012  * @endcode
1013  */
1014 int pkgmgrinfo_pkginfo_get_installed_storage(pkgmgrinfo_pkginfo_h handle, pkgmgrinfo_installed_storage *storage);
1015
1016 /**
1017  * @fn int pkgmgrinfo_pkginfo_get_installed_time(pkgmgrinfo_pkginfo_h handle, int *installed_time)
1018  * @brief       This API gets the installed time of package from the package ID
1019  *
1020  * @par         This API is for package-manager client application
1021  * @par Sync (or) Async : Synchronous API
1022  *
1023  * @param[in]   handle  pointer to package info handle
1024  * @param[out] installed_time           pointer to hold installed time of package
1025  * @return      0 if success, error code(<0) if fail
1026  * @retval      PMINFO_R_OK     success
1027  * @retval      PMINFO_R_EINVAL invalid argument
1028  * @retval      PMINFO_R_ERROR  internal error
1029  * @pre         pkgmgrinfo_pkginfo_get_pkginfo()
1030  * @post                pkgmgrinfo_pkginfo_destroy_pkginfo()
1031  * @see         pkgmgrinfo_pkginfo_get_pkgid()
1032  * @see         pkgmgrinfo_pkginfo_is_removable()
1033  * @code
1034 static int get_pkg_installed_time(const char *pkgid)
1035 {
1036         int ret = 0;
1037         int installed_time = 0;
1038         pkgmgrinfo_pkginfo_h handle;
1039         ret = pkgmgrinfo_pkginfo_get_pkginfo(pkgid, &handle);
1040         if (ret != PMINFO_R_OK)
1041                 return -1;
1042         ret = pkgmgrinfo_pkginfo_get_installed_time(handle, &installed_time);
1043         if (ret != PMINFO_R_OK) {
1044                 pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
1045                 return -1;
1046         }
1047         printf("installed_time: %d\n", installed_time);
1048         pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
1049         return 0;
1050 }
1051  * @endcode
1052  */
1053 int pkgmgrinfo_pkginfo_get_installed_time(pkgmgrinfo_pkginfo_h handle, int *installed_time);
1054
1055 /**
1056  * @fn int pkgmgrinfo_updateinfo_create(pkgmgrinfo_updateinfo_h *update_handle)
1057  * @brief       This API creates the update info handle
1058  *
1059  * @par         This API is for package-manager client application
1060  * @par Sync (or) Async : Synchronous API
1061  *
1062  * @param[out]  handle  pointer to package update info handle
1063  * @return      0 if success, error code(<0) if fail
1064  * @retval      PMINFO_R_OK     success
1065  * @retval      PMINFO_R_EINVAL invalid argument
1066  * @retval      PMINFO_R_ERROR  internal error
1067  * @post        pkgmgrinfo_updateinfo_destroy()
1068  * @see         pkgmgrinfo_updateinfo_set_pkgid()
1069  * @see         pkgmgrinfo_updateinfo_set_version()
1070  * @see         pkgmgrinfo_updateinfo_set_type()
1071  * @see         pkgmgr_client_register_pkg_updateinfo()
1072  * @code
1073 static int updateinfo_handle_create()
1074 {
1075         int ret = 0;
1076
1077         pkgmgrinfo_updateinfo_h handle;
1078         ret = pkgmgrinfo_updateinfo_create(&handle);
1079         if (ret != PMINFO_R_OK)
1080                 return -1;
1081         pkgmgrinfo_update_infodestroy(handle);
1082         return 0;
1083 }
1084  * @endcode
1085  */
1086 int pkgmgrinfo_updateinfo_create(pkgmgrinfo_updateinfo_h *update_handle);
1087
1088 /**
1089  * @fn int pkgmgrinfo_updateinfo_destroy(pkgmgrinfo_updateinfo_h update_handle)
1090  * @brief       This API destroy the update info handle
1091  *
1092  * @par         This API is for package-manager client application
1093  * @par Sync (or) Async : Synchronous API
1094  *
1095  * @param[in]   handle  pointer to package update info handle
1096  * @return      0 if success, error code(<0) if fail
1097  * @retval      PMINFO_R_OK     success
1098  * @retval      PMINFO_R_EINVAL invalid argument
1099  * @pre         pkgmgrinfo_updateinfo_create()
1100  * @see         pkgmgr_client_register_pkg_updateinfo()
1101  * @code
1102 static int updateinfo_handle_destroy(pkgmgrinfo_updateinfo_h handle)
1103 {
1104         int ret = 0;
1105
1106         ret = pkgmgrinfo_updateinfo_destroy(handle);
1107         if (ret != PMINFO_R_OK)
1108                 return -1;
1109         return 0;
1110 }
1111  * @endcode
1112  */
1113 int pkgmgrinfo_updateinfo_destroy(pkgmgrinfo_updateinfo_h update_handle);
1114
1115 /**
1116  * @fn int pkgmgrinfo_updateinfo_get_updateinfo(const char *pkgid, pkgmgrinfo_updateinfo_h *update_handle)
1117  * @brief       This API creates the package update information handle from db
1118  *
1119  * @par         This API is for package-manager client application
1120  * @par Sync (or) Async : Synchronous API
1121  *
1122  * @param[in]   pkgid   pointer to package ID
1123  * @param[in]   uid     the addressee user id of the instruction
1124  * @param[out] update_handle            pointer to the package update info handle.
1125  * @return      0 if success, error code(<0) if fail
1126  * @retval      PMINFO_R_OK     success
1127  * @retval      PMINFO_R_EINVAL invalid argument
1128  * @retval      PMINFO_R_ERROR  internal error
1129  * @pre         None
1130  * @post                pkgmgrinfo_updateinfo_destroy()
1131  * @see         pkgmgrinfo_updateinfo_get_pkgid()
1132  * @see         pkgmgrinfo_updateinfo_get_version()
1133  * @see         pkgmgrinfo_updateinfo_get_update_type()
1134  * @code
1135 static int get_pkg_update_info(const char *pkgid)
1136 {
1137         int ret = 0;
1138         char *version;
1139         pkgmgrinfo_updateinfo_h handle;
1140         ret = pkgmgrinfo_updateinfo_get_updateinfo(pkgid, &handle);
1141         if (ret != PMINFO_R_OK)
1142                 return -1;
1143         ret = pkgmgrinfo_updateinfo_get_version(handle, &version);
1144         if (ret != PMINFO_R_OK) {
1145                 pkgmgrinfo_updateinfo_destroy(handle);
1146                 return -1;
1147         }
1148         printf("pkg update version: %s\n", version
1149         pkgmgrinfo_updateinfo_destroy(handle);
1150         return 0;
1151 }
1152  * @endcode
1153  */
1154 int pkgmgrinfo_updateinfo_get_updateinfo(const char *pkgid, pkgmgrinfo_updateinfo_h *update_handle);
1155 int pkgmgrinfo_updateinfo_get_usr_updateinfo(const char *pkgid, pkgmgrinfo_updateinfo_h *update_handle, uid_t uid);
1156
1157 /**
1158  * @fn int pkgmgrinfo_updateinfo_set_pkgid(pkgmgrinfo_updateinfo_h updateinfo_handle, const char *pkgid)
1159  * @brief       This API sets given pkgid into handle
1160  *
1161  * @par         This API is for package-manager client application
1162  * @par Sync (or) Async : Synchronous API
1163  *
1164  * @param[in]   handle  pointer to package update info handle
1165  * @param[in]   pkgid   package id
1166  * @return      0 if success, error code(<0) if fail
1167  * @retval      PMINFO_R_OK     success
1168  * @retval      PMINFO_R_EINVAL invalid argument
1169  * @retval      PMINFO_R_ERROR  internal error
1170  * @code
1171 static int set_pkgid_to_handle(pkgmgrinfo_updateinfo_h handle, const char *pkgid)
1172 {
1173         int ret = 0;
1174
1175         ret = pkgmgrinfo_updateinfo_set_pkgid(handle, pkgid);
1176         if (ret != PMINFO_R_OK)
1177                 return -1;
1178         return 0;
1179 }
1180  * @endcode
1181  */
1182 int pkgmgrinfo_updateinfo_set_pkgid(pkgmgrinfo_updateinfo_h updateinfo_handle, const char *pkgid);
1183
1184 /**
1185  * @fn int pkgmgrinfo_updateinfo_set_version(pkgmgrinfo_updateinfo_h updateinfo_handle, const char *version)
1186  * @brief       This API sets given version into handle
1187  *
1188  * @par         This API is for package-manager client application
1189  * @par Sync (or) Async : Synchronous API
1190  *
1191  * @param[in]   handle  pointer to package update info handle
1192  * @param[in]   version update version
1193  * @return      0 if success, error code(<0) if fail
1194  * @retval      PMINFO_R_OK     success
1195  * @retval      PMINFO_R_EINVAL invalid argument
1196  * @retval      PMINFO_R_ERROR  internal error
1197  * @code
1198 static int set_version_to_handle(pkgmgrinfo_updateinfo_h handle, const char *version)
1199 {
1200         int ret = 0;
1201
1202         ret = pkgmgrinfo_updateinfo_set_version(handle, version);
1203         if (ret != PMINFO_R_OK)
1204                 return -1;
1205         return 0;
1206 }
1207  * @endcode
1208  */
1209 int pkgmgrinfo_updateinfo_set_version(pkgmgrinfo_updateinfo_h updateinfo_handle, const char *version);
1210
1211 /**
1212  * @fn int pkgmgrinfo_updateinfo_set_type(pkgmgrinfo_updateinfo_h updateinfo_handle, pkgmgrinfo_updateinfo_update_type type)
1213  * @brief       This API sets given update type into handle
1214  *
1215  * @par         This API is for package-manager client application
1216  * @par Sync (or) Async : Synchronous API
1217  *
1218  * @param[in]   handle  pointer to package update info handle
1219  * @param[in]   type    update type
1220  * @return      0 if success, error code(<0) if fail
1221  * @retval      PMINFO_R_OK     success
1222  * @retval      PMINFO_R_EINVAL invalid argument
1223  * @retval      PMINFO_R_ERROR  internal error
1224  * @code
1225 static int set_type_to_handle(pkgmgrinfo_updateinfo_h handle, pkgmgrinfo_updateinfo_update_type type)
1226 {
1227         int ret = 0;
1228
1229         ret = pkgmgrinfo_updateinfo_set_type(handle, type);
1230         if (ret != PMINFO_R_OK)
1231                 return -1;
1232         return 0;
1233 }
1234  * @endcode
1235  */
1236 int pkgmgrinfo_updateinfo_set_type(pkgmgrinfo_updateinfo_h updateinfo_handle, pkgmgrinfo_updateinfo_update_type type);
1237
1238 /**
1239  * @fn int pkgmgrinfo_updateinfo_get_pkgid(pkgmgrinfo_updateinfo_h update_handle, char **pkgid)
1240  * @brief       This API retrieves the pkgid from given update info
1241  *
1242  * @par         This API is for package-manager client application
1243  * @par Sync (or) Async : Synchronous API
1244  *
1245  * @param[in]   handle  pointer to package update info handle
1246  * @param[out]  pkgid   package id
1247  * @return      0 if success, error code(<0) if fail
1248  * @retval      PMINFO_R_OK     success
1249  * @retval      PMINFO_R_EINVAL invalid argument
1250  * @retval      PMINFO_R_ERROR  internal error
1251  * @code
1252 static int get_pkgid_from_handle(pkgmgrinfo_updateinfo_h handle)
1253 {
1254         int ret = 0;
1255         char *pkgid;
1256
1257         ret = pkgmgrinfo_updateinfo_get_pkgid(handle, &pkgid);
1258         if (ret != PMINFO_R_OK)
1259                 return -1;
1260         return 0;
1261 }
1262  * @endcode
1263  */
1264 int pkgmgrinfo_updateinfo_get_pkgid(pkgmgrinfo_updateinfo_h update_handle, char **pkgid);
1265
1266 /**
1267  * @fn int pkgmgrinfo_updateinfo_get_version(pkgmgrinfo_updateinfo_h updateinfo_handle, char **version)
1268  * @brief       This API retrieves the version from given update info
1269  *
1270  * @par         This API is for package-manager client application
1271  * @par Sync (or) Async : Synchronous API
1272  *
1273  * @param[in]   handle  pointer to package update info handle
1274  * @param[out]  version update version
1275  * @return      0 if success, error code(<0) if fail
1276  * @retval      PMINFO_R_OK     success
1277  * @retval      PMINFO_R_EINVAL invalid argument
1278  * @retval      PMINFO_R_ERROR  internal error
1279  * @code
1280 static int get_version_from_handle(pkgmgrinfo_updateinfo_h handle)
1281 {
1282         int ret = 0;
1283         char *version;
1284
1285         ret = pkgmgrinfo_updateinfo_get_version(handle, &version);
1286         if (ret != PMINFO_R_OK)
1287                 return -1;
1288         return 0;
1289 }
1290  * @endcode
1291  */
1292 int pkgmgrinfo_updateinfo_get_version(pkgmgrinfo_updateinfo_h updateinfo_handle, char **version);
1293
1294 /**
1295  * @fn int pkgmgrinfo_updateinfo_get_update_type(pkgmgrinfo_updateinfo_h updateinfo_handle, pkgmgrinfo_updateinfo_update_type *type)
1296  * @brief       This API retrieves the update type from given update info
1297  *
1298  * @par         This API is for package-manager client application
1299  * @par Sync (or) Async : Synchronous API
1300  *
1301  * @param[in]   handle  pointer to package update info handle
1302  * @param[out]  type    update type
1303  * @return      0 if success, error code(<0) if fail
1304  * @retval      PMINFO_R_OK     success
1305  * @retval      PMINFO_R_EINVAL invalid argument
1306  * @retval      PMINFO_R_ERROR  internal error
1307  * @code
1308 static int get_type_from_handle(pkgmgrinfo_updateinfo_h handle)
1309 {
1310         int ret = 0;
1311         pkgmgrinfo_updateinfo_update_type *type;
1312
1313         ret = pkgmgrinfo_updateinfo_get_type(handle, &type);
1314         if (ret != PMINFO_R_OK)
1315                 return -1;
1316         return 0;
1317 }
1318  * @endcode
1319  */
1320 int pkgmgrinfo_updateinfo_get_update_type(pkgmgrinfo_updateinfo_h updateinfo_handle, pkgmgrinfo_updateinfo_update_type *type);
1321
1322
1323 /**
1324  * @fn int pkgmgrinfo_updateinfo_foreach_updateinfo(pkgmgrinfo_foreach_updateinfo_cb callback, void *user_data)
1325  * @brief       This API retrieve the update informations and invoke given callback for it.
1326  *
1327  * @par         This API is for package-manager client application
1328  * @par Sync (or) Async : Synchronous API
1329  *
1330  * @param[in]   callback        callback to be invoked for each retrieved informations
1331  * @param[in]   user_data       user data to be passed to callback
1332  * @return      0 if success, error code(<0) if fail
1333  * @retval      PMINFO_R_OK     success
1334  * @retval      PMINFO_R_EINVAL invalid argument
1335  * @retval      PMINFO_R_ERROR  internal error
1336  * @code
1337 static int foreach_pkg_updateinfo(pkgmgrinfo_foreach_updateinfo_cb callback)
1338 {
1339         int ret = 0;
1340
1341         ret = pkgmgrinfo_updateinfo_foreach_updateinfo(callback, NULL);
1342         if (ret != PMINFO_R_OK)
1343                 return -1;
1344         return 0;
1345 }
1346  * @endcode
1347  */
1348 int pkgmgrinfo_updateinfo_foreach_updateinfo(pkgmgrinfo_foreach_updateinfo_cb callback, void *user_data);
1349 int pkgmgrinfo_updateinfo_usr_foreach_updateinfo(uid_t uid, pkgmgrinfo_foreach_updateinfo_cb callback, void *user_data);
1350
1351 /**
1352  * @fn int pkgmgrinfo_appinfo_get_launch_mode(pkgmgrinfo_appinfo_h handle, char **mode)
1353  * @brief       This API gets the launch mode of package from the package ID
1354  *
1355  * @par         This API is for package-manager client application
1356  * @par Sync (or) Async : Synchronous API
1357  *
1358  * @param[in]   handle  pointer to package info handle
1359  * @param[out] mode             pointer to hold launch mode of package
1360  * @return      0 if success, error code(<0) if fail
1361  * @retval      PMINFO_R_OK     success
1362  * @retval      PMINFO_R_EINVAL invalid argument
1363  * @retval      PMINFO_R_ERROR  internal error
1364  * @pre         pkgmgrinfo_pkginfo_get_pkginfo()
1365  * @post                pkgmgrinfo_pkginfo_destroy_pkginfo()
1366  * @see         pkgmgrinfo_pkginfo_get_pkgid()
1367  * @see         pkgmgrinfo_pkginfo_is_removable()
1368  * @code
1369 static int get_pkg_launch_mode(const char *pkgid)
1370 {
1371         int ret = 0;
1372         char *launch_mode = NULL;
1373         pkgmgrinfo_pkginfo_h handle;
1374         ret = pkgmgrinfo_pkginfo_get_pkginfo(pkgid, &handle);
1375         if (ret != PMINFO_R_OK)
1376                 return -1;
1377         ret = pkgmgrinfo_pkginfo_get_launch_mode(handle, &mode);
1378         if (ret != PMINFO_R_OK) {
1379                 pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
1380                 return -1;
1381         }
1382         printf("launch mode: %s\n", mode);
1383         pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
1384         return 0;
1385 }
1386  * @endcode
1387  */
1388 int pkgmgrinfo_appinfo_get_launch_mode(pkgmgrinfo_appinfo_h handle, char **mode);
1389
1390 /**
1391  * @fn int pkgmgrinfo_pkginfo_get_storeclientid(pkgmgrinfo_pkginfo_h handle, char **storeclientid)
1392  * @brief       This API gets the store client id of package from the package ID
1393  *
1394  * @par         This API is for package-manager client application
1395  * @par Sync (or) Async : Synchronous API
1396  *
1397  * @param[in]   handle  pointer to package info handle
1398  * @param[out] storeclientid            pointer to hold store client id of package
1399  * @return      0 if success, error code(<0) if fail
1400  * @retval      PMINFO_R_OK     success
1401  * @retval      PMINFO_R_EINVAL invalid argument
1402  * @retval      PMINFO_R_ERROR  internal error
1403  * @pre         pkgmgrinfo_pkginfo_get_pkginfo()
1404  * @post                pkgmgrinfo_pkginfo_destroy_pkginfo()
1405  * @see         pkgmgrinfo_pkginfo_get_pkgid()
1406  * @see         pkgmgrinfo_pkginfo_is_removable()
1407  * @code
1408 static int get_pkg_storeclientid(const char *pkgid)
1409 {
1410         int ret = 0;
1411         char *storeclientid = 0;
1412         pkgmgrinfo_pkginfo_h handle;
1413         ret = pkgmgrinfo_pkginfo_get_pkginfo(pkgid, &handle);
1414         if (ret != PMINFO_R_OK)
1415                 return -1;
1416         ret = pkgmgrinfo_pkginfo_get_storeclientid(handle, &storeclientid);
1417         if (ret != PMINFO_R_OK) {
1418                 pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
1419                 return -1;
1420         }
1421         printf(store client id: %s\n", storeclientid);
1422         pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
1423         return 0;
1424 }
1425  * @endcode
1426  */
1427 int pkgmgrinfo_pkginfo_get_storeclientid(pkgmgrinfo_pkginfo_h handle, char **storeclientid);
1428
1429 /**
1430  * @fn int pkgmgrinfo_pkginfo_get_mainappid(pkgmgrinfo_pkginfo_h handle, char **mainappid)
1431  * @brief       This API gets the main app id of package from the package ID
1432  *
1433  * @par         This API is for package-manager client application
1434  * @par Sync (or) Async : Synchronous API
1435  *
1436  * @param[in]   handle  pointer to package info handle
1437  * @param[out] mainappid                pointer to hold main app id of package
1438  * @return      0 if success, error code(<0) if fail
1439  * @retval      PMINFO_R_OK     success
1440  * @retval      PMINFO_R_EINVAL invalid argument
1441  * @retval      PMINFO_R_ERROR  internal error
1442  * @pre         pkgmgrinfo_pkginfo_get_pkginfo()
1443  * @post                pkgmgrinfo_pkginfo_destroy_pkginfo()
1444  * @see         pkgmgrinfo_pkginfo_get_pkgid()
1445  * @see         pkgmgrinfo_pkginfo_is_removable()
1446  * @code
1447 static int get_pkg_mainappid(const char *pkgid)
1448 {
1449         int ret = 0;
1450         char *mainappid = 0;
1451         pkgmgrinfo_pkginfo_h handle;
1452         ret = pkgmgrinfo_pkginfo_get_pkginfo(pkgid, &handle);
1453         if (ret != PMINFO_R_OK)
1454                 return -1;
1455         ret = pkgmgrinfo_pkginfo_get_mainappid(handle, &mainappid);
1456         if (ret != PMINFO_R_OK) {
1457                 pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
1458                 return -1;
1459         }
1460         printf(main app id: %s\n", mainappid);
1461         pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
1462         return 0;
1463 }
1464  * @endcode
1465  */
1466 int pkgmgrinfo_pkginfo_get_mainappid(pkgmgrinfo_pkginfo_h handle, char **mainappid);
1467
1468 /**
1469  * @fn int pkgmgrinfo_pkginfo_get_url(pkgmgrinfo_pkginfo_h handle, char **url)
1470  * @brief       This API gets the url of package from the package ID
1471  *
1472  * @par         This API is for package-manager client application
1473  * @par Sync (or) Async : Synchronous API
1474  *
1475  * @param[in]   handle  pointer to package info handle
1476  * @param[out] url              pointer to hold url of package
1477  * @return      0 if success, error code(<0) if fail
1478  * @retval      PMINFO_R_OK     success
1479  * @retval      PMINFO_R_EINVAL invalid argument
1480  * @retval      PMINFO_R_ERROR  internal error
1481  * @pre         pkgmgrinfo_pkginfo_get_pkginfo()
1482  * @post                pkgmgrinfo_pkginfo_destroy_pkginfo()
1483  * @see         pkgmgrinfo_pkginfo_get_pkgid()
1484  * @see         pkgmgrinfo_pkginfo_is_removable()
1485  * @code
1486 static int get_pkg_url(const char *pkgid)
1487 {
1488         int ret = 0;
1489         char *url = 0;
1490         pkgmgrinfo_pkginfo_h handle;
1491         ret = pkgmgrinfo_pkginfo_get_pkginfo(pkgid, &handle);
1492         if (ret != PMINFO_R_OK)
1493                 return -1;
1494         ret = pkgmgrinfo_pkginfo_get_url(handle, &url);
1495         if (ret != PMINFO_R_OK) {
1496                 pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
1497                 return -1;
1498         }
1499         printf("url : %s\n", url);
1500         pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
1501         return 0;
1502 }
1503  * @endcode
1504  */
1505 int pkgmgrinfo_pkginfo_get_url(pkgmgrinfo_pkginfo_h handle, char **url);
1506
1507 /**
1508  * @fn int pkgmgrinfo_pkginfo_get_root_path(pkgmgrinfo_pkginfo_h handle, char **path)
1509  * @brief       This API gets the root path of package
1510  *
1511  * @par Sync (or) Async : Synchronous API
1512  *
1513  * @param[in] handle            pointer to package info handle
1514  * @param[out] path             pointer to hold root path of package
1515  * @return      0 if success, error code(<0) if fail
1516  * @retval      PMINFO_R_OK     success
1517  * @retval      PMINFO_R_EINVAL invalid argument
1518  * @retval      PMINFO_R_ERROR  internal error
1519  * @code
1520 static int get_root_path(const char *pkgid)
1521 {
1522         int ret = 0;
1523         char *path = 0;
1524         pkgmgrinfo_pkginfo_h handle;
1525         ret = pkgmgrinfo_pkginfo_get_pkginfo(pkgid, &handle);
1526         if (ret != PMINFO_R_OK)
1527                 return -1;
1528
1529         ret = pkgmgrinfo_pkginfo_get_root_path(handle, &path);
1530         if (ret != PMINFO_R_OK) {
1531                 pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
1532                 return -1;
1533         }
1534         printf("path : %s\n", path);
1535         pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
1536
1537         return 0;
1538 }
1539  * @endcode
1540  */
1541 int pkgmgrinfo_pkginfo_get_root_path(pkgmgrinfo_pkginfo_h handle, char **path);
1542
1543
1544 /**
1545  * @fn int pkgmgrinfo_pkginfo_get_csc_path(pkgmgrinfo_pkginfo_h handle, char **path)
1546  * @brief       This API gets the csc path of package
1547  *
1548  * @par Sync (or) Async : Synchronous API
1549  *
1550  * @param[in] handle            pointer to package info handle
1551  * @param[out] path             pointer to hold csc path of package
1552  * @return      0 if success, error code(<0) if fail
1553  * @retval      PMINFO_R_OK     success
1554  * @retval      PMINFO_R_EINVAL invalid argument
1555  * @retval      PMINFO_R_ERROR  internal error
1556  * @code
1557 static int get_csc_path(const char *pkgid)
1558 {
1559         int ret = 0;
1560         char *path = 0;
1561         pkgmgrinfo_pkginfo_h handle;
1562         ret = pkgmgrinfo_pkginfo_get_pkginfo(pkgid, &handle);
1563         if (ret != PMINFO_R_OK)
1564                 return -1;
1565
1566         ret = pkgmgrinfo_pkginfo_get_csc_path(handle, &path);
1567         if (ret != PMINFO_R_OK) {
1568                 pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
1569                 return -1;
1570         }
1571         printf("path : %s\n", path);
1572         pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
1573
1574         return 0;
1575 }
1576  * @endcode
1577  */
1578 int pkgmgrinfo_pkginfo_get_csc_path(pkgmgrinfo_pkginfo_h handle, char **path);
1579
1580 /**
1581  * @fn int pkgmgrinfo_pkginfo_get_support_mode(pkgmgrinfo_pkginfo_h handle, int *support_mode)
1582  * @brief       This API gets the support_mode of package
1583  *
1584  * @par Sync (or) Async : Synchronous API
1585  *
1586  * @param[in] handle            pointer to package info handle
1587  * @param[out] support_mode             pointer to hold support_mode of package
1588  * @return      0 if success, error code(<0) if fail
1589  * @retval      PMINFO_R_OK     success
1590  * @retval      PMINFO_R_EINVAL invalid argument
1591  * @retval      PMINFO_R_ERROR  internal error
1592  * @code
1593 static int get_support_mode(const char *pkgid)
1594 {
1595         int ret = 0;
1596         int support_mode = 0;
1597         pkgmgrinfo_pkginfo_h handle = NULL;
1598         ret = pkgmgrinfo_pkginfo_get_pkginfo(pkgid, &handle);
1599         if (ret != PMINFO_R_OK)
1600                 return -1;
1601
1602         ret = pkgmgrinfo_pkginfo_get_support_mode(handle, &support_mode);
1603         if (ret != PMINFO_R_OK) {
1604                 pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
1605                 return -1;
1606         }
1607         printf("support_mode : %s\n", support_mode);
1608         pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
1609
1610         return 0;
1611 }
1612  * @endcode
1613  */
1614 int pkgmgrinfo_pkginfo_get_support_mode(pkgmgrinfo_pkginfo_h handle, int *support_mode);
1615
1616 /**
1617  * @fn int pkgmgrinfo_pkginfo_compare_pkg_cert_info(const char *lhs_package_id, const char *rhs_package_id, pkgmgrinfo_cert_compare_result_type_e *compare_result)
1618  * @brief       This API compare the cert information from given package id
1619  *
1620  * @par         This API is for package-manager client application
1621  * @par Sync (or) Async : Synchronous API
1622  *
1623  * @param[in]   lhs_package_id  pointer to first package ID
1624  * @param[in]   rhs_package_id  pointer to second package ID
1625  * @param[out] compare_result           pointer to the compare result.
1626  * @return      0 if success, error code(<0) if fail
1627  * @retval      PMINFO_R_OK     success
1628  * @retval      PMINFO_R_EINVAL invalid argument
1629  * @retval      PMINFO_R_ERROR  internal error
1630  * @pre         None
1631  * @post                pkgmgrinfo_pkginfo_destroy_pkginfo()
1632  * @see         pkgmgrinfo_pkginfo_get_pkgid()
1633  * @see         pkgmgrinfo_pkginfo_is_removable()
1634  * @code
1635 static int compare_pkg_cert_info(const char *lhs_package_id, const char *rhs_package_id, pkgmgrinfo_cert_compare_result_type_e *compare_result)
1636 {
1637         int ret = 0;
1638         pkgmgrinfo_cert_compare_result_type_e result;
1639
1640         ret = pkgmgrinfo_pkginfo_compare_pkg_cert_info(lhs_package_id, rhs_package_id, &result);
1641         if (ret != PMINFO_R_OK) {
1642                 return -1;
1643         }
1644         printf("result: %d\n", result);
1645         return 0;
1646 }
1647  * @endcode
1648  */
1649 int pkgmgrinfo_pkginfo_compare_pkg_cert_info(const char *lhs_package_id, const char *rhs_package_id, pkgmgrinfo_cert_compare_result_type_e *compare_result);
1650 int pkgmgrinfo_pkginfo_compare_usr_pkg_cert_info(const char *lhs_package_id, const char *rhs_package_id, uid_t uid, pkgmgrinfo_cert_compare_result_type_e *compare_result);
1651 /**
1652  * @fn int pkgmgrinfo_pkginfo_compare_app_cert_info(const char *lhs_app_id, const char *rhs_app_id, pkgmgrinfo_cert_compare_result_type_e *compare_result)
1653  * @brief       This API compare the cert information from given app id
1654  *
1655  * @par         This API is for package-manager client application
1656  * @par Sync (or) Async : Synchronous API
1657  *
1658  * @param[in]   lhs_app_id      pointer to first app ID
1659  * @param[in]   rhs_app_id      pointer to second app ID
1660  * @param[out] compare_result           pointer to the compare result.
1661  * @return      0 if success, error code(<0) if fail
1662  * @retval      PMINFO_R_OK     success
1663  * @retval      PMINFO_R_EINVAL invalid argument
1664  * @retval      PMINFO_R_ERROR  internal error
1665  * @pre         None
1666  * @post                pkgmgrinfo_pkginfo_destroy_pkginfo()
1667  * @see         pkgmgrinfo_pkginfo_get_pkgid()
1668  * @see         pkgmgrinfo_pkginfo_is_removable()
1669  * @code
1670 static int compare_app_cert_info(const char *lhs_app_id, const char *rhs_app_id, pkgmgrinfo_cert_compare_result_type_e *compare_result)
1671 {
1672         int ret = 0;
1673         pkgmgrinfo_cert_compare_result_type_e result;
1674
1675         ret = pkgmgrinfo_pkginfo_compare_app_cert_info(lhs_app_id, rhs_app_id, &result);
1676         if (ret != PMINFO_R_OK) {
1677                 return -1;
1678         }
1679         printf("result: %d\n", result);
1680         return 0;
1681 }
1682  * @endcode
1683  */
1684 int pkgmgrinfo_pkginfo_compare_app_cert_info(const char *lhs_app_id, const char *rhs_app_id, pkgmgrinfo_cert_compare_result_type_e *compare_result);
1685 int pkgmgrinfo_pkginfo_compare_usr_app_cert_info(const char *lhs_app_id, const char *rhs_app_id, uid_t uid, pkgmgrinfo_cert_compare_result_type_e *compare_result);
1686 /**
1687  * @fn int pkgmgrinfo_pkginfo_is_removable(pkgmgrinfo_pkginfo_h handle, bool *removable)
1688  * @brief       This API gets the package 'removable' value from the package ID
1689  *
1690  * @par         This API is for package-manager client application
1691  * @par Sync (or) Async : Synchronous API
1692  *
1693  * @param[in]   handle  pointer to package info handle
1694  * @param[out] removable                pointer to hold package removable value
1695  * @return      0 if success, error code(<0) if fail
1696  * @retval      PMINFO_R_OK     success
1697  * @retval      PMINFO_R_EINVAL invalid argument
1698  * @retval      PMINFO_R_ERROR  internal error
1699  * @pre         pkgmgrinfo_pkginfo_get_pkginfo()
1700  * @post                pkgmgrinfo_pkginfo_destroy_pkginfo()
1701  * @see         pkgmgrinfo_pkginfo_get_pkgid()
1702  * @see         pkgmgrinfo_pkginfo_is_readonly()
1703  * @code
1704 static int get_pkg_removable(const char *pkgid)
1705 {
1706         int ret = 0;
1707         bool removable;
1708         pkgmgrinfo_pkginfo_h handle;
1709         ret = pkgmgrinfo_pkginfo_get_pkginfo(pkgid, &handle);
1710         if (ret != PMINFO_R_OK)
1711                 return -1;
1712         ret = pkgmgrinfo_pkginfo_is_removable(handle, &removable);
1713         if (ret != PMINFO_R_OK) {
1714                 pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
1715                 return -1;
1716         }
1717         printf("pkg removable: %d\n", removable);
1718         pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
1719         return 0;
1720 }
1721  * @endcode
1722  */
1723 int pkgmgrinfo_pkginfo_is_removable(pkgmgrinfo_pkginfo_h handle, bool *removable);
1724
1725 /**
1726  * @fn int pkgmgrinfo_pkginfo_is_movable(pkgmgrinfo_pkginfo_h handle, bool *movable)
1727  * @brief       This API check that the package can move internal storage to external storage or external storage to internal storage from the package ID
1728  *
1729  * @par         This API is for package-manager client application
1730  * @par Sync (or) Async : Synchronous API
1731  *
1732  * @param[in]   handle  pointer to package info handle
1733  * @param[out] movable          pointer to hold package movable state
1734  * @return      0 if success, error code(<0) if fail
1735  * @retval      PMINFO_R_OK     success
1736  * @retval      PMINFO_R_EINVAL invalid argument
1737  * @retval      PMINFO_R_ERROR  internal error
1738  * @pre         pkgmgrinfo_pkginfo_get_pkginfo()
1739  * @post                pkgmgrinfo_pkginfo_destroy_pkginfo()
1740  * @see         pkgmgrinfo_pkginfo_get_pkgid()
1741  * @code
1742 static int get_pkg_movable(const char *pkgid)
1743 {
1744         int ret = 0;
1745         bool movable;
1746         pkgmgrinfo_pkginfo_h handle;
1747         ret = pkgmgrinfo_pkginfo_get_pkginfo(pkgid, &handle);
1748         if (ret != PMINFO_R_OK)
1749                 return -1;
1750         ret = pkgmgrinfo_pkginfo_is_movable(handle, &movable);
1751         if (ret != PMINFO_R_OK) {
1752                 pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
1753                 return -1;
1754         }
1755         printf("pkg movable: %d\n", movable);
1756         pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
1757         return 0;
1758 }
1759  * @endcode
1760  */
1761 int pkgmgrinfo_pkginfo_is_movable(pkgmgrinfo_pkginfo_h handle, bool *movable);
1762
1763 /**
1764  * @fn int pkgmgrinfo_pkginfo_is_preload(pkgmgrinfo_pkginfo_h handle, bool *preload)
1765  * @brief       This API gets the package 'preload' value from the package ID
1766  *
1767  * @par         This API is for package-manager client application
1768  * @par Sync (or) Async : Synchronous API
1769  *
1770  * @param[in]   handle  pointer to package info handle
1771  * @param[out] preload          pointer to hold package preload value
1772  * @return      0 if success, error code(<0) if fail
1773  * @retval      PMINFO_R_OK     success
1774  * @retval      PMINFO_R_EINVAL invalid argument
1775  * @retval      PMINFO_R_ERROR  internal error
1776  * @pre         pkgmgrinfo_pkginfo_get_pkginfo()
1777  * @post                pkgmgrinfo_pkginfo_destroy_pkginfo()
1778  * @see         pkgmgrinfo_pkginfo_get_pkgid()
1779  * @see         pkgmgrinfo_pkginfo_is_readonly()
1780  * @code
1781 static int get_pkg_preload(const char *pkgid)
1782 {
1783         int ret = 0;
1784         bool preload;
1785         pkgmgrinfo_pkginfo_h handle;
1786         ret = pkgmgrinfo_pkginfo_get_pkginfo(pkgid, &handle);
1787         if (ret != PMINFO_R_OK)
1788                 return -1;
1789         ret = pkgmgrinfo_pkginfo_is_preload(handle, &preload);
1790         if (ret != PMINFO_R_OK) {
1791                 pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
1792                 return -1;
1793         }
1794         printf("pkg preload: %d\n", preload);
1795         pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
1796         return 0;
1797 }
1798  * @endcode
1799  */
1800 int pkgmgrinfo_pkginfo_is_preload(pkgmgrinfo_pkginfo_h handle, bool *preload);
1801
1802 /**
1803  * @fn int pkgmgrinfo_pkginfo_is_system(pkgmgrinfo_pkginfo_h handle, bool *system)
1804  * @brief       This API gets the value for given handle is system or not
1805  *
1806  * @par         This API is for package-manager client application
1807  * @par Sync (or) Async : Synchronous API
1808  *
1809  * @param[in]   handle  pointer to package info handle
1810  * @param[out] system           pointer to hold  system is or not
1811  * @return      0 if success, error code(<0) if fail
1812  * @retval      PMINFO_R_OK     success
1813  * @retval      PMINFO_R_EINVAL invalid argument
1814  * @retval      PMINFO_R_ERROR  internal error
1815  * @pre         pkgmgrinfo_pkginfo_get_pkginfo()
1816  * @post                pkgmgrinfo_pkginfo_destroy_pkginfo()
1817  * @see         pkgmgrinfo_pkginfo_get_pkgid()
1818  * @see         pkgmgrinfo_pkginfo_is_readonly()
1819  * @code
1820 static int get_pkg_system(const char *pkgid)
1821 {
1822         int ret = 0;
1823         bool system = false;
1824         pkgmgrinfo_pkginfo_h handle = NULL;
1825         ret = pkgmgrinfo_pkginfo_get_pkginfo(pkgid, &handle);
1826         if (ret != PMINFO_R_OK)
1827                 return -1;
1828         ret = pkgmgrinfo_pkginfo_is_system(handle, &system);
1829         if (ret != PMINFO_R_OK) {
1830                 pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
1831                 return -1;
1832         }
1833         printf("pkg system: %d\n", system);
1834         pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
1835         return 0;
1836 }
1837  * @endcode
1838  */
1839 int pkgmgrinfo_pkginfo_is_system(pkgmgrinfo_pkginfo_h handle, bool *system);
1840
1841 /**
1842  * @fn int pkgmgrinfo_pkginfo_is_readonly(pkgmgrinfo_pkginfo_h handle, bool *readonly)
1843  * @brief       This API gets the package 'readonly' value from the package ID
1844  *
1845  * @par         This API is for package-manager client application
1846  * @par Sync (or) Async : Synchronous API
1847  *
1848  * @param[in]   handle  pointer to package info handle
1849  * @param[out] readonly pointer to hold package readonly value
1850  * @return      0 if success, error code(<0) if fail
1851  * @retval      PMINFO_R_OK     success
1852  * @retval      PMINFO_R_EINVAL invalid argument
1853  * @retval      PMINFO_R_ERROR  internal error
1854  * @pre         pkgmgrinfo_pkginfo_get_pkginfo()
1855  * @post                pkgmgrinfo_pkginfo_destroy_pkginfo()
1856  * @see         pkgmgrinfo_pkginfo_get_pkgid()
1857  * @see         pkgmgrinfo_pkginfo_is_removable()
1858  * @code
1859 static int get_pkg_readonly(const char *pkgid)
1860 {
1861         int ret = 0;
1862         bool readonly;
1863         pkgmgrinfo_pkginfo_h handle;
1864         ret = pkgmgrinfo_pkginfo_get_pkginfo(pkgid, &handle);
1865         if (ret != PMINFO_R_OK)
1866                 return -1;
1867         ret = pkgmgrinfo_pkginfo_is_readonly(handle, &readonly);
1868         if (ret != PMINFO_R_OK) {
1869                 pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
1870                 return -1;
1871         }
1872         printf("pkg readonly: %d\n", readonly);
1873         pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
1874         return 0;
1875 }
1876  * @endcode
1877  */
1878 int pkgmgrinfo_pkginfo_is_readonly(pkgmgrinfo_pkginfo_h handle, bool *readonly);
1879
1880
1881 /**
1882  * @fn int pkgmgrinfo_pkginfo_is_update(pkgmgrinfo_pkginfo_h handle, bool *update)
1883  * @brief       This API gets the package 'upate' value from the package ID
1884  *
1885  * @par         This API is for package-manager client application
1886  * @par Sync (or) Async : Synchronous API
1887  *
1888  * @param[in]   handle  pointer to package info handle
1889  * @param[out] update   pointer to hold package update value
1890  * @return      0 if success, error code(<0) if fail
1891  * @retval      PMINFO_R_OK     success
1892  * @retval      PMINFO_R_EINVAL invalid argument
1893  * @retval      PMINFO_R_ERROR  internal error
1894  * @pre         pkgmgrinfo_pkginfo_get_pkginfo()
1895  * @post                pkgmgrinfo_pkginfo_destroy_pkginfo()
1896  * @see         pkgmgrinfo_pkginfo_get_pkgid()
1897  * @code
1898 static int get_pkg_update(const char *pkgid)
1899 {
1900         int ret = 0;
1901         bool update;
1902         pkgmgrinfo_pkginfo_h handle;
1903         ret = pkgmgrinfo_pkginfo_get_pkginfo(pkgid, &handle);
1904         if (ret != PMINFO_R_OK)
1905                 return -1;
1906         ret = pkgmgrinfo_pkginfo_is_update(handle, &update);
1907         if (ret != PMINFO_R_OK) {
1908                 pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
1909                 return -1;
1910         }
1911         printf("pkg update: %d\n", update);
1912         pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
1913         return 0;
1914 }
1915  * @endcode
1916  */
1917 int pkgmgrinfo_pkginfo_is_update(pkgmgrinfo_pkginfo_h handle, bool *update);
1918
1919 /**
1920  * @fn int pkgmgrinfo_pkginfo_is_support_disable(pkgmgrinfo_pkginfo_h handle, bool *support_disable)
1921  * @brief       This API gets the package 'support_disable' value from the package ID
1922  *
1923  * @par         This API is for package-manager client application
1924  * @par Sync (or) Async : Synchronous API
1925  *
1926  * @param[in]   handle  pointer to package info handle
1927  * @param[out]  support_disable pointer to hold package support_disable value
1928  * @return      0 if success, error code(<0) if fail
1929  * @retval      PMINFO_R_OK     success
1930  * @retval      PMINFO_R_EINVAL invalid argument
1931  * @retval      PMINFO_R_ERROR  internal error
1932  * @pre         pkgmgrinfo_pkginfo_get_pkginfo()
1933  * @post                pkgmgrinfo_pkginfo_destroy_pkginfo()
1934  * @see         pkgmgrinfo_pkginfo_get_pkgid()
1935  * @code
1936 static int get_pkg_support_disable(const char *pkgid)
1937 {
1938         int ret = 0;
1939         bool support_disable;
1940         pkgmgrinfo_pkginfo_h handle = NULL;
1941         ret = pkgmgrinfo_pkginfo_get_pkginfo(pkgid, &handle);
1942         if (ret != PMINFO_R_OK)
1943                 return -1;
1944         ret = pkgmgrinfo_pkginfo_is_support_disable(handle, &support_disable);
1945         if (ret != PMINFO_R_OK) {
1946                 pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
1947                 return -1;
1948         }
1949         printf("pkg support_disable: %d\n", support_disable);
1950         pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
1951         return 0;
1952 }
1953  * @endcode
1954  */
1955 int pkgmgrinfo_pkginfo_is_support_disable(pkgmgrinfo_pkginfo_h handle, bool *support_disable);
1956
1957 /**
1958  * @fn int pkgmgrinfo_pkginfo_is_global(pkgmgrinfo_pkginfo_h handle, bool *global)
1959  * @brief       This API gets whethere the given package is global package or user package
1960  *
1961  * @par         This API is for package-manager client application
1962  * @par Sync (or) Async : Synchronous API
1963  *
1964  * @param[in]   handle  pointer to package info handle
1965  * @param[in]   global  pointer to hold package global value
1966  * @return      0 if success, error code(<0) if fail
1967  * @retval      PMINFO_R_OK     success
1968  * @retval      PMINFO_R_EINVAL invalid argument
1969  * @retval      PMINFO_R_ERROR  internal error
1970  * @pre         pkgmgrinfo_pkginfo_get_pkginfo()
1971  * @post                pkgmgrinfo_pkginfo_destroy_pkginfo()
1972  * @see         pkgmgrinfo_pkginfo_get_pkgid()
1973  static int get_pkg_support_disable(const char *pkgid)
1974  {
1975          int ret = 0;
1976          bool global;
1977          pkgmgrinfo_pkginfo_h handle = NULL;
1978          ret = pkgmgrinfo_pkginfo_get_pkginfo(pkgid, &handle);
1979          if (ret != PMINFO_R_OK)
1980                  return -1;
1981          ret = pkgmgrinfo_pkginfo_is_global(handle, &global);
1982          if (ret != PMINFO_R_OK) {
1983                  pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
1984                  return -1;
1985          }
1986          printf("pkg is_global: %d\n", global);
1987          pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
1988          return 0;
1989  }
1990   * @endcode
1991   */
1992 int pkgmgrinfo_pkginfo_is_global(pkgmgrinfo_pkginfo_h handle, bool *global);
1993
1994 /**
1995  * @fn int pkgmgrinfo_pkginfo_is_accessible(pkgmgrinfo_pkginfo_h handle, bool *accessible)
1996  * @brief       This API gets the package 'accessible' value from the package ID
1997  *
1998  * @par         This API is for package-manager client application
1999  * @par Sync (or) Async : Synchronous API
2000  *
2001  * @param[in]   handle  pointer to package info handle
2002  * @param[out] accessible       pointer to hold package accessible value
2003  * @return      0 if success, error code(<0) if fail
2004  * @retval      PMINFO_R_OK     success
2005  * @retval      PMINFO_R_EINVAL invalid argument
2006  * @retval      PMINFO_R_ERROR  internal error
2007  * @pre         pkgmgrinfo_pkginfo_get_pkginfo()
2008  * @post                pkgmgrinfo_pkginfo_destroy_pkginfo()
2009  * @see         pkgmgrinfo_pkginfo_get_pkgid()
2010  * @see         pkgmgrinfo_pkginfo_is_readonly()
2011  * @code
2012 static int get_pkg_accessible(const char *pkgid)
2013 {
2014         int ret = 0;
2015         bool accessible;
2016         pkgmgrinfo_pkginfo_h handle;
2017         ret = pkgmgrinfo_pkginfo_get_pkginfo(pkgid, &handle);
2018         if (ret != PMINFO_R_OK)
2019                 return -1;
2020         ret = pkgmgrinfo_pkginfo_is_accessible(handle, &accessible);
2021         if (ret != PMINFO_R_OK) {
2022                 pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
2023                 return -1;
2024         }
2025         printf("pkg accessible: %d\n", accessible);
2026         pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
2027         return 0;
2028 }
2029  * @endcode
2030  */
2031 int pkgmgrinfo_pkginfo_is_accessible(pkgmgrinfo_pkginfo_h handle, bool *accessible);
2032
2033 /**
2034  * @fn int pkgmgrinfo_pkginfo_destroy_pkginfo(pkgmgrinfo_pkginfo_h handle)
2035  * @brief       This API destroys the package information handle freeing up all the resources
2036  *
2037  * @par         This API is for package-manager client application
2038  * @par Sync (or) Async : Synchronous API
2039  *
2040  * @param[in]   handle  pointer to the package info handle
2041  * @return      0 if success, error code(<0) if fail
2042  * @retval      PMINFO_R_OK     success
2043  * @retval      PMINFO_R_EINVAL invalid argument
2044  * @retval      PMINFO_R_ERROR  internal error
2045  * @pre         pkgmgrinfo_pkginfo_get_pkginfo()
2046  * @post                None
2047  * @see         pkgmgrinfo_pkginfo_get_pkgid()
2048  * @see         pkgmgrinfo_pkginfo_is_removable()
2049  * @code
2050 static int get_pkg_type(const char *pkgid)
2051 {
2052         int ret = 0;
2053         char *type = NULL;
2054         pkgmgrinfo_pkginfo_h handle;
2055         ret = pkgmgrinfo_pkginfo_get_pkginfo(pkgid, &handle);
2056         if (ret != PMINFO_R_OK)
2057                 return -1;
2058         ret = pkgmgrinfo_pkginfo_get_type(handle, &type);
2059         if (ret != PMINFO_R_OK) {
2060                 pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
2061                 return -1;
2062         }
2063         printf("pkgtype: %s\n", type);
2064         pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
2065         return 0;
2066 }
2067  * @endcode
2068  */
2069 int pkgmgrinfo_pkginfo_destroy_pkginfo(pkgmgrinfo_pkginfo_h handle);
2070
2071 /**
2072  * @fn int pkgmgrinfo_pkginfo_filter_create(pkgmgrinfo_pkginfo_filter_h *handle)
2073  * @brief       This API creates the package information filter handle from db.  All filter properties will be ANDed.
2074  The query will search the entire package information collected from the manifest file of all the installed packages
2075  *
2076  * @par         This API is for package-manager client application
2077  * @par Sync (or) Async : Synchronous API
2078  *
2079  * @param[out] handle           pointer to the package info filter handle.
2080  * @return      0 if success, error code(<0) if fail
2081  * @retval      PMINFO_R_OK     success
2082  * @retval      PMINFO_R_EINVAL invalid argument
2083  * @retval      PMINFO_R_ERROR  internal error
2084  * @pre         None
2085  * @post                pkgmgrinfo_pkginfo_filter_destroy()
2086  * @see         pkgmgrinfo_pkginfo_filter_count()
2087  * @see         pkgmgrinfo_pkginfo_filter_foreach_pkginfo()
2088  * @code
2089 static int get_tpk_pkg_count()
2090 {
2091         int ret = 0;
2092         int count = 0;
2093         pkgmgrinfo_pkginfo_filter_h handle;
2094         ret = pkgmgrinfo_pkginfo_filter_create(&handle);
2095         if (ret != PMINFO_R_OK)
2096                 return -1;
2097         ret = pkgmgrinfo_pkginfo_filter_add_string(handle, PMINFO_PKGINFO_PROP_PACKAGE_TYPE, "tpk");
2098         if (ret != PMINFO_R_OK) {
2099                 pkgmgrinfo_pkginfo_filter_destroy(handle);
2100                 return -1;
2101         }
2102         ret = pkgmgrinfo_pkginfo_filter_count(handle, &count);
2103         if (ret != PMINFO_R_OK) {
2104                 pkgmgrinfo_pkginfo_filter_destroy(handle);
2105                 return -1;
2106         }
2107         printf("No of tpk pkgs: %d\n", count);
2108         pkgmgrinfo_pkginfo_filter_destroy(handle);
2109         return 0;
2110 }
2111  * @endcode
2112  */
2113 int pkgmgrinfo_pkginfo_filter_create(pkgmgrinfo_pkginfo_filter_h *handle);
2114
2115 /**
2116  * @fn int pkgmgrinfo_pkginfo_filter_destroy(pkgmgrinfo_pkginfo_filter_h handle)
2117  * @brief       This API destroys the package information filter handle freeing up all the resources
2118  *
2119  * @par         This API is for package-manager client application
2120  * @par Sync (or) Async : Synchronous API
2121  *
2122  * @param[in] handle            pointer to the package info filter handle.
2123  * @return      0 if success, error code(<0) if fail
2124  * @retval      PMINFO_R_OK     success
2125  * @retval      PMINFO_R_EINVAL invalid argument
2126  * @retval      PMINFO_R_ERROR  internal error
2127  * @pre         pkgmgrinfo_pkginfo_filter_create()
2128  * @post                None
2129  * @see         pkgmgrinfo_pkginfo_filter_count()
2130  * @see         pkgmgrinfo_pkginfo_filter_foreach_pkginfo()
2131  * @code
2132 static int get_tpk_pkg_count()
2133 {
2134         int ret = 0;
2135         int count = 0;
2136         pkgmgrinfo_pkginfo_filter_h handle;
2137         ret = pkgmgrinfo_pkginfo_filter_create(&handle);
2138         if (ret != PMINFO_R_OK)
2139                 return -1;
2140         ret = pkgmgrinfo_pkginfo_filter_add_string(handle, PMINFO_PKGINFO_PROP_PACKAGE_TYPE, "tpk");
2141         if (ret != PMINFO_R_OK) {
2142                 pkgmgrinfo_pkginfo_filter_destroy(handle);
2143                 return -1;
2144         }
2145         ret = pkgmgrinfo_pkginfo_filter_count(handle, &count);
2146         if (ret != PMINFO_R_OK) {
2147                 pkgmgrinfo_pkginfo_filter_destroy(handle);
2148                 return -1;
2149         }
2150         printf("No of tpk pkgs: %d\n", count);
2151         pkgmgrinfo_pkginfo_filter_destroy(handle);
2152         return 0;
2153 }
2154  * @endcode
2155  */
2156 int pkgmgrinfo_pkginfo_filter_destroy(pkgmgrinfo_pkginfo_filter_h handle);
2157
2158 /**
2159  * @fn int pkgmgrinfo_pkginfo_filter_add_bool(pkgmgrinfo_pkginfo_filter_h handle, const char *property, const bool value)
2160  * @brief       This API adds a boolean filter property to the filter handle
2161  *
2162  * @par         This API is for package-manager client application
2163  * @par Sync (or) Async : Synchronous API
2164  *
2165  * @param[in] handle            pointer to the package info filter handle.
2166  * @param[in] property          boolean property name.
2167  * @param[in] value             value corresponding to the property.
2168  * @return      0 if success, error code(<0) if fail
2169  * @retval      PMINFO_R_OK     success
2170  * @retval      PMINFO_R_EINVAL invalid argument
2171  * @retval      PMINFO_R_ERROR  internal error
2172  * @pre         pkgmgrinfo_pkginfo_filter_create()
2173  * @post                pkgmgrinfo_pkginfo_filter_destroy()
2174  * @see         pkgmgrinfo_pkginfo_filter_count()
2175  * @see         pkgmgrinfo_pkginfo_filter_foreach_pkginfo()
2176  * @code
2177 static int get_preload_pkg_count()
2178 {
2179         int ret = 0;
2180         int count = 0;
2181         pkgmgrinfo_pkginfo_filter_h handle;
2182         ret = pkgmgrinfo_pkginfo_filter_create(&handle);
2183         if (ret != PMINFO_R_OK)
2184                 return -1;
2185         ret = pkgmgrinfo_pkginfo_filter_add_bool(handle, PMINFO_PKGINFO_PROP_PACKAGE_PRELOAD, 1);
2186         if (ret != PMINFO_R_OK) {
2187                 pkgmgrinfo_pkginfo_filter_destroy(handle);
2188                 return -1;
2189         }
2190         ret = pkgmgrinfo_pkginfo_filter_count(handle, &count);
2191         if (ret != PMINFO_R_OK) {
2192                 pkgmgrinfo_pkginfo_filter_destroy(handle);
2193                 return -1;
2194         }
2195         printf("No of preload pkgs: %d\n", count);
2196         pkgmgrinfo_pkginfo_filter_destroy(handle);
2197         return 0;
2198 }
2199  * @endcode
2200  */
2201 int pkgmgrinfo_pkginfo_filter_add_bool(pkgmgrinfo_pkginfo_filter_h handle,
2202                 const char *property, const bool value);
2203
2204 /**
2205  * @fn int pkgmgrinfo_pkginfo_filter_add_int(pkgmgrinfo_pkginfo_filter_h handle, const char *property, const int value)
2206  * @brief       This API adds an integer filter property to the filter handle
2207  *
2208  * @par         This API is for package-manager client application
2209  * @par Sync (or) Async : Synchronous API
2210  *
2211  * @param[in] handle            pointer to the package info filter handle.
2212  * @param[in] property          integer property name.
2213  * @param[in] value             value corresponding to the property.
2214  * @return      0 if success, error code(<0) if fail
2215  * @retval      PMINFO_R_OK     success
2216  * @retval      PMINFO_R_EINVAL invalid argument
2217  * @retval      PMINFO_R_ERROR  internal error
2218  * @pre         pkgmgrinfo_pkginfo_filter_create()
2219  * @post                pkgmgrinfo_pkginfo_filter_destroy()
2220  * @see         pkgmgrinfo_pkginfo_filter_count()
2221  * @see         pkgmgrinfo_pkginfo_filter_foreach_pkginfo()
2222  * @code
2223 static int get_pkg_count()
2224 {
2225         int ret = 0;
2226         int count = 0;
2227         pkgmgrinfo_pkginfo_filter_h handle;
2228         ret = pkgmgrinfo_pkginfo_filter_create(&handle);
2229         if (ret != PMINFO_R_OK)
2230                 return -1;
2231         ret = pkgmgrinfo_pkginfo_filter_add_int(handle, PMINFO_PKGINFO_PROP_PACKAGE_SIZE, 10);
2232         if (ret != PMINFO_R_OK) {
2233                 pkgmgrinfo_pkginfo_filter_destroy(handle);
2234                 return -1;
2235         }
2236         ret = pkgmgrinfo_pkginfo_filter_count(handle, &count);
2237         if (ret != PMINFO_R_OK) {
2238                 pkgmgrinfo_pkginfo_filter_destroy(handle);
2239                 return -1;
2240         }
2241         printf("No of preload pkgs: %d\n", count);
2242         pkgmgrinfo_pkginfo_filter_destroy(handle);
2243         return 0;
2244 }
2245  * @endcode
2246  */
2247 int pkgmgrinfo_pkginfo_filter_add_int(pkgmgrinfo_pkginfo_filter_h handle,
2248                 const char *property, const int value);
2249
2250 /**
2251  * @fn int pkgmgrinfo_pkginfo_filter_add_string(pkgmgrinfo_pkginfo_filter_h handle, const char *property, const char *value)
2252  * @brief       This API adds a string filter property to the filter handle
2253  *
2254  * @par         This API is for package-manager client application
2255  * @par Sync (or) Async : Synchronous API
2256  *
2257  * @param[in] handle            pointer to the package info filter handle.
2258  * @param[in] property          string property name.
2259  * @param[in] value             value corresponding to the property.
2260  * @return      0 if success, error code(<0) if fail
2261  * @retval      PMINFO_R_OK     success
2262  * @retval      PMINFO_R_EINVAL invalid argument
2263  * @retval      PMINFO_R_ERROR  internal error
2264  * @pre         pkgmgrinfo_pkginfo_filter_create()
2265  * @post                pkgmgrinfo_pkginfo_filter_destroy()
2266  * @see         pkgmgrinfo_pkginfo_filter_count()
2267  * @see         pkgmgrinfo_pkginfo_filter_foreach_pkginfo()
2268  * @code
2269 static int get_tpk_pkg_count()
2270 {
2271         int ret = 0;
2272         int count = 0;
2273         pkgmgrinfo_pkginfo_filter_h handle;
2274         ret = pkgmgrinfo_pkginfo_filter_create(&handle);
2275         if (ret != PMINFO_R_OK)
2276                 return -1;
2277         ret = pkgmgrinfo_pkginfo_filter_add_string(handle, PMINFO_PKGINFO_PROP_PACKAGE_TYPE, "tpk");
2278         if (ret != PMINFO_R_OK) {
2279                 pkgmgrinfo_pkginfo_filter_destroy(handle);
2280                 return -1;
2281         }
2282         ret = pkgmgrinfo_pkginfo_filter_count(handle, &count);
2283         if (ret != PMINFO_R_OK) {
2284                 pkgmgrinfo_pkginfo_filter_destroy(handle);
2285                 return -1;
2286         }
2287         printf("No of tpk pkgs: %d\n", count);
2288         pkgmgrinfo_pkginfo_filter_destroy(handle);
2289         return 0;
2290 }
2291  * @endcode
2292  */
2293 int pkgmgrinfo_pkginfo_filter_add_string(pkgmgrinfo_pkginfo_filter_h handle,
2294                 const char *property, const char *value);
2295
2296 /**
2297  * @fn int pkgmgrinfo_pkginfo_filter_foreach_pkginfo(pkgmgrinfo_pkginfo_filter_h handle, pkgmgrinfo_pkg_list_cb pkg_cb, void *user_data)
2298  * @brief       This API executes the user supplied callback function for each package that satisfy the filter conditions
2299  *
2300  * @par         This API is for package-manager client application
2301  * @par Sync (or) Async : Synchronous API
2302  *
2303  * @param[in] handle            pointer to the package info filter handle.
2304  * @param[in] pkg_cb            callback function.
2305  * @param[in] user_data         user data to be passed to the callback function
2306  * @return      0 if success, error code(<0) if fail
2307  * @retval      PMINFO_R_OK     success
2308  * @retval      PMINFO_R_EINVAL invalid argument
2309  * @retval      PMINFO_R_ERROR  internal error
2310  * @pre         pkgmgrinfo_pkginfo_filter_create()
2311  * @post                pkgmgrinfo_pkginfo_filter_destroy()
2312  * @see         pkgmgrinfo_pkginfo_filter_count()
2313  * @code
2314 int pkg_list_cb(pkgmgrinfo_pkginfo_h handle, void *user_data)
2315 {
2316         char *pkgid = NULL;
2317         pkgmgrinfo_pkginfo_get_pkgid(handle, &pkgid);
2318         printf("pkg id : %s\n", pkgid);
2319         return 0;
2320 }
2321
2322 static int get_tpk_pkg_list()
2323 {
2324         int ret = 0;
2325         pkgmgrinfo_pkginfo_filter_h handle;
2326         ret = pkgmgrinfo_pkginfo_filter_create(&handle);
2327         if (ret != PMINFO_R_OK)
2328                 return -1;
2329         ret = pkgmgrinfo_pkginfo_filter_add_string(handle, PMINFO_PKGINFO_PROP_PACKAGE_TYPE, "tpk");
2330         if (ret != PMINFO_R_OK) {
2331                 pkgmgrinfo_pkginfo_filter_destroy(handle);
2332                 return -1;
2333         }
2334         ret = pkgmgrinfo_pkginfo_filter_foreach_pkginfo(handle, pkg_list_cb, NULL);
2335         if (ret != PMINFO_R_OK) {
2336                 pkgmgrinfo_pkginfo_filter_destroy(handle);
2337                 return -1;
2338         }
2339         pkgmgrinfo_pkginfo_filter_destroy(handle);
2340         return 0;
2341 }
2342  * @endcode
2343  */
2344 int pkgmgrinfo_pkginfo_filter_foreach_pkginfo(pkgmgrinfo_pkginfo_filter_h handle,
2345                 pkgmgrinfo_pkg_list_cb pkg_cb, void *user_data);
2346 int pkgmgrinfo_pkginfo_usr_filter_foreach_pkginfo(pkgmgrinfo_pkginfo_filter_h handle,
2347                 pkgmgrinfo_pkg_list_cb pkg_cb, void *user_data, uid_t uid);
2348
2349 /**
2350  * @fn int pkgmgrinfo_pkginfo_filter_count(pkgmgrinfo_pkginfo_filter_h handle, int *count)
2351  * @fn int pkgmgrinfo_pkginfo_usr_filter_count(pkgmgrinfo_pkginfo_filter_h handle, int *count, uid_t uid)
2352  * @brief       This API counts the package that satisfy the filter conditions
2353  *
2354  * @par         This API is for package-manager client application
2355  * @par Sync (or) Async : Synchronous API
2356  *
2357  * @param[in] handle            pointer to the package info filter handle.
2358  * @param[in] count             pointer to store the count value.
2359  * @param[in]   uid     the addressee user id of the instruction
2360  * @return      0 if success, error code(<0) if fail
2361  * @retval      PMINFO_R_OK     success
2362  * @retval      PMINFO_R_EINVAL invalid argument
2363  * @retval      PMINFO_R_ERROR  internal error
2364  * @pre         pkgmgrinfo_pkginfo_filter_create()
2365  * @post                pkgmgrinfo_pkginfo_filter_destroy()
2366  * @see         pkgmgrinfo_pkginfo_filter_foreach_pkginfo()
2367  * @code
2368 static int get_tpk_pkg_count()
2369 {
2370         int ret = 0;
2371         int count = 0;
2372         pkgmgrinfo_pkginfo_filter_h handle;
2373         ret = pkgmgrinfo_pkginfo_filter_create(&handle);
2374         if (ret != PMINFO_R_OK)
2375                 return -1;
2376         ret = pkgmgrinfo_pkginfo_filter_add_string(handle, PMINFO_PKGINFO_PROP_PACKAGE_TYPE, "tpk");
2377         if (ret != PMINFO_R_OK) {
2378                 pkgmgrinfo_pkginfo_filter_destroy(handle);
2379                 return -1;
2380         }
2381         ret = pkgmgrinfo_pkginfo_filter_count(handle, &count);
2382         if (ret != PMINFO_R_OK) {
2383                 pkgmgrinfo_pkginfo_filter_destroy(handle);
2384                 return -1;
2385         }
2386         printf("No of tpk pkgs: %d\n", count);
2387         pkgmgrinfo_pkginfo_filter_destroy(handle);
2388         return 0;
2389 }
2390  * @endcode
2391  */
2392 int pkgmgrinfo_pkginfo_filter_count(pkgmgrinfo_pkginfo_filter_h handle, int *count);
2393 int pkgmgrinfo_pkginfo_usr_filter_count(pkgmgrinfo_pkginfo_filter_h handle, int *count, uid_t uid);
2394 /**
2395  * @fn  int pkgmgrinfo_pkginfo_foreach_privilege(pkgmgrinfo_pkginfo_h handle,
2396                         pkgmgrinfo_pkg_privilege_list_cb privilege_func, void *user_data);
2397  * @brief       This API gets the list of privilege for a particular package
2398  *
2399  * @par         This API is for package-manager client application
2400  * @par Sync (or) Async : Synchronous API
2401  * @param[in]   handle          pointer to the package info handle.
2402  * @param[in]   privilege_func          callback function for list
2403  * @param[in] user_data user data to be passed to callback function
2404  * @return      0 if success, error code(<0) if fail
2405  * @retval      PMINFO_R_OK     success
2406  * @retval      PMINFO_R_EINVAL invalid argument
2407  * @retval      PMINFO_R_ERROR  internal error
2408  * @pre         pkgmgrinfo_pkginfo_get_pkginfo()
2409  * @post                pkgmgrinfo_pkginfo_destroy_pkginfo()
2410  * @code
2411 int privilege_func(const char *name, void *user_data)
2412 {
2413         if (strcmp(name, (char *)user_data) == 0)
2414                 return -1;
2415         else
2416                 return 0;
2417 }
2418
2419 static int list_privilege(const char *package, char *privilege)
2420 {
2421         int ret = 0;
2422         pkgmgrinfo_pkginfo_h handle;
2423         ret = pkgmgrinfo_pkginfo_get_pkginfo(package, &handle);
2424         if (ret != PMINFO_R_OK)
2425                 return -1;
2426         ret = pkgmgrinfo_pkginfo_foreach_privilege(handle, privilege_func, (void *)privilege);
2427         if (ret != PMINFO_R_OK) {
2428                 pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
2429                 return -1;
2430         }
2431         pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
2432         return 0;
2433 }
2434  * @endcode
2435  */
2436 int pkgmgrinfo_pkginfo_foreach_privilege(pkgmgrinfo_pkginfo_h handle,
2437                         pkgmgrinfo_pkg_privilege_list_cb privilege_func, void *user_data);
2438
2439 /* TODO: add doxygen comment here */
2440 int pkgmgrinfo_pkginfo_is_for_all_users(pkgmgrinfo_pkginfo_h handle, bool *for_all_users);
2441
2442 /**
2443  * @fn int pkgmgrinfo_appinfo_clone_appinfo(pkgmgrinfo_pkginfo_h handle, pkgmgrinfo_pkginfo_h *clone)
2444  * @brief       This API copy the application information handle
2445  *
2446  * @par         This API is for package-manager client application
2447  * @par Sync (or) Async : Synchronous API
2448  *
2449  * @param[in]   handle  pointer to the package info handle.
2450  * @param[out]  handle  pointer to the package info handle.
2451  * @return      0 if success, error code(<0) if fail
2452  * @retval      PMINFO_R_OK     success
2453  * @retval      PMINFO_R_EINVAL invalid argument
2454  * @retval      PMINFO_R_ERROR  internal error
2455  * @pre         None
2456  * @post        pkgmgrinfo_appinfo_destroy_appinfo()
2457  * @code
2458 static int get_appinfo_clone(pkgmgrinfo_pkginfo_h handle)
2459 {
2460         int ret = 0;
2461
2462         pkgmgrinfo_pkginfo_h clone;
2463
2464         ret = pkgmgrinfo_appinfo_clone_appinfo(handle, &clone);
2465         if (ret != PMINFO_R_OK)
2466                 return -1;
2467
2468
2469         printf("package: %s\n", clone->package);
2470         pkgmgrinfo_appinfo_destroy_appinfo(clone);
2471         return 0;
2472 }
2473  * @endcode
2474  */
2475 int pkgmgrinfo_appinfo_clone_appinfo(pkgmgrinfo_pkginfo_h handle, pkgmgrinfo_pkginfo_h *clone);
2476
2477
2478 /**
2479  * @fn  int pkgmgrinfo_appinfo_get_list(pkgmgrinfo_pkginfo_h handle, pkgmgrinfo_app_component component,
2480  pkgmgrinfo_app_list_cb app_func, void *user_data)
2481  * @brief       This API gets list of installed applications for a particular package
2482  *
2483  * @par         This API is for package-manager client application
2484  * @par Sync (or) Async : Synchronous API
2485  * @param[in]   handle          package info handle
2486  * @param[in]   component       application component
2487  * @param[in]   app_func                iteration function for list
2488  * @param[in] user_data user data to be passed to callback function
2489  * @return      0 if success, error code(<0) if fail
2490  * @retval      PMINFO_R_OK     success
2491  * @retval      PMINFO_R_EINVAL invalid argument
2492  * @retval      PMINFO_R_ERROR  internal error
2493  * @pre         pkgmgrinfo_pkginfo_get_pkginfo()
2494  * @post                pkgmgrinfo_pkginfo_destroy_pkginfo()
2495  * @code
2496 int app_func(pkgmgrinfo_appinfo_h handle, void *user_data)
2497 {
2498         char *appid = NULL;
2499         pkgmgrinfo_appinfo_get_appid(handle, &appid);
2500         printf("appid : %s\n", appid);
2501         return 0;
2502 }
2503
2504 static int list_apps(const char *pkgid)
2505 {
2506         int ret = 0;
2507         pkgmgrinfo_pkginfo_h handle;
2508         ret = pkgmgrinfo_pkginfo_get_pkginfo(pkgid, &handle);
2509         if (ret != PMINFO_R_OK)
2510                 return -1;
2511         ret = pkgmgrinfo_appinfo_get_list(handle, PMINFO_UI_APP, app_func, NULL);
2512         if (ret != PMINFO_R_OK) {
2513                 pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
2514                 return -1;
2515         }
2516         pkgmgrinfo_pkginfo_destroy_pkginfo(handle);
2517         return 0;
2518 }
2519  * @endcode
2520  */
2521 int pkgmgrinfo_appinfo_get_list(pkgmgrinfo_pkginfo_h handle, pkgmgrinfo_app_component component,
2522                                                         pkgmgrinfo_app_list_cb app_func, void *user_data);
2523 int pkgmgrinfo_appinfo_get_usr_list(pkgmgrinfo_pkginfo_h handle, pkgmgrinfo_app_component component,
2524                                                         pkgmgrinfo_app_list_cb app_func, void *user_data, uid_t uid);
2525
2526 /**
2527  * @fn  int pkgmgrinfo_appinfo_get_applist_for_amd(pkgmgrinfo_app_list_cb app_func, void *user_data);
2528  * @brief       This API gets list of installed applications from all packages with  minimum informaion.
2529  *
2530  * @par         This API is for package-manager client application
2531  * @par Sync (or) Async : Synchronous API
2532  * @param[in]   app_func                iteration function for list
2533  * @param[in] user_data user data to be passed to callback function
2534  * @return      0 if success, error code(<0) if fail
2535  * @retval      PMINFO_R_OK     success
2536  * @retval      PMINFO_R_EINVAL invalid argument
2537  * @retval      PMINFO_R_ERROR  internal error
2538  * @pre         None
2539  * @post                None
2540  * @code
2541 int app_list_cb(pkgmgrinfo_appinfo_h handle, void *user_data)
2542 {
2543         char *pkgid1 = NULL;
2544         char *pkgid2 = NULL;
2545         pkgid1 = (char *)user_data;
2546         pkgmgrinfo_appinfo_get_pkgid(handle, &pkgid2);
2547         if (strcmp(pkgid1, pkgid2) == 0) {
2548                 return -1;
2549         } else {
2550                 return 0;
2551         }
2552 }
2553
2554 static int list_apps()
2555 {
2556         int ret = 0;
2557         char *name = "helloworld";
2558         ret = pkgmgrinfo_appinfo_get_applist_for_amd(app_list_cb, (void *)name);
2559         if (ret != PMINFO_R_OK) {
2560                 return -1;
2561         }
2562         return 0;
2563 }
2564  * @endcode
2565  */
2566 int pkgmgrinfo_appinfo_get_usr_applist_for_amd(pkgmgrinfo_app_list_cb app_func, uid_t uid, void *user_data);
2567 int pkgmgrinfo_appinfo_get_applist_for_amd(pkgmgrinfo_app_list_cb app_func, void *user_data);
2568
2569 /**
2570  * @fn  int pkgmgrinfo_appinfo_get_installed_list(pkgmgrinfo_app_list_cb app_func, void *user_data);
2571  * @brief       This API gets list of installed applications from all packages.
2572  *
2573  * @par         This API is for package-manager client application
2574  * @par Sync (or) Async : Synchronous API
2575  * @param[in]   app_func                iteration function for list
2576  * @param[in] user_data user data to be passed to callback function
2577  * @return      0 if success, error code(<0) if fail
2578  * @retval      PMINFO_R_OK     success
2579  * @retval      PMINFO_R_EINVAL invalid argument
2580  * @retval      PMINFO_R_ERROR  internal error
2581  * @pre         None
2582  * @post                None
2583  * @code
2584 int app_list_cb(pkgmgrinfo_appinfo_h handle, void *user_data)
2585 {
2586         char *pkgid1 = NULL;
2587         char *pkgid2 = NULL;
2588         pkgid1 = (char *)user_data;
2589         pkgmgrinfo_appinfo_get_pkgid(handle, &pkgid2);
2590         if (strcmp(pkgid1, pkgid2) == 0) {
2591                 return -1;
2592         } else {
2593                 return 0;
2594         }
2595 }
2596
2597 static int list_apps()
2598 {
2599         int ret = 0;
2600         char *name = "helloworld";
2601         ret = pkgmgrinfo_appinfo_get_installed_list(app_list_cb, (void *)name);
2602         if (ret != PMINFO_R_OK) {
2603                 return -1;
2604         }
2605         return 0;
2606 }
2607  * @endcode
2608  */
2609 int pkgmgrinfo_appinfo_get_installed_list(pkgmgrinfo_app_list_cb app_func, void *user_data);
2610 int pkgmgrinfo_appinfo_get_usr_installed_list(pkgmgrinfo_app_list_cb app_func, uid_t uid, void *user_data);
2611
2612 /**
2613  * @fn int pkgmgrinfo_appinfo_get_disabled_appinfo(const char *appid, pkgmgrinfo_appinfo_h *handle)
2614  * @brief       This API creates the disabled application information handle from db
2615  *
2616  * @par         This API is for package-manager client application
2617  * @par Sync (or) Async : Synchronous API
2618  *
2619  * @param[in]   appid   pointer to appid
2620  * @param[out] handle           pointer to the application info handle.
2621  * @return      0 if success, error code(<0) if fail
2622  * @retval      PMINFO_R_OK     success
2623  * @retval      PMINFO_R_EINVAL invalid argument
2624  * @retval      PMINFO_R_ERROR  internal error
2625  * @pre         None
2626  * @post                pkgmgrinfo_appinfo_destroy_appinfo()
2627  * @see         pkgmgrinfo_appinfo_get_pkgid()
2628  * @see         pkgmgrinfo_appinfo_is_multiple()
2629  * @code
2630 static int get_disabled_app_type(const char *appid)
2631 {
2632         int ret = 0;
2633         char *type = NULL;
2634         pkgmgrinfo_appinfo_h handle;
2635         ret = pkgmgrinfo_appinfo_get_disabled_appinfo(appid, &handle);
2636         if (ret != PMINFO_R_OK)
2637                 return -1;
2638         ret = pkgmgrinfo_appinfo_get_apptype(handle, &type);
2639         if (ret != PMINFO_R_OK) {
2640                 pkgmgrinfo_appinfo_destroy_appinfo(handle);
2641                 return -1;
2642         }
2643         printf("apptype: %s\n", type);
2644         pkgmgrinfo_appinfo_destroy_appinfo(handle);
2645         return 0;
2646 }
2647  * @endcode
2648  */
2649 int pkgmgrinfo_appinfo_get_disabled_appinfo(const char *appid, pkgmgrinfo_appinfo_h *handle);
2650 int pkgmgrinfo_appinfo_get_usr_disabled_appinfo(const char *appid, uid_t uid, pkgmgrinfo_appinfo_h *handle);
2651
2652 /**
2653  * @fn int pkgmgrinfo_appinfo_get_appinfo(const char *appid, pkgmgrinfo_appinfo_h *handle)
2654  * @brief       This API creates the application information handle from db
2655  *
2656  * @par         This API is for package-manager client application
2657  * @par Sync (or) Async : Synchronous API
2658  *
2659  * @param[in]   appid   pointer to appid
2660  * @param[out] handle           pointer to the application info handle.
2661  * @return      0 if success, error code(<0) if fail
2662  * @retval      PMINFO_R_OK     success
2663  * @retval      PMINFO_R_EINVAL invalid argument
2664  * @retval      PMINFO_R_ERROR  internal error
2665  * @pre         None
2666  * @post                pkgmgrinfo_appinfo_destroy_appinfo()
2667  * @see         pkgmgrinfo_appinfo_get_pkgid()
2668  * @see         pkgmgrinfo_appinfo_is_multiple()
2669  * @code
2670 static int get_app_type(const char *appid)
2671 {
2672         int ret = 0;
2673         char *type = NULL;
2674         pkgmgrinfo_appinfo_h handle;
2675         ret = pkgmgrinfo_appinfo_get_appinfo(appid, &handle);
2676         if (ret != PMINFO_R_OK)
2677                 return -1;
2678         ret = pkgmgrinfo_appinfo_get_apptype(handle, &type);
2679         if (ret != PMINFO_R_OK) {
2680                 pkgmgrinfo_appinfo_destroy_appinfo(handle);
2681                 return -1;
2682         }
2683         printf("apptype: %s\n", type);
2684         pkgmgrinfo_appinfo_destroy_appinfo(handle);
2685         return 0;
2686 }
2687  * @endcode
2688  */
2689 int pkgmgrinfo_appinfo_get_appinfo(const char *appid, pkgmgrinfo_appinfo_h *handle);
2690 int pkgmgrinfo_appinfo_get_usr_appinfo(const char *appid, uid_t uid, pkgmgrinfo_appinfo_h *handle);
2691
2692 /**
2693  * @fn int pkgmgrinfo_appinfo_get_all_appinfo(const char *appid, pkgmgrinfo_appinfo_h *handle)
2694  * @brief       This API creates the application information handle from db regardless of its disable or storage status
2695  *
2696  * @par         This API is for package-manager client application
2697  * @par Sync (or) Async : Synchronous API
2698  *
2699  * @param[in]   appid   pointer to appid
2700  * @param[out] handle           pointer to the application info handle.
2701  * @return      0 if success, error code(<0) if fail
2702  * @retval      PMINFO_R_OK     success
2703  * @retval      PMINFO_R_EINVAL invalid argument
2704  * @retval      PMINFO_R_ERROR  internal error
2705  * @pre         None
2706  * @post                pkgmgrinfo_appinfo_destroy_appinfo()
2707  * @see         pkgmgrinfo_appinfo_get_pkgid()
2708  * @see         pkgmgrinfo_appinfo_is_multiple()
2709  * @code
2710 static int get_app_type(const char *appid)
2711 {
2712         int ret = 0;
2713         char *type = NULL;
2714         pkgmgrinfo_appinfo_h handle;
2715         ret = pkgmgrinfo_appinfo_get_all_appinfo(appid, &handle);
2716         if (ret != PMINFO_R_OK)
2717                 return -1;
2718         ret = pkgmgrinfo_appinfo_get_apptype(handle, &type);
2719         if (ret != PMINFO_R_OK) {
2720                 pkgmgrinfo_appinfo_destroy_appinfo(handle);
2721                 return -1;
2722         }
2723         printf("apptype: %s\n", type);
2724         pkgmgrinfo_appinfo_destroy_appinfo(handle);
2725         return 0;
2726 }
2727  * @endcode
2728  */
2729 int pkgmgrinfo_appinfo_get_all_appinfo(const char *appid, pkgmgrinfo_appinfo_h *handle);
2730 int pkgmgrinfo_appinfo_get_usr_all_appinfo(const char *appid, uid_t uid, pkgmgrinfo_appinfo_h *handle);
2731
2732 /**
2733  * @fn int pkgmgrinfo_appinfo_get_appid(pkgmgrinfo_appinfo_h handle, char **appid)
2734  * @brief       This API gets the application ID
2735  *
2736  * @par         This API is for package-manager client application
2737  * @par Sync (or) Async : Synchronous API
2738  *
2739  * @param[in] handle            pointer to the application info handle.
2740  * @param[out] appid            pointer to hold appid
2741  * @return      0 if success, error code(<0) if fail
2742  * @retval      PMINFO_R_OK     success
2743  * @retval      PMINFO_R_EINVAL invalid argument
2744  * @retval      PMINFO_R_ERROR  internal error
2745  * @pre         pkgmgrinfo_appinfo_get_appinfo()
2746  * @post                pkgmgrinfo_appinfo_destroy_appinfo()
2747  * @see         pkgmgrinfo_appinfo_get_pkgid()
2748  * @see         pkgmgrinfo_appinfo_is_multiple()
2749  * @code
2750 static int get_app_id(const char *appid)
2751 {
2752         int ret = 0;
2753         char *app_id = NULL;
2754         pkgmgrinfo_appinfo_h handle;
2755         ret = pkgmgrinfo_appinfo_get_appinfo(appid, &handle);
2756         if (ret != PMINFO_R_OK)
2757                 return -1;
2758         ret = pkgmgrinfo_appinfo_get_appid(handle, &app_id);
2759         if (ret != PMINFO_R_OK) {
2760                 pkgmgrinfo_appinfo_destroy_appinfo(handle);
2761                 return -1;
2762         }
2763         printf("app id: %s\n", app_id);
2764         pkgmgrinfo_appinfo_destroy_appinfo(handle);
2765         return 0;
2766 }
2767  * @endcode
2768  */
2769 int pkgmgrinfo_appinfo_get_appid(pkgmgrinfo_appinfo_h  handle, char **appid);
2770
2771 /**
2772  * @fn int pkgmgrinfo_appinfo_get_pkgname(pkgmgrinfo_appinfo_h handle, char **pkg_name)
2773  * @brief       This API gets the package name of the application
2774  *
2775  * @par         This API is for package-manager client application
2776  * @par Sync (or) Async : Synchronous API
2777  *
2778  * @param[in] handle            pointer to the application info handle.
2779  * @param[out] pkg_name         pointer to hold package name
2780  * @return      0 if success, error code(<0) if fail
2781  * @retval      PMINFO_R_OK     success
2782  * @retval      PMINFO_R_EINVAL invalid argument
2783  * @retval      PMINFO_R_ERROR  internal error
2784  * @pre         pkgmgrinfo_appinfo_get_appinfo()
2785  * @post                pkgmgrinfo_appinfo_destroy_appinfo()
2786  * @see         pkgmgrinfo_appinfo_get_appid()
2787  * @see         pkgmgrinfo_appinfo_is_multiple()
2788  * @code
2789 static int get_app_pkgname(const char *appid)
2790 {
2791         int ret = 0;
2792         char *pkgname = NULL;
2793         pkgmgrinfo_appinfo_h handle;
2794         ret = pkgmgrinfo_appinfo_get_appinfo(appid, &handle);
2795         if (ret != PMINFO_R_OK)
2796                 return -1;
2797         ret = pkgmgrinfo_appinfo_get_pkgname(handle, &pkgname);
2798         if (ret != PMINFO_R_OK) {
2799                 pkgmgrinfo_appinfo_destroy_appinfo(handle);
2800                 return -1;
2801         }
2802         printf("pkg name: %s\n", pkgname);
2803         pkgmgrinfo_appinfo_destroy_appinfo(handle);
2804         return 0;
2805 }
2806  * @endcode
2807  */
2808 int pkgmgrinfo_appinfo_get_pkgname(pkgmgrinfo_appinfo_h  handle, char **pkg_name);
2809
2810 /**
2811  * @fn int pkgmgrinfo_appinfo_get_pkgid(pkgmgrinfo_appinfo_h handle, char **pkgid)
2812  * @brief       This API gets the package id of the application
2813  *
2814  * @par         This API is for package-manager client application
2815  * @par Sync (or) Async : Synchronous API
2816  *
2817  * @param[in] handle            pointer to the application info handle.
2818  * @param[out] pkgid            pointer to hold package id
2819  * @return      0 if success, error code(<0) if fail
2820  * @retval      PMINFO_R_OK     success
2821  * @retval      PMINFO_R_EINVAL invalid argument
2822  * @retval      PMINFO_R_ERROR  internal error
2823  * @pre         pkgmgrinfo_appinfo_get_appinfo()
2824  * @post                pkgmgrinfo_appinfo_destroy_appinfo()
2825  * @see         pkgmgrinfo_appinfo_get_appid()
2826  * @see         pkgmgrinfo_appinfo_is_multiple()
2827  * @code
2828 static int get_app_pkgid(const char *appid)
2829 {
2830         int ret = 0;
2831         char *pkgid = NULL;
2832         pkgmgrinfo_appinfo_h handle;
2833         ret = pkgmgrinfo_appinfo_get_appinfo(appid, &handle);
2834         if (ret != PMINFO_R_OK)
2835                 return -1;
2836         ret = pkgmgrinfo_appinfo_get_pkgid(handle, &pkgid);
2837         if (ret != PMINFO_R_OK) {
2838                 pkgmgrinfo_appinfo_destroy_appinfo(handle);
2839                 return -1;
2840         }
2841         printf("pkg id: %s\n", pkgid);
2842         pkgmgrinfo_appinfo_destroy_appinfo(handle);
2843         return 0;
2844 }
2845  * @endcode
2846  */
2847 int pkgmgrinfo_appinfo_get_pkgid(pkgmgrinfo_appinfo_h  handle, char **pkgid);
2848
2849 /**
2850  * @fn int pkgmgrinfo_appinfo_get_pkgtype(pkgmgrinfo_appinfo_h handle, char **pkgtype)
2851  * @brief       This API gets the package type of the application
2852  *
2853  * @par         This API is for package-manager client application
2854  * @par Sync (or) Async : Synchronous API
2855  *
2856  * @param[in] handle            pointer to the application info handle.
2857  * @param[out] pkgtype          pointer to hold package type
2858  * @return      0 if success, error code(<0) if fail
2859  * @retval      PMINFO_R_OK     success
2860  * @retval      PMINFO_R_EINVAL invalid argument
2861  * @retval      PMINFO_R_ERROR  internal error
2862  * @pre         pkgmgrinfo_appinfo_get_appinfo()
2863  * @post                pkgmgrinfo_appinfo_destroy_appinfo()
2864  * @see         pkgmgrinfo_appinfo_get_appid()
2865  * @see         pkgmgrinfo_appinfo_is_multiple()
2866  * @code
2867 static int get_app_pkgtype(const char *appid)
2868 {
2869         int ret = 0;
2870         char *pkgtype = NULL;
2871         pkgmgrinfo_appinfo_h handle = NULL;
2872         ret = pkgmgrinfo_appinfo_get_appinfo(appid, &handle);
2873         if (ret != PMINFO_R_OK)
2874                 return -1;
2875         ret = pkgmgrinfo_appinfo_get_pkgtype(handle, &pkgtype);
2876         if (ret != PMINFO_R_OK) {
2877                 pkgmgrinfo_appinfo_destroy_appinfo(handle);
2878                 return -1;
2879         }
2880         printf("pkgtype: %s\n", pkgtype);
2881         pkgmgrinfo_appinfo_destroy_appinfo(handle);
2882         return 0;
2883 }
2884  * @endcode
2885  */
2886 int pkgmgrinfo_appinfo_get_pkgtype(pkgmgrinfo_appinfo_h  handle, char **pkgtype);
2887
2888 /**
2889  * @fn int pkgmgrinfo_appinfo_get_exec(pkgmgrinfo_appinfo_h handle, char **exec)
2890  * @brief       This API gets the executable name of the application
2891  *
2892  * @par         This API is for package-manager client application
2893  * @par Sync (or) Async : Synchronous API
2894  *
2895  * @param[in] handle            pointer to the application info handle.
2896  * @param[out] exec             pointer to hold app exec name
2897  * @return      0 if success, error code(<0) if fail
2898  * @retval      PMINFO_R_OK     success
2899  * @retval      PMINFO_R_EINVAL invalid argument
2900  * @retval      PMINFO_R_ERROR  internal error
2901  * @pre         pkgmgrinfo_appinfo_get_appinfo()
2902  * @post                pkgmgrinfo_appinfo_destroy_appinfo()
2903  * @see         pkgmgrinfo_appinfo_get_appid()
2904  * @see         pkgmgrinfo_appinfo_is_multiple()
2905  * @code
2906 static int get_app_exec(const char *appid)
2907 {
2908         int ret = 0;
2909         char *exec = NULL;
2910         pkgmgrinfo_appinfo_h handle;
2911         ret = pkgmgrinfo_appinfo_get_appinfo(appid, &handle);
2912         if (ret != PMINFO_R_OK)
2913                 return -1;
2914         ret = pkgmgrinfo_appinfo_get_exec(handle, &exec);
2915         if (ret != PMINFO_R_OK) {
2916                 pkgmgrinfo_appinfo_destroy_appinfo(handle);
2917                 return -1;
2918         }
2919         printf("exec name: %s\n", exec);
2920         pkgmgrinfo_appinfo_destroy_appinfo(handle);
2921         return 0;
2922 }
2923  * @endcode
2924  */
2925 int pkgmgrinfo_appinfo_get_exec(pkgmgrinfo_appinfo_h  handle, char **exec);
2926
2927 /**
2928  * @fn int pkgmgrinfo_appinfo_get_icon(pkgmgrinfo_appinfo_h handle, char **icon)
2929  * @brief       This API gets the icon name of the application
2930  *
2931  * @par         This API is for package-manager client application
2932  * @par Sync (or) Async : Synchronous API
2933  *
2934  * @param[in] handle            pointer to the application info handle.
2935  * @param[out] icon             pointer to hold app icon name
2936  * @return      0 if success, error code(<0) if fail
2937  * @retval      PMINFO_R_OK     success
2938  * @retval      PMINFO_R_EINVAL invalid argument
2939  * @retval      PMINFO_R_ERROR  internal error
2940  * @pre         pkgmgrinfo_appinfo_get_appinfo()
2941  * @post                pkgmgrinfo_appinfo_destroy_appinfo()
2942  * @see         pkgmgrinfo_appinfo_get_appid()
2943  * @see         pkgmgrinfo_appinfo_is_multiple()
2944  * @code
2945 static int get_app_icon(const char *appid)
2946 {
2947         int ret = 0;
2948         char *icon = NULL;
2949         pkgmgrinfo_appinfo_h handle;
2950         ret = pkgmgrinfo_appinfo_get_appinfo(appid, &handle);
2951         if (ret != PMINFO_R_OK)
2952                 return -1;
2953         ret = pkgmgrinfo_appinfo_get_icon(handle, &icon);
2954         if (ret != PMINFO_R_OK) {
2955                 pkgmgrinfo_appinfo_destroy_appinfo(handle);
2956                 return -1;
2957         }
2958         printf("icon name: %s\n", icon);
2959         pkgmgrinfo_appinfo_destroy_appinfo(handle);
2960         return 0;
2961 }
2962  * @endcode
2963  */
2964 int pkgmgrinfo_appinfo_get_icon(pkgmgrinfo_appinfo_h  handle, char **icon);
2965
2966 /**
2967  * @fn int pkgmgrinfo_appinfo_get_label(pkgmgrinfo_appinfo_h handle, char **label)
2968  * @brief       This API gets the label of the application
2969  *
2970  * @par         This API is for package-manager client application
2971  * @par Sync (or) Async : Synchronous API
2972  *
2973  * @param[in] handle            pointer to the application info handle.
2974  * @param[out] label            pointer to hold app label
2975  * @return      0 if success, error code(<0) if fail
2976  * @retval      PMINFO_R_OK     success
2977  * @retval      PMINFO_R_EINVAL invalid argument
2978  * @retval      PMINFO_R_ERROR  internal error
2979  * @pre         pkgmgrinfo_appinfo_get_appinfo()
2980  * @post                pkgmgrinfo_appinfo_destroy_appinfo()
2981  * @see         pkgmgrinfo_appinfo_get_appid()
2982  * @see         pkgmgrinfo_appinfo_is_multiple()
2983  * @code
2984 static int get_app_label(const char *appid)
2985 {
2986         int ret = 0;
2987         char *label = NULL;
2988         pkgmgrinfo_appinfo_h handle;
2989         ret = pkgmgrinfo_appinfo_get_appinfo(appid, &handle);
2990         if (ret != PMINFO_R_OK)
2991                 return -1;
2992         ret = pkgmgrinfo_appinfo_get_label(handle, &label);
2993         if (ret != PMINFO_R_OK) {
2994                 pkgmgrinfo_appinfo_destroy_appinfo(handle);
2995                 return -1;
2996         }
2997         printf("label : %s\n", label);
2998         pkgmgrinfo_appinfo_destroy_appinfo(handle);
2999         return 0;
3000 }
3001  * @endcode
3002  */
3003 int pkgmgrinfo_appinfo_get_label(pkgmgrinfo_appinfo_h  handle, char **label);
3004
3005 /**
3006  * @fn int pkgmgrinfo_appinfo_get_localed_label(const char *appid, const char *locale, char **label)
3007  * @brief       This API gets exactly matched label by given appid and locale
3008  *
3009  * @par         This API is for package-manager client application
3010  * @par Sync (or) Async : Synchronous API
3011  *
3012  * @param[in]   appid   pointer to appid
3013  * @param[in]   locale  pointer to locale
3014  * @param[out] label            pointer to hold app label
3015  * @return      0 if success, error code(<0) if fail
3016  * @retval      PMINFO_R_OK     success
3017  * @retval      PMINFO_R_EINVAL invalid argument
3018  * @retval      PMINFO_R_ERROR  internal error
3019  * @code
3020 static int get_localed_label(const char *appid, const char *locale)
3021 {
3022         int ret = 0;
3023         char *label = NULL;
3024
3025         ret = pkgmgrinfo_appinfo_get_localed_label(appid, locale, &label);
3026         if (ret != PMINFO_R_OK)
3027                 return -1;
3028
3029         printf("localed label: %s\n", label);
3030
3031         free(label);
3032
3033         return 0;
3034 }
3035  * @endcode
3036  */
3037 int pkgmgrinfo_appinfo_get_localed_label(const char *appid, const char *locale, char **label);
3038 int pkgmgrinfo_appinfo_usr_get_localed_label(const char *appid, const char *locale, uid_t uid, char **label);
3039
3040 /**
3041  * @fn int pkgmgrinfo_appinfo_get_metadata_value(pkgmgrinfo_appinfo_h handle, const char *metadata_key, char **metadata_value)
3042  * @brief       This API gets metadata value by given metadata key
3043  *
3044  * @par         This API is for package-manager client application
3045  * @par Sync (or) Async : Synchronous API
3046  *
3047  * @param[in]   handle  pointer to the application info handle
3048  * @param[in]   metadata_key    metadata key
3049  * @param[out] metadata_value           pointer to hold metadata value
3050  * @return      0 if success, error code(<0) if fail
3051  * @retval      PMINFO_R_OK     success
3052  * @retval      PMINFO_R_EINVAL invalid argument
3053  * @code
3054 static int get_metadata_value(const char *appid, const char *metadata_key)
3055 {
3056         int ret = 0;
3057         pkgmgrinfo_appinfo_h handle = NULL;
3058         char *metadata_value = NULL;
3059
3060         ret = pkgmgrinfo_appinfo_get_appinfo(appid, &handle);
3061         if (ret != PMINFO_R_OK)
3062                 return -1;
3063
3064         ret = pkgmgrinfo_appinfo_get_metadata_value(handle, metadata_key, &metadata_value);
3065         if (ret != PMINFO_R_OK) {
3066                 pkgmgrinfo_appinfo_destroy_appinfo(handle);
3067                 return -1;
3068         }
3069
3070         pkgmgrinfo_appinfo_destroy_appinfo(handle);
3071         return 0;
3072 }
3073  * @endcode
3074  */
3075 int pkgmgrinfo_appinfo_get_metadata_value(pkgmgrinfo_appinfo_h handle, const char *metadata_key, char **metadata_value);
3076
3077 /**
3078  * @fn int pkgmgrinfo_appinfo_get_component(pkgmgrinfo_appinfo_h handle, pkgmgrinfo_app_component *component)
3079  * @brief       This API gets the component of the application
3080  *
3081  * @par         This API is for package-manager client application
3082  * @par Sync (or) Async : Synchronous API
3083  *
3084  * @param[in] handle            pointer to the application info handle.
3085  * @param[out] component                pointer to hold app component
3086  * @return      0 if success, error code(<0) if fail
3087  * @retval      PMINFO_R_OK     success
3088  * @retval      PMINFO_R_EINVAL invalid argument
3089  * @retval      PMINFO_R_ERROR  internal error
3090  * @pre         pkgmgrinfo_appinfo_get_appinfo()
3091  * @post                pkgmgrinfo_appinfo_destroy_appinfo()
3092  * @see         pkgmgrinfo_appinfo_get_appid()
3093  * @see         pkgmgrinfo_appinfo_is_multiple()
3094  * @code
3095 static int get_app_component(const char *appid)
3096 {
3097         int ret = 0;
3098         pkgmgrinfo_app_component component;
3099         pkgmgrinfo_appinfo_h handle;
3100         ret = pkgmgrinfo_appinfo_get_appinfo(appid, &handle);
3101         if (ret != PMINFO_R_OK)
3102                 return -1;
3103         ret = pkgmgrinfo_appinfo_get_component(handle, &component);
3104         if (ret != PMINFO_R_OK) {
3105                 pkgmgrinfo_appinfo_destroy_appinfo(handle);
3106                 return -1;
3107         }
3108         printf("component : %s\n", component);
3109         pkgmgrinfo_appinfo_destroy_appinfo(handle);
3110         return 0;
3111 }
3112  * @endcode
3113  */
3114 int pkgmgrinfo_appinfo_get_component(pkgmgrinfo_appinfo_h  handle, pkgmgrinfo_app_component *component);
3115
3116 /**
3117  * @fn int pkgmgrinfo_appinfo_get_apptype(pkgmgrinfo_appinfo_h handle, char **app_type)
3118  * @brief       This API gets the apptype of the application
3119  *
3120  * @par         This API is for package-manager client application
3121  * @par Sync (or) Async : Synchronous API
3122  *
3123  * @param[in] handle            pointer to the application info handle.
3124  * @param[out] app_type         pointer to hold apptype
3125  * @return      0 if success, error code(<0) if fail
3126  * @retval      PMINFO_R_OK     success
3127  * @retval      PMINFO_R_EINVAL invalid argument
3128  * @retval      PMINFO_R_ERROR  internal error
3129  * @pre         pkgmgrinfo_appinfo_get_appinfo()
3130  * @post                pkgmgrinfo_appinfo_destroy_appinfo()
3131  * @see         pkgmgrinfo_appinfo_get_appid()
3132  * @see         pkgmgrinfo_appinfo_is_multiple()
3133  * @code
3134 static int get_app_type(const char *appid)
3135 {
3136         int ret = 0;
3137         char *apptype = NULL;
3138         pkgmgrinfo_appinfo_h handle;
3139         ret = pkgmgrinfo_appinfo_get_appinfo(appid, &handle);
3140         if (ret != PMINFO_R_OK)
3141                 return -1;
3142         ret = pkgmgrinfo_appinfo_get_apptype(handle, &apptype);
3143         if (ret != PMINFO_R_OK) {
3144                 pkgmgrinfo_appinfo_destroy_appinfo(handle);
3145                 return -1;
3146         }
3147         printf("apptype : %s\n", apptype);
3148         pkgmgrinfo_appinfo_destroy_appinfo(handle);
3149         return 0;
3150 }
3151  * @endcode
3152  */
3153 int pkgmgrinfo_appinfo_get_apptype(pkgmgrinfo_appinfo_h  handle, char **app_type);
3154
3155 /**
3156  * @fn int pkgmgrinfo_appinfo_get_operation(pkgmgrinfo_appcontrol_h  handle,
3157                                                                                 int *operation_count, char ***operation)
3158  * @brief       This API gets the list of operation of the application
3159  *
3160  * @par         This API is for package-manager client application
3161  * @par Sync (or) Async : Synchronous API
3162  *
3163  * @param[in] handle            pointer to the appcontrol handle.
3164  * @param[out] operation_count          pointer to hold number of operations
3165  * @param[out] operation                pointer to hold list of operations
3166  * @return      0 if success, error code(<0) if fail
3167  * @retval      PMINFO_R_OK     success
3168  * @retval      PMINFO_R_EINVAL invalid argument
3169  * @retval      PMINFO_R_ERROR  internal error
3170  * @pre         pkgmgrinfo_appinfo_get_appinfo()
3171  * @post                pkgmgrinfo_appinfo_destroy_appinfo()
3172  * @see         pkgmgrinfo_appinfo_get_uri()
3173  * @see         pkgmgrinfo_appinfo_get_mime()
3174  * @code
3175 int appcontrol_func(pkgmgrinfo_appcontrol_h handle, void *user_data)
3176 {
3177         int oc = 0;
3178         int i = 0;
3179         char **operation;
3180         pkgmgrinfo_appinfo_get_operation(handle, &oc, &operation);
3181         for (i = 0; i < oc; i++) {
3182                 if (strcmp(operation[i], (char *)user_data) == 0)
3183                         return -1;
3184                 else
3185                         return 0;
3186         }
3187 }
3188
3189 static int check_operation(const char *appid, char *operation)
3190 {
3191         int ret = 0;
3192         pkgmgrinfo_appinfo_h handle;
3193         ret = pkgmgrinfo_appinfo_get_appinfo(appid, &handle);
3194         if (ret != PMINFO_R_OK)
3195                 return -1;
3196         ret = pkgmgrinfo_appinfo_foreach_appcontrol(handle, appcontrol_func, (void *)operation);
3197         if (ret != PMINFO_R_OK) {
3198                 pkgmgrinfo_appinfo_destroy_appinfo(handle);
3199                 return -1;
3200         }
3201         pkgmgrinfo_appinfo_destroy_appinfo(handle);
3202         return 0;
3203 }
3204  * @endcode
3205  */
3206 int pkgmgrinfo_appinfo_get_operation(pkgmgrinfo_appcontrol_h  handle,
3207                                                                                 int *operation_count, char ***operation);
3208
3209 /**
3210  * @fn int pkgmgrinfo_appinfo_get_uri(pkgmgrinfo_appcontrol_h  handle,
3211                                                                                 int *uri_count, char ***uri)
3212  * @brief       This API gets the list of uri of the application
3213  *
3214  * @par         This API is for package-manager client application
3215  * @par Sync (or) Async : Synchronous API
3216  *
3217  * @param[in] handle            pointer to the appcontrol handle.
3218  * @param[out] uri_count                pointer to hold number of uris
3219  * @param[out] uri              pointer to hold list of uris
3220  * @return      0 if success, error code(<0) if fail
3221  * @retval      PMINFO_R_OK     success
3222  * @retval      PMINFO_R_EINVAL invalid argument
3223  * @retval      PMINFO_R_ERROR  internal error
3224  * @pre         pkgmgrinfo_appinfo_get_appinfo()
3225  * @post                pkgmgrinfo_appinfo_destroy_appinfo()
3226  * @see         pkgmgrinfo_appinfo_get_operation()
3227  * @see         pkgmgrinfo_appinfo_get_mime()
3228  * @code
3229 int appcontrol_func(pkgmgrinfo_appcontrol_h handle, void *user_data)
3230 {
3231         int uc = 0;
3232         int i = 0;
3233         char **uri;
3234         pkgmgrinfo_appinfo_get_uri(handle, &uc, &uri);
3235         for (i = 0; i < uc; i++) {
3236                 if (strcmp(uri[i], (char *)user_data) == 0)
3237                         return -1;
3238                 else
3239                         return 0;
3240         }
3241 }
3242
3243 static int check_uri(const char *appid, char *uri)
3244 {
3245         int ret = 0;
3246         pkgmgrinfo_appinfo_h handle;
3247         ret = pkgmgrinfo_appinfo_get_appinfo(appid, &handle);
3248         if (ret != PMINFO_R_OK)
3249                 return -1;
3250         ret = pkgmgrinfo_appinfo_foreach_appcontrol(handle, appcontrol_func, (void *)uri);
3251         if (ret != PMINFO_R_OK) {
3252                 pkgmgrinfo_appinfo_destroy_appinfo(handle);
3253                 return -1;
3254         }
3255         pkgmgrinfo_appinfo_destroy_appinfo(handle);
3256         return 0;
3257 }
3258  * @endcode
3259  */
3260 int pkgmgrinfo_appinfo_get_uri(pkgmgrinfo_appcontrol_h  handle,
3261                                                                                 int *uri_count, char ***uri);
3262
3263 /**
3264  * @fn int pkgmgrinfo_appinfo_get_mime(pkgmgrinfo_appcontrol_h  handle,
3265                                                                                 int *mime_count, char ***mime)
3266  * @brief       This API gets the list of mime of the application
3267  *
3268  * @par         This API is for package-manager client application
3269  * @par Sync (or) Async : Synchronous API
3270  *
3271  * @param[in] handle            pointer to the appcontrol handle.
3272  * @param[out] mime_count               pointer to hold number of mimes
3273  * @param[out] mime             pointer to hold list of mimes
3274  * @return      0 if success, error code(<0) if fail
3275  * @retval      PMINFO_R_OK     success
3276  * @retval      PMINFO_R_EINVAL invalid argument
3277  * @retval      PMINFO_R_ERROR  internal error
3278  * @pre         pkgmgrinfo_appinfo_get_appinfo()
3279  * @post                pkgmgrinfo_appinfo_destroy_appinfo()
3280  * @see         pkgmgrinfo_appinfo_get_uri()
3281  * @see         pkgmgrinfo_appinfo_get_operation()
3282  * @code
3283 int appcontrol_func(pkgmgrinfo_appcontrol_h handle, void *user_data)
3284 {
3285         int mc = 0;
3286         int i = 0;
3287         char **mime;
3288         pkgmgrinfo_appinfo_get_operation(handle, &mc, &mime);
3289         for (i = 0; i < mc; i++) {
3290                 if (strcmp(mime[i], (char *)user_data) == 0)
3291                         return -1;
3292                 else
3293                         return 0;
3294         }
3295 }
3296
3297 static int check_mime(const char *appid, char *mime)
3298 {
3299         int ret = 0;
3300         pkgmgrinfo_appinfo_h handle;
3301         ret = pkgmgrinfo_appinfo_get_appinfo(appid, &handle);
3302         if (ret != PMINFO_R_OK)
3303                 return -1;
3304         ret = pkgmgrinfo_appinfo_foreach_appcontrol(handle, appcontrol_func, (void *)mime);
3305         if (ret != PMINFO_R_OK) {
3306                 pkgmgrinfo_appinfo_destroy_appinfo(handle);
3307                 return -1;
3308         }
3309         pkgmgrinfo_appinfo_destroy_appinfo(handle);
3310         return 0;
3311 }
3312  * @endcode
3313  */
3314 int pkgmgrinfo_appinfo_get_mime(pkgmgrinfo_appcontrol_h  handle,
3315                                                                                 int *mime_count, char ***mime);
3316
3317 /**
3318  * @fn int pkgmgrinfo_appinfo_get_subapp(pkgmgrinfo_appcontrol_h  handle,
3319                                                                                 int *subapp_count, char ***subapp)
3320  * @brief       This API gets the list of subapp of the application
3321  *
3322  * @par         This API is for package-manager client application
3323  * @par Sync (or) Async : Synchronous API
3324  *
3325  * @param[in] handle            pointer to the appcontrol handle.
3326  * @param[out] subapp_count             pointer to hold number of subapp
3327  * @param[out] subapp           pointer to hold list of subapp
3328  * @return      0 if success, error code(<0) if fail
3329  * @retval      PMINFO_R_OK     success
3330  * @retval      PMINFO_R_EINVAL invalid argument
3331  * @retval      PMINFO_R_ERROR  internal error
3332  * @pre         pkgmgrinfo_appinfo_get_appinfo()
3333  * @post                pkgmgrinfo_appinfo_destroy_appinfo()
3334  * @see         pkgmgrinfo_appinfo_get_uri()
3335  * @see         pkgmgrinfo_appinfo_get_operation()
3336  * @code
3337 int appcontrol_func(pkgmgrinfo_appcontrol_h handle, void *user_data)
3338 {
3339         int sc = 0;
3340         int i = 0;
3341         char **subapp = NULL;
3342         pkgmgrinfo_appinfo_get_subapp(handle, &sc, &subapp);
3343         for (i = 0; i < sc; i++) {
3344                 if (strcmp(subapp[i], (char *)user_data) == 0)
3345                         return -1;
3346                 else
3347                         return 0;
3348         }
3349 }
3350
3351 static int check_subapp(const char *appid, char *subapp)
3352 {
3353         int ret = 0;
3354         pkgmgrinfo_appinfo_h handle = NULL;
3355         ret = pkgmgrinfo_appinfo_get_appinfo(appid, &handle);
3356         if (ret != PMINFO_R_OK)
3357                 return -1;
3358         ret = pkgmgrinfo_appinfo_foreach_appcontrol(handle, appcontrol_func, (void *)subapp);
3359         if (ret != PMINFO_R_OK) {
3360                 pkgmgrinfo_appinfo_destroy_appinfo(handle);
3361                 return -1;
3362         }
3363         pkgmgrinfo_appinfo_destroy_appinfo(handle);
3364         return 0;
3365 }
3366  * @endcode
3367  */
3368 int pkgmgrinfo_appinfo_get_subapp(pkgmgrinfo_appcontrol_h  handle,
3369                                                 int *subapp_count, char ***subapp);
3370
3371 /**
3372  * @fn int pkgmgrinfo_appinfo_get_notification_icon(pkgmgrinfo_appinfo_h handle, char **icon)
3373  * @brief       This API gets the notification icon of the application
3374  *
3375  * @par         This API is for package-manager client application
3376  * @par Sync (or) Async : Synchronous API
3377  *
3378  * @param[in] handle            pointer to the application info handle.
3379  * @param[out] path             pointer to hold notification icon
3380  * @return      0 if success, error code(<0) if fail
3381  * @retval      PMINFO_R_OK     success
3382  * @retval      PMINFO_R_EINVAL invalid argument
3383  * @retval      PMINFO_R_ERROR  internal error
3384  * @pre         pkgmgrinfo_appinfo_get_appinfo()
3385  * @post                pkgmgrinfo_appinfo_destroy_appinfo()
3386  * @see         pkgmgrinfo_appinfo_get_appid()
3387  * @see         pkgmgrinfo_appinfo_is_multiple()
3388  * @code
3389 static int get_app_notification_icon(const char *appid)
3390 {
3391         int ret = 0;
3392         char *notification_icon = NULL;
3393         pkgmgrinfo_appinfo_h handle;
3394         ret = pkgmgrinfo_appinfo_get_appinfo(appid, &handle);
3395         if (ret != PMINFO_R_OK)
3396                 return -1;
3397         ret = pkgmgrinfo_appinfo_get_notification_icon(handle, &notification_icon);
3398         if (ret != PMINFO_R_OK) {
3399                 pkgmgrinfo_appinfo_destroy_appinfo(handle);
3400                 return -1;
3401         }
3402         printf("notification icon : %s\n", notification_icon);
3403         pkgmgrinfo_appinfo_destroy_appinfo(handle);
3404         return 0;
3405 }
3406  * @endcode
3407  */
3408 int pkgmgrinfo_appinfo_get_notification_icon(pkgmgrinfo_appinfo_h  handle, char **icon);
3409
3410 /**
3411  * @fn int pkgmgrinfo_appinfo_get_setting_icon(pkgmgrinfo_appinfo_h handle, char **icon)
3412  * @brief       This API gets the setting icon of the application
3413  *
3414  * @par         This API is for package-manager client application
3415  * @par Sync (or) Async : Synchronous API
3416  *
3417  * @param[in] handle            pointer to the application info handle.
3418  * @param[out] path             pointer to hold setting icon
3419  * @return      0 if success, error code(<0) if fail
3420  * @retval      PMINFO_R_OK     success
3421  * @retval      PMINFO_R_EINVAL invalid argument
3422  * @retval      PMINFO_R_ERROR  internal error
3423  * @pre         pkgmgrinfo_appinfo_get_appinfo()
3424  * @post                pkgmgrinfo_appinfo_destroy_appinfo()
3425  * @see         pkgmgrinfo_appinfo_get_appid()
3426  * @see         pkgmgrinfo_appinfo_is_multiple()
3427  * @code
3428 static int get_app_setting_icon(const char *appid)
3429 {
3430         int ret = 0;
3431         char *setting_icon = NULL;
3432         pkgmgrinfo_appinfo_h handle;
3433         ret = pkgmgrinfo_appinfo_get_appinfo(appid, &handle);
3434         if (ret != PMINFO_R_OK)
3435                 return -1;
3436         ret = pkgmgrinfo_appinfo_get_setting_icon(handle, &setting_icon);
3437         if (ret != PMINFO_R_OK) {
3438                 pkgmgrinfo_appinfo_destroy_appinfo(handle);
3439                 return -1;
3440         }
3441         printf("setting icon : %s\n", setting_icon);
3442         pkgmgrinfo_appinfo_destroy_appinfo(handle);
3443         return 0;
3444 }
3445  * @endcode
3446  */
3447 int pkgmgrinfo_appinfo_get_setting_icon(pkgmgrinfo_appinfo_h  handle, char **icon);
3448
3449 /**
3450  * @fn int pkgmgrinfo_appinfo_get_recent_image_type(pkgmgrinfo_appinfo_h handle, pkgmgrinfo_app_recentimage *type)
3451  * @brief       This API gets the type of recent image on app-tray
3452  *
3453  * @par         This API is for package-manager client application
3454  * @par Sync (or) Async : Synchronous API
3455  *
3456  * @param[in] handle            pointer to the application info handle.
3457  * @param[out] type             pointer to hold image type
3458  * @return      0 if success, error code(<0) if fail
3459  * @retval      PMINFO_R_OK     success
3460  * @retval      PMINFO_R_EINVAL invalid argument
3461  * @retval      PMINFO_R_ERROR  internal error
3462  * @pre         pkgmgrinfo_appinfo_get_appinfo()
3463  * @post                pkgmgrinfo_appinfo_destroy_appinfo()
3464  * @see         pkgmgrinfo_appinfo_get_appid()
3465  * @see         pkgmgrinfo_appinfo_is_multiple()
3466  * @code
3467 static int get_app_recent_image_type(const char *appid)
3468 {
3469         int ret = 0;
3470         pkgmgrinfo_app_recentimage type;
3471         pkgmgrinfo_appinfo_h handle;
3472         ret = pkgmgrinfo_appinfo_get_appinfo(appid, &handle);
3473         if (ret != PMINFO_R_OK)
3474                 return -1;
3475         ret = pkgmgrinfo_appinfo_get_recent_image_type(handle, &type);
3476         if (ret != PMINFO_R_OK) {
3477                 pkgmgrinfo_appinfo_destroy_appinfo(handle);
3478                 return -1;
3479         }
3480         printf("recent image type: %d\n", type);
3481         pkgmgrinfo_appinfo_destroy_appinfo(handle);
3482         return 0;
3483 }
3484  * @endcode
3485  */
3486 int pkgmgrinfo_appinfo_get_recent_image_type(pkgmgrinfo_appinfo_h  handle, pkgmgrinfo_app_recentimage *type);
3487
3488
3489 /**
3490  * @fn int pkgmgrinfo_appinfo_get_preview_image(pkgmgrinfo_appinfo_h  handle, char **preview_img)
3491  * @brief       This API gets the preview image of application
3492  *
3493  * @par Sync (or) Async : Synchronous API
3494  *
3495  * @param[in] handle            pointer to the application info handle.
3496  * @param[out] preview_img              pointer to hold preview image path
3497  * @return      0 if success, error code(<0) if fail
3498  * @retval      PMINFO_R_OK     success
3499  * @retval      PMINFO_R_EINVAL invalid argument
3500  * @retval      PMINFO_R_ERROR  internal error
3501  * @pre         pkgmgrinfo_appinfo_get_appinfo()
3502  * @post                pkgmgrinfo_appinfo_destroy_appinfo()
3503  * @see         pkgmgrinfo_appinfo_get_appid()
3504  * @code
3505 static int get_app_previewimage(const char *appid)
3506 {
3507         int ret = 0;
3508         char *preview = NULL;
3509         pkgmgrinfo_appinfo_h handle = NULL;
3510         ret = pkgmgrinfo_appinfo_get_appinfo(appid, &handle);
3511         if (ret != PMINFO_R_OK)
3512                 return -1;
3513         ret = pkgmgrinfo_appinfo_get_preview_image(handle, &preview);
3514         if (ret != PMINFO_R_OK) {
3515                 pkgmgrinfo_appinfo_destroy_appinfo(handle);
3516                 return -1;
3517         }
3518         printf("preview image path : %s\n", preview);
3519         pkgmgrinfo_appinfo_destroy_appinfo(handle);
3520         return 0;
3521 }
3522  * @endcode
3523  */
3524 int pkgmgrinfo_appinfo_get_preview_image(pkgmgrinfo_appinfo_h  handle, char **preview_img);
3525
3526
3527 /**
3528  * @fn int pkgmgrinfo_appinfo_get_permission_type(pkgmgrinfo_appinfo_h handle, pkgmgrinfo_permission_type *permission)
3529  * @brief       This API gets the package permission type of the application
3530  *
3531  * @par         This API is for package-manager client application
3532  * @par Sync (or) Async : Synchronous API
3533  *
3534  * @param[in] handle            pointer to the application info handle.
3535  * @param[out] permission               pointer to hold package permission
3536  * @return      0 if success, error code(<0) if fail
3537  * @retval      PMINFO_R_OK     success
3538  * @retval      PMINFO_R_EINVAL invalid argument
3539  * @retval      PMINFO_R_ERROR  internal error
3540  * @pre         pkgmgrinfo_appinfo_get_appinfo()
3541  * @post                pkgmgrinfo_appinfo_destroy_appinfo()
3542  * @see         pkgmgrinfo_appinfo_get_appid()
3543  * @code
3544 static int get_app_permission(const char *appid)
3545 {
3546         int ret = 0;
3547         pkgmgrinfo_permission_type permission = 0;
3548         pkgmgrinfo_appinfo_h handle;
3549
3550         ret = pkgmgrinfo_appinfo_get_appinfo(appid, &handle);
3551         if (ret != PMINFO_R_OK)
3552                 return -1;
3553         ret = pkgmgrinfo_appinfo_get_permission_type(handle, &permission);
3554         if (ret != PMINFO_R_OK) {
3555                 pkgmgrinfo_appinfo_destroy_appinfo(handle);
3556                 return -1;
3557         }
3558         printf("permission type: %d\n", permission);
3559         pkgmgrinfo_appinfo_destroy_appinfo(handle);
3560         return 0;
3561 }
3562  * @endcode
3563  */
3564 int pkgmgrinfo_appinfo_get_permission_type(pkgmgrinfo_appinfo_h handle, pkgmgrinfo_permission_type *permission);
3565
3566 /**
3567  * @fn int pkgmgrinfo_appinfo_get_component_type(pkgmgrinfo_appinfo_h handle, char **component_type)
3568  * @brief       This API gets the component_type
3569  *
3570  * @par         This API is for package-manager client application
3571  * @par Sync (or) Async : Synchronous API
3572  *
3573  * @param[in] handle            pointer to the application info handle.
3574  * @param[out] component_type           pointer to hold component_type
3575  * @return      0 if success, error code(<0) if fail
3576  * @retval      PMINFO_R_OK     success
3577  * @retval      PMINFO_R_EINVAL invalid argument
3578  * @retval      PMINFO_R_ERROR  internal error
3579  * @pre         pkgmgrinfo_appinfo_get_appinfo()
3580  * @post        pkgmgrinfo_appinfo_destroy_appinfo()
3581  * @see         pkgmgrinfo_appinfo_get_pkgid()
3582  * @see         pkgmgrinfo_appinfo_is_multiple()
3583  * @code
3584 static int get_component_type(const char *appid)
3585 {
3586         int ret = 0;
3587         char *component_type = NULL;
3588         pkgmgrinfo_appinfo_h handle;
3589         ret = pkgmgrinfo_appinfo_get_appinfo(appid, &handle);
3590         if (ret != PMINFO_R_OK)
3591                 return -1;
3592         ret = pkgmgrinfo_appinfo_get_component_type(handle, &component_type);
3593         if (ret != PMINFO_R_OK) {
3594                 pkgmgrinfo_appinfo_destroy_appinfo(handle);
3595                 return -1;
3596         }
3597         printf("component_type: %s\n", component_type);
3598         pkgmgrinfo_appinfo_destroy_appinfo(handle);
3599         return 0;
3600 }
3601  * @endcode
3602  */
3603 int pkgmgrinfo_appinfo_get_component_type(pkgmgrinfo_appinfo_h  handle, char **component_type);
3604
3605 /**
3606  * @fn int pkgmgrinfo_appinfo_get_hwacceleration(pkgmgrinfo_appinfo_h handle, pkgmgrinfo_app_hwacceleration *hwacceleration)
3607  * @brief       This API gets the application 'hwacceleration' value from the app ID
3608  *
3609  * @par         This API is for package-manager client application
3610  * @par Sync (or) Async : Synchronous API
3611  *
3612  * @param[in]   handle  pointer to application info handle
3613  * @param[out] hwacceleration           pointer to hold package hwacceleration value
3614  * @return      0 if success, error code(<0) if fail
3615  * @retval      PMINFO_R_OK     success
3616  * @retval      PMINFO_R_EINVAL invalid argument
3617  * @retval      PMINFO_R_ERROR  internal error
3618  * @pre         pkgmgrinfo_appinfo_get_appinfo()
3619  * @post        pkgmgrinfo_appinfo_destroy_appinfo()
3620  * @see         pkgmgrinfo_appinfo_get_appid()
3621  * @see         pkgmgrinfo_appinfo_is_multiple()
3622  * @code
3623 static int get_app_hwacceleration(const char *appid)
3624 {
3625         int ret = 0;
3626         pkgmgrinfo_app_hwacceleration hwacceleration;
3627         pkgmgrinfo_appinfo_h handle;
3628         ret = pkgmgrinfo_appinfo_get_appinfo(appid, &handle);
3629         if (ret != PMINFO_R_OK)
3630                 return -1;
3631         ret = pkgmgrinfo_appinfo_get_hwacceleration(handle, &hwacceleration);
3632         if (ret != PMINFO_R_OK) {
3633                 pkgmgrinfo_appinfo_destroy_appinfo(handle);
3634                 return -1;
3635         }
3636         printf("app hwacceleration: %d\n", hwacceleration);
3637         pkgmgrinfo_appinfo_destroy_appinfo(handle);
3638         return 0;
3639 }
3640  * @endcode
3641  */
3642 int pkgmgrinfo_appinfo_get_hwacceleration(pkgmgrinfo_appinfo_h  handle, pkgmgrinfo_app_hwacceleration *hwacceleration);
3643
3644 /**
3645  * @fn int pkgmgrinfo_appinfo_get_screenreader(pkgmgrinfo_appinfo_h  handle, pkgmgrinfo_app_screenreader *screenreader)
3646  * @brief       This API gets the application 'screenreader' value from the app ID
3647  *
3648  * @par         This API is for package-manager client application
3649  * @par Sync (or) Async : Synchronous API
3650  *
3651  * @param[in]   handle  pointer to application info handle
3652  * @param[out] screenreader             pointer to hold package accessibility value
3653  * @return      0 if success, error code(<0) if fail
3654  * @retval      PMINFO_R_OK     success
3655  * @retval      PMINFO_R_EINVAL invalid argument
3656  * @retval      PMINFO_R_ERROR  internal error
3657  * @pre         pkgmgrinfo_appinfo_get_appinfo()
3658  * @post        pkgmgrinfo_appinfo_destroy_appinfo()
3659  * @see         pkgmgrinfo_appinfo_get_appid()
3660  * @see         pkgmgrinfo_appinfo_is_multiple()
3661  * @code
3662 static int get_app_screenreader(const char *appid)
3663 {
3664         int ret = 0;
3665         pkgmgrinfo_app_screenreader screenreader = PMINFO_USE_SYSTEM_SETTING;
3666         pkgmgrinfo_appinfo_h handle = NULL;
3667         ret = pkgmgrinfo_appinfo_get_appinfo(appid, &handle);
3668         if (ret != PMINFO_R_OK)
3669                 return -1;
3670         ret = pkgmgrinfo_appinfo_get_screenreader(handle, &screenreader);
3671         if (ret != PMINFO_R_OK) {
3672                 pkgmgrinfo_appinfo_destroy_appinfo(handle);
3673                 return -1;
3674         }
3675         printf("app screenreader: %d\n", screenreader);
3676         pkgmgrinfo_appinfo_destroy_appinfo(handle);
3677         return 0;
3678 }
3679  * @endcode
3680  */
3681 int pkgmgrinfo_appinfo_get_screenreader(pkgmgrinfo_appinfo_h  handle, pkgmgrinfo_app_screenreader *screenreader);
3682
3683 /**
3684  * @fn int pkgmgrinfo_appinfo_get_effectimage(pkgmgrinfo_appinfo_h  handle, char **portrait_img, char **landscape_img)
3685  * @brief       This API gets the application's landscape & portrait effect images
3686  *
3687  * @par         This API is for package-manager client application
3688  * @par Sync (or) Async : Synchronous API
3689  *
3690  * @param[in]   handle  pointer to application info handle
3691  * @param[out]  portrait_img contains portrait mode effect image
3692  * @param[out]  landscape_img contains landscape mode effect image
3693  * @return      0 if success, error code(<0) if fail
3694  * @retval      PMINFO_R_OK     success
3695  * @retval      PMINFO_R_EINVAL invalid argument
3696  * @retval      PMINFO_R_ERROR  internal error
3697  * @pre         pkgmgrinfo_appinfo_get_appinfo()
3698  * @post                pkgmgrinfo_appinfo_destroy_appinfo()
3699  * @see         pkgmgrinfo_appinfo_get_appid()
3700  * @see         pkgmgrinfo_appinfo_is_nodisplay()
3701  * @code
3702 static int get_app_effectimages(const char *appid)
3703 {
3704         int ret = 0;
3705         char *portraitimg = NULL;
3706         char *landscapeimg = NULL;
3707         pkgmgrinfo_appinfo_h handle;
3708         ret = pkgmgrinfo_appinfo_get_appinfo(appid, &handle);
3709         if (ret != PMINFO_R_OK)
3710                 return -1;
3711         ret = pkgmgrinfo_appinfo_get_effectimage(handle, &portraitimg, &landscapeimg);
3712         if (ret != PMINFO_R_OK) {
3713                 pkgmgrinfo_appinfo_destroy_appinfo(handle);
3714                 return -1;
3715         }
3716         printf("app effect image portrait: %s, app effect image landscape : %s\n", portraitimg, landscapeimg);
3717         pkgmgrinfo_appinfo_destroy_appinfo(handle);
3718         return 0;
3719 }
3720  * @endcode
3721  */
3722 int pkgmgrinfo_appinfo_get_effectimage(pkgmgrinfo_appinfo_h  handle, char **portrait_img, char **landscape_img);
3723
3724 /**
3725  * @fn int pkgmgrinfo_appinfo_get_effectimage_type(pkgmgrinfo_appinfo_h  handle, char **effectimg_type)
3726  * @brief       This API gets the application's effect image type
3727  *
3728  * @par         This API is for package-manager client application
3729  * @par Sync (or) Async : Synchronous API
3730  *
3731  * @param[in]   handle  pointer to application info handle
3732  * @param[out]  effectimg_type contains effect image type
3733  * @return      0 if success, error code(<0) if fail
3734  * @retval      PMINFO_R_OK     success
3735  * @retval      PMINFO_R_EINVAL invalid argument
3736  * @retval      PMINFO_R_ERROR  internal error
3737  * @pre         pkgmgrinfo_appinfo_get_appinfo()
3738  * @post                pkgmgrinfo_appinfo_destroy_appinfo()
3739  * @see         pkgmgrinfo_appinfo_get_appid()
3740  * @see         pkgmgrinfo_appinfo_is_nodisplay()
3741  * @code
3742 static int get_app_effectimage_type(const char *appid)
3743 {
3744         int ret = 0;
3745         char *effectimg_type = NULL;
3746         pkgmgrinfo_appinfo_h handle = NULL;
3747         ret = pkgmgrinfo_appinfo_get_appinfo(appid, &handle);
3748         if (ret != PMINFO_R_OK)
3749                 return -1;
3750         ret = pkgmgrinfo_appinfo_get_effectimage_type(handle, &effectimg_type);
3751         if (ret != PMINFO_R_OK) {
3752                 pkgmgrinfo_appinfo_destroy_appinfo(handle);
3753                 return -1;
3754         }
3755         printf("app effect image type: %s\n", effectimg_type);
3756         pkgmgrinfo_appinfo_destroy_appinfo(handle);
3757         return 0;
3758 }
3759  * @endcode
3760  */
3761 int pkgmgrinfo_appinfo_get_effectimage_type(pkgmgrinfo_appinfo_h handle, char **effectimg_type);
3762
3763 /**
3764  * @fn int pkgmgrinfo_appinfo_get_submode_mainid(pkgmgrinfo_appinfo_h handle, char **submode_mainid)
3765  * @brief       This API gets the submode_mainid of the application
3766  *
3767  * @par         This API is for package-manager client application
3768  * @par Sync (or) Async : Synchronous API
3769  *
3770  * @param[in] handle            pointer to the application info handle.
3771  * @param[out] submode_mainid           pointer to hold package name
3772  * @return      0 if success, error code(<0) if fail
3773  * @retval      PMINFO_R_OK     success
3774  * @retval      PMINFO_R_EINVAL invalid argument
3775  * @retval      PMINFO_R_ERROR  internal error
3776  * @pre         pkgmgrinfo_appinfo_get_appinfo()
3777  * @post                pkgmgrinfo_appinfo_destroy_appinfo()
3778  * @see         pkgmgrinfo_appinfo_get_appid()
3779  * @see         pkgmgrinfo_appinfo_is_multiple()
3780  * @code
3781 static int get_app_submode_mainid(const char *appid)
3782 {
3783         int ret = 0;
3784         char *submode_mainid = NULL;
3785         pkgmgrinfo_appinfo_h handle = NULL;
3786         ret = pkgmgrinfo_appinfo_get_appinfo(appid, &handle);
3787         if (ret != PMINFO_R_OK)
3788                 return -1;
3789         ret = pkgmgrinfo_appinfo_get_submode_mainid(handle, &submode_mainid);
3790         if (ret != PMINFO_R_OK) {
3791                 pkgmgrinfo_appinfo_destroy_appinfo(handle);
3792                 return -1;
3793         }
3794         printf("submode_mainid: %s\n", submode_mainid);
3795         pkgmgrinfo_appinfo_destroy_appinfo(handle);
3796         return 0;
3797 }
3798  * @endcode
3799  */
3800 int pkgmgrinfo_appinfo_get_submode_mainid(pkgmgrinfo_appinfo_h  handle, char **submode_mainid);
3801
3802 /**
3803  * @fn int pkgmgrinfo_appinfo_get_datacontrol_info(const char *providerid, const char *type, char **appid, char **access);
3804  * @brief       This API gets the datacontrol info
3805  *
3806  * @par         This API is for package-manager client application
3807  * @par Sync (or) Async : Synchronous API
3808  *
3809  * @param[in] providerid                pointer to the providerid of dataconltrol.
3810  * @param[in] type                      pointer to the type of dataconltrol.
3811  * @param[out] appid                    pointer to hold appid, need to free after using
3812  * @param[out] access                   pointer to hold access, need to free after using
3813  * @return      0 if success, error code(<0) if fail
3814  * @retval      PMINFO_R_OK     success
3815  * @retval      PMINFO_R_EINVAL invalid argument
3816  * @retval      PMINFO_R_ERROR  internal error
3817  * @endcode
3818  */
3819 int pkgmgrinfo_appinfo_get_datacontrol_info(const char *providerid, const char *type, char **appid, char **access);
3820 int pkgmgrinfo_appinfo_usr_get_datacontrol_info(const char *providerid, const char *type, uid_t uid, char **appid, char **access);
3821
3822 /**
3823  * @fn int pkgmgrinfo_appinfo_get_datacontrol_appid(const char *providerid, char **appid);
3824  * @brief       This API gets the appid of datacontrol
3825  *
3826  * @par         This API is for package-manager client application
3827  * @par Sync (or) Async : Synchronous API
3828  *
3829  * @param[in] providerid                pointer to the providerid of dataconltrol.
3830  * @param[out] appid                    pointer to hold appid, need to free after using
3831  * @return      0 if success, error code(<0) if fail
3832  * @retval      PMINFO_R_OK     success
3833  * @retval      PMINFO_R_EINVAL invalid argument
3834  * @retval      PMINFO_R_ERROR  internal error
3835  * @endcode
3836  */
3837 int pkgmgrinfo_appinfo_get_datacontrol_appid(const char *providerid, char **appid);
3838 int pkgmgrinfo_appinfo_usr_get_datacontrol_appid(const char *providerid, uid_t uid, char **appid);
3839
3840 /**
3841  * @fn int pkgmgrinfo_appinfo_get_datacontrol_trusted_info(const char *providerid, char **appid, bool *is_trusted);
3842  * @brief       This API gets the information about trusted datacontrol
3843  *
3844  * @par         This API is for package-manager client application
3845  * @par Sync (or) Async : Synchronous API
3846  *
3847  * @param[in] providerid                pointer to the providerid of datacontrol.
3848  * @param[out] appid                    pointer to hold appid, need to free after using
3849  * @param[out] is_trusted               pointer to hold whether it provides trusted datacontrol
3850  * @return      0 if success, error code(<0) if fail
3851  * @retval      PMINFO_R_OK     success
3852  * @retval      PMINFO_R_EINVAL invalid argument
3853  * @retval      PMINFO_R_ERROR  internal error
3854  * @endcode
3855  */
3856 int pkgmgrinfo_appinfo_get_datacontrol_trusted_info(const char *providerid,
3857                 const char *type, char **appid, bool *is_trusted);
3858 int pkgmgrinfo_appinfo_usr_get_datacontrol_trusted_info(const char *providerid,
3859                 const char *type, uid_t uid, char **appid, bool *is_trusted);
3860
3861 /**
3862  * @fn int pkgmgrinfo_appinfo_foreach_datacontrol_privileges(const char *providerid, const char *type,
3863                 pkgmgrinfo_pkg_privilege_list_cb privilege_func, void *user_data);
3864  * @brief       This API retrieves the privileges and invokes given callback for each privilege.
3865  *
3866  * @par         This API is for package-manager client application
3867  * @par Sync (or) Async : Synchronous API
3868  *
3869  * @param[in] providerid                pointer to the providerid of datacontrol.
3870  * @param[in] type                      pointer to the type of dataconltrol.
3871  * @param[in] privilege_func            callback function for list
3872  * @param[in] user_data user data to be passed to callback function
3873  * @return      0 if success, error code(<0) if fail
3874  * @retval      PMINFO_R_OK     success
3875  * @retval      PMINFO_R_EINVAL invalid argument
3876  * @retval      PMINFO_R_ERROR  internal error
3877  */
3878 int pkgmgrinfo_appinfo_foreach_datacontrol_privileges(const char *providerid, const char *type,
3879                 pkgmgrinfo_pkg_privilege_list_cb privilege_func, void *user_data);
3880 int pkgmgrinfo_appinfo_usr_foreach_datacontrol_privileges(const char *providerid, const char *type,
3881                 pkgmgrinfo_pkg_privilege_list_cb privilege_func, void *user_data, uid_t uid);
3882
3883 /**
3884  * @fn int pkgmgrinfo_appinfo_get_alias_appid(pkgmgrinfo_appinfo_h  handle, char **alias_appid)
3885  * @brief       This API gets the alias_appid of the application
3886  *
3887  * @par         This API is for package-manager client application
3888  * @par Sync (or) Async : Synchronous API
3889  *
3890  * @param[in] handle            pointer to the application info handle.
3891  * @param[out] alias_appid              pointer to hold app alias_appid
3892  * @return      0 if success, error code(<0) if fail
3893  * @retval      PMINFO_R_OK     success
3894  * @retval      PMINFO_R_EINVAL invalid argument
3895  * @retval      PMINFO_R_ERROR  internal error
3896  * @pre         pkgmgrinfo_appinfo_get_appinfo()
3897  * @post                pkgmgrinfo_appinfo_destroy_appinfo()
3898  * @see         pkgmgrinfo_appinfo_get_appid()
3899  * @code
3900 static int get_alias_appid(const char *appid)
3901 {
3902         int ret = 0;
3903         char *alias_appid= 0;
3904         pkgmgrinfo_appinfo_h handle = NULL;
3905         ret = pkgmgrinfo_appinfo_get_appinfo(appid, &handle);
3906         if (ret != PMINFO_R_OK)
3907                 return -1;
3908         ret = pkgmgrinfo_appinfo_get_alias_appid(handle, &alias_appid);
3909         if (ret != PMINFO_R_OK) {
3910                 pkgmgrinfo_appinfo_destroy_appinfo(handle);
3911                 return -1;
3912         }
3913         printf("alias_appid: %s\n", alias_appid);
3914         pkgmgrinfo_appinfo_destroy_appinfo(handle);
3915         return 0;
3916 }
3917  * @endcode
3918  */
3919 int pkgmgrinfo_appinfo_get_alias_appid(pkgmgrinfo_appinfo_h handle, char **alias_appid);
3920
3921 /**
3922  * @fn int pkgmgrinfo_appinfo_get_effective_appid(pkgmgrinfo_appinfo_h  handle, char **effective_appid)
3923  * @brief       This API gets the effective_appid of the application
3924  *
3925  * @par         This API is for package-manager client application
3926  * @par Sync (or) Async : Synchronous API
3927  *
3928  * @param[in] handle            pointer to the application info handle.
3929  * @param[out] effective_appid          pointer to hold app effective_appid
3930  * @return      0 if success, error code(<0) if fail
3931  * @retval      PMINFO_R_OK     success
3932  * @retval      PMINFO_R_EINVAL invalid argument
3933  * @retval      PMINFO_R_ERROR  internal error
3934  * @pre         pkgmgrinfo_appinfo_get_appinfo()
3935  * @post                pkgmgrinfo_appinfo_destroy_appinfo()
3936  * @see         pkgmgrinfo_appinfo_get_appid()
3937  * @code
3938 static int get_effective_appid(const char *appid)
3939 {
3940         int ret = 0;
3941         char *effective_appid= 0;
3942         pkgmgrinfo_appinfo_h handle = NULL;
3943         ret = pkgmgrinfo_appinfo_get_appinfo(appid, &handle);
3944         if (ret != PMINFO_R_OK)
3945                 return -1;
3946         ret = pkgmgrinfo_appinfo_get_effective_appid(handle, &effective_appid);
3947         if (ret != PMINFO_R_OK) {
3948                 pkgmgrinfo_appinfo_destroy_appinfo(handle);
3949                 return -1;
3950         }
3951         printf("effective_appid: %s\n", effective_appid);
3952         pkgmgrinfo_appinfo_destroy_appinfo(handle);
3953         return 0;
3954 }
3955  * @endcode
3956  */
3957 int pkgmgrinfo_appinfo_get_effective_appid(pkgmgrinfo_appinfo_h handle, char **effective_appid);
3958
3959 /**
3960  * @fn int pkgmgrinfo_appinfo_get_tep_name(pkgmgrinfo_appinfo_h handle, char **tep_name)
3961  * @brief       This API gets tep(tizen expansion package) file name associated with the package which contain given application
3962  *
3963  * @par This API is for package-manager client application
3964  * @par Sync (or) Async : Synchronous API
3965  *
3966  * @param[in] handle            pointer to the appinfo handle.
3967  * @param[out] tep_name         pointer to hold tep name
3968  * @return      0 if success, error code(<0) if fail
3969  * @retval      PMINFO_R_OK success
3970  * @retval      PMINFO_R_EINVAL invalid argument
3971  * @retval      PMINFO_R_ERROR  internal error
3972  * @pre pkgmgrinfo_appinfo_get_appinfo()
3973  * @post        pkgmgrinfo_appinfo_destroy_appinfo()
3974  * @see pkgmgrinfo_appinfo_get_appid()
3975  * @code
3976 static int get_tep_name(const char *appid)
3977 {
3978         int ret = 0;
3979         char *tep_name = NULL;
3980         pkgmgrinfo_appinfo_h handle = NULL;
3981         ret = pkgmgrinfo_appinfo_get_appinfo(appid, &handle);
3982         if (ret != PMINFO_R_OK)
3983                 return -1;
3984         ret = pkgmgrinfo_appinfo_get_tep_name(handle, &tep_name);
3985         if (ret != PMINFO_R_OK) {
3986                 pkgmgrinfo_appinfo_destroy_appinfo(handle);
3987                 return -1;
3988         }
3989         printf("TEP name is: %s\n", tep_name);
3990         pkgmgrinfo_appinfo_destroy_appinfo(handle);
3991         return 0;
3992 }
3993  * @endcode
3994  */
3995 int pkgmgrinfo_appinfo_get_tep_name(pkgmgrinfo_appinfo_h handle, char **tep_name);
3996
3997 /**
3998  * @fn int pkgmgrinfo_appinfo_get_zip_mount_file(pkgmgrinfo_appinfo_h handle, char **zip_mount_file)
3999  * @brief       This API gets zip mount file name associated with the package which contain given application
4000  *          If package is not "mount-installed", zip_mount_file is left as NULL pointer.
4001  *
4002  * @par This API is for package-manager client application
4003  * @par Sync (or) Async : Synchronous API
4004  *
4005  * @param[in] handle            pointer to the appinfo handle.
4006  * @param[out] zip_mount_file           pointer to hold zip mount file name
4007  * @return      0 if success, error code(<0) if fail
4008  * @retval      PMINFO_R_OK success
4009  * @retval      PMINFO_R_EINVAL invalid argument
4010  * @retval      PMINFO_R_ERROR  internal error
4011  * @pre pkgmgrinfo_appinfo_get_appinfo()
4012  * @post        pkgmgrinfo_appinfo_destroy_appinfo()
4013  * @see pkgmgrinfo_appinfo_get_appid()
4014  * @code
4015 static int get_zip_mount_file(const char *appid)
4016 {
4017         int ret = 0;
4018         char *zip_mount_file = NULL;
4019         pkgmgrinfo_appinfo_h handle = NULL;
4020         ret = pkgmgrinfo_appinfo_get_appinfo(appid, &handle);
4021         if (ret != PMINFO_R_OK)
4022                 return -1;
4023         ret = pkgmgrinfo_appinfo_get_zip_mount_file(handle, &zip_mount_file);
4024         if (ret != PMINFO_R_OK) {
4025                 pkgmgrinfo_appinfo_destroy_appinfo(handle);
4026                 return -1;
4027         }
4028         printf("Mount file name is: %s\n", zip_mount_file);
4029         pkgmgrinfo_appinfo_destroy_appinfo(handle);
4030         return 0;
4031 }
4032  * @endcode
4033  */
4034 int pkgmgrinfo_appinfo_get_zip_mount_file(pkgmgrinfo_appinfo_h handle, char **zip_mount_file);
4035
4036 /**
4037  * @fn int pkgmgrinfo_appinfo_get_root_path(pkgmgrinfo_appinfo_h handle, char **path)
4038  * @brief       This API gets the root path of application
4039  *
4040  * @par Sync (or) Async : Synchronous API
4041  *
4042  * @param[in] handle            pointer to appinfo handle
4043  * @param[out] path             pointer to hold root path of application
4044  * @return      0 if success, error code(<0) if fail
4045  * @retval      PMINFO_R_OK     success
4046  * @retval      PMINFO_R_EINVAL invalid argument
4047  * @retval      PMINFO_R_ERROR  internal error
4048  * @code
4049 static int get_root_path(const char *appid)
4050 {
4051         int ret = 0;
4052         char *path = 0;
4053         pkgmgrinfo_appinfo_h handle;
4054         ret = pkgmgrinfo_appinfo_get_appinfo(appid, &handle);
4055         if (ret != PMINFO_R_OK)
4056                 return -1;
4057
4058         ret = pkgmgrinfo_appinfo_get_root_path(handle, &path);
4059         if (ret != PMINFO_R_OK) {
4060                 pkgmgrinfo_appinfo_destroy_appinfo(handle);
4061                 return -1;
4062         }
4063         printf("path : %s\n", path);
4064         pkgmgrinfo_appinfo_destroy_appinfo(handle);
4065
4066         return 0;
4067 }
4068  * @endcode
4069  */
4070 int pkgmgrinfo_appinfo_get_root_path(pkgmgrinfo_appinfo_h handle, char **root_path);
4071
4072 /**
4073  * @fn int pkgmgrinfo_appinfo_get_api_version(pkgmgrinfo_appinfo_h handle, char **api_version)
4074  * @brief       This API gets the application api_version from the application ID
4075  *
4076  * @par         This API is for package-manager client application
4077  * @par Sync (or) Async : Synchronous API
4078  *
4079  * @param[in]   handle  pointer to appinfo handle
4080  * @param[out] api_version              pointer to hold application api_version
4081  * @return      0 if success, error code(<0) if fail
4082  * @retval      PMINFO_R_OK     success
4083  * @retval      PMINFO_R_EINVAL invalid argument
4084  * @retval      PMINFO_R_ERROR  internal error
4085  * @pre         pkgmgrinfo_appinfo_get_appinfo()
4086  * @post                pkgmgrinfo_appinfo_destroy_appinfo()
4087  * @see         pkgmgrinfo_appinfo_get_appid()
4088  * @code
4089 static int get_app_api_version(const char *appid)
4090 {
4091         int ret = 0;
4092         char *api_version = NULL;
4093         pkgmgrinfo_appinfo_h handle = NULL;
4094         ret = pkgmgrinfo_appinfo_get_appinfo(appid, &handle);
4095         if (ret != PMINFO_R_OK)
4096                 return -1;
4097         ret = pkgmgrinfo_appinfo_get_api_version(handle, &api_version);
4098         if (ret != PMINFO_R_OK) {
4099                 pkgmgrinfo_appinfo_destroy_appinfo(handle);
4100                 return -1;
4101         }
4102         printf("app api_version: %s\n", api_version);
4103         pkgmgrinfo_appinfo_destroy_appinfo(handle);
4104         return 0;
4105 }
4106  * @endcode
4107  */
4108 int pkgmgrinfo_appinfo_get_api_version(pkgmgrinfo_appinfo_h handle, char **api_version);
4109
4110 /**
4111  * @fn int pkgmgrinfo_appinfo_get_installed_time(pkgmgrinfo_appinfo_h handle, int *installed_time)
4112  * @brief       This API gets the installed_time of the application
4113  *
4114  * @par         This API is for package-manager client application
4115  * @par Sync (or) Async : Synchronous API
4116  *
4117  * @param[in] handle            pointer to the application info handle.
4118  * @param[out] installed_time           pointer to hold installed_time
4119  * @return      0 if success, error code(<0) if fail
4120  * @retval      PMINFO_R_OK     success
4121  * @retval      PMINFO_R_EINVAL invalid argument
4122  * @retval      PMINFO_R_ERROR  internal error
4123  * @pre         pkgmgrinfo_appinfo_get_appinfo()
4124  * @post                pkgmgrinfo_appinfo_destroy_appinfo()
4125  * @see         pkgmgrinfo_appinfo_get_appid()
4126  * @see         pkgmgrinfo_appinfo_is_multiple()
4127  * @code
4128 static int get_app_installed_time(const char *appid)
4129 {
4130         int ret = 0;
4131         int installed_time = 0;
4132         pkgmgrinfo_appinfo_h handle = NULL;
4133         ret = pkgmgrinfo_appinfo_get_appinfo(appid, &handle);
4134         if (ret != PMINFO_R_OK)
4135                 return -1;
4136         ret = pkgmgrinfo_appinfo_get_installed_time(handle, &installed_time);
4137         if (ret != PMINFO_R_OK) {
4138                 pkgmgrinfo_appinfo_destroy_appinfo(handle);
4139                 return -1;
4140         }
4141         printf("installed_time: %d\n", installed_time);
4142         pkgmgrinfo_appinfo_destroy_appinfo(handle);
4143         return 0;
4144 }
4145  * @endcode
4146  */
4147 int pkgmgrinfo_appinfo_get_installed_time(pkgmgrinfo_appinfo_h handle, int *installed_time);
4148
4149 /**
4150  * @fn int pkgmgrinfo_appinfo_get_support_mode(pkgmgrinfo_appinfo_h  handle, int *support_mode)
4151  * @brief       This API gets the support_mode of the application
4152  *
4153  * @par         This API is for package-manager client application
4154  * @par Sync (or) Async : Synchronous API
4155  *
4156  * @param[in] handle            pointer to the application info handle.
4157  * @param[out] support_mode             pointer to hold app support_mode
4158  * @return      0 if success, error code(<0) if fail
4159  * @retval      PMINFO_R_OK     success
4160  * @retval      PMINFO_R_EINVAL invalid argument
4161  * @retval      PMINFO_R_ERROR  internal error
4162  * @pre         pkgmgrinfo_appinfo_get_appinfo()
4163  * @post                pkgmgrinfo_appinfo_destroy_appinfo()
4164  * @see         pkgmgrinfo_appinfo_get_appid()
4165  * @code
4166 static int get_app_support_mode(const char *appid)
4167 {
4168         int ret = 0;
4169         int support_mode = 0;
4170         pkgmgrinfo_appinfo_h handle = NULL;
4171         ret = pkgmgrinfo_appinfo_get_appinfo(appid, &handle);
4172         if (ret != PMINFO_R_OK)
4173                 return -1;
4174         ret = pkgmgrinfo_appinfo_get_support_mode(handle, &support_mode);
4175         if (ret != PMINFO_R_OK) {
4176                 pkgmgrinfo_appinfo_destroy_appinfo(handle);
4177                 return -1;
4178         }
4179         printf("support_mode: %s\n", support_mode);
4180         pkgmgrinfo_appinfo_destroy_appinfo(handle);
4181         return 0;
4182 }
4183  * @endcode
4184  */
4185 int pkgmgrinfo_appinfo_get_support_mode(pkgmgrinfo_appinfo_h handle, int *support_mode);
4186
4187 /**
4188  * @fn  int pkgmgrinfo_appinfo_foreach_permission(pkgmgrinfo_appinfo_h handle,
4189                         pkgmgrinfo_app_permission_list_cb permission_func, void *user_data);
4190  * @brief       This API gets the list of permission for a particular application
4191  *
4192  * @par         This API is for package-manager client application
4193  * @par Sync (or) Async : Synchronous API
4194  * @param[in]   handle          pointer to the application info handle.
4195  * @param[in]   permission_func         callback function for list
4196  * @param[in] user_data user data to be passed to callback function
4197  * @return      0 if success, error code(<0) if fail
4198  * @retval      PMINFO_R_OK     success
4199  * @retval      PMINFO_R_EINVAL invalid argument
4200  * @retval      PMINFO_R_ERROR  internal error
4201  * @pre         pkgmgrinfo_appinfo_get_appinfo()
4202  * @post                pkgmgrinfo_appinfo_destroy_appinfo()
4203  * @code
4204 int permission_func(const char *name, void *user_data)
4205 {
4206         if (strcmp(name, (char *)user_data) == 0)
4207                 return -1;
4208         else
4209                 return 0;
4210 }
4211
4212 static int list_permission(const char *appid, char *permission)
4213 {
4214         int ret = 0;
4215         pkgmgrinfo_appinfo_h handle;
4216         ret = pkgmgrinfo_appinfo_get_appinfo(appid, &handle);
4217         if (ret != PMINFO_R_OK)
4218                 return -1;
4219         ret = pkgmgrinfo_appinfo_foreach_permission(handle, permission_func, (void *)permission);
4220         if (ret != PMINFO_R_OK) {
4221                 pkgmgrinfo_appinfo_destroy_appinfo(handle);
4222                 return -1;
4223         }
4224         pkgmgrinfo_appinfo_destroy_appinfo(handle);
4225         return 0;
4226 }
4227  * @endcode
4228  */
4229 int pkgmgrinfo_appinfo_foreach_permission(pkgmgrinfo_appinfo_h handle,
4230                         pkgmgrinfo_app_permission_list_cb permission_func, void *user_data);
4231
4232 /**
4233  * @fn  int pkgmgrinfo_appinfo_foreach_category(pkgmgrinfo_appinfo_h handle,
4234                         pkgmgrinfo_app_category_list_cb category_func, void *user_data);
4235  * @brief       This API gets the list of category for a particular application
4236  *
4237  * @par         This API is for package-manager client application
4238  * @par Sync (or) Async : Synchronous API
4239  * @param[in]   handle          pointer to the application info handle.
4240  * @param[in]   category_func           callback function for list
4241  * @param[in] user_data user data to be passed to callback function
4242  * @return      0 if success, error code(<0) if fail
4243  * @retval      PMINFO_R_OK     success
4244  * @retval      PMINFO_R_EINVAL invalid argument
4245  * @retval      PMINFO_R_ERROR  internal error
4246  * @pre         pkgmgrinfo_appinfo_get_appinfo()
4247  * @post                pkgmgrinfo_appinfo_destroy_appinfo()
4248  * @code
4249 int category_func(const char *name, void *user_data)
4250 {
4251         if (strcmp(name, (char *)user_data) == 0)
4252                 return -1;
4253         else
4254                 return 0;
4255 }
4256
4257 static int list_category(const char *appid, char *category)
4258 {
4259         int ret = 0;
4260         pkgmgrinfo_appinfo_h handle;
4261         ret = pkgmgrinfo_appinfo_get_appinfo(appid, &handle);
4262         if (ret != PMINFO_R_OK)
4263                 return -1;
4264         ret = pkgmgrinfo_appinfo_foreach_category(handle, category_func, (void *)category);
4265         if (ret != PMINFO_R_OK) {
4266                 pkgmgrinfo_appinfo_destroy_appinfo(handle);
4267                 return -1;
4268         }
4269         pkgmgrinfo_appinfo_destroy_appinfo(handle);
4270         return 0;
4271 }
4272  * @endcode
4273  */
4274 int pkgmgrinfo_appinfo_foreach_category(pkgmgrinfo_appinfo_h handle,
4275                         pkgmgrinfo_app_category_list_cb category_func, void *user_data);
4276
4277 /**
4278  * @fn  int pkgmgrinfo_appinfo_foreach_metadata(pkgmgrinfo_appinfo_h handle,
4279                         pkgmgrinfo_app_metadata_list_cb metadata_func, void *user_data);
4280  * @brief       This API gets the list of metadata for a particular application
4281  *
4282  * @par         This API is for package-manager client application
4283  * @par Sync (or) Async : Synchronous API
4284  * @param[in]   handle          pointer to the application info handle.
4285  * @param[in]   metadata_func           callback function for list
4286  * @param[in] user_data user data to be passed to callback function
4287  * @return      0 if success, error code(<0) if fail
4288  * @retval      PMINFO_R_OK     success
4289  * @retval      PMINFO_R_EINVAL invalid argument
4290  * @retval      PMINFO_R_ERROR  internal error
4291  * @pre         pkgmgrinfo_appinfo_get_appinfo()
4292  * @post                pkgmgrinfo_appinfo_destroy_appinfo()
4293  * @code
4294 int metadata_func(const char *key, const char *value, void *user_data)
4295 {
4296         if (strcmp(key, (char *)user_data) == 0) {
4297                 printf("Value is %s\n", value);
4298                 return -1;
4299         }
4300         else
4301                 return 0;
4302 }
4303
4304 static int list_metadata(const char *appid, char *key)
4305 {
4306         int ret = 0;
4307         pkgmgrinfo_appinfo_h handle;
4308         ret = pkgmgrinfo_appinfo_get_appinfo(appid, &handle);
4309         if (ret != PMINFO_R_OK)
4310                 return -1;
4311         ret = pkgmgrinfo_appinfo_foreach_metadata(handle, metadata_func, (void *)key);
4312         if (ret != PMINFO_R_OK) {
4313                 pkgmgrinfo_appinfo_destroy_appinfo(handle);
4314                 return -1;
4315         }
4316         pkgmgrinfo_appinfo_destroy_appinfo(handle);
4317         return 0;
4318 }
4319  * @endcode
4320  */
4321 int pkgmgrinfo_appinfo_foreach_metadata(pkgmgrinfo_appinfo_h handle,
4322                         pkgmgrinfo_app_metadata_list_cb metadata_func, void *user_data);
4323
4324
4325 /**
4326  * @fn  int pkgmgrinfo_appinfo_foreach_appcontrol(pkgmgrinfo_appinfo_h handle,
4327                         pkgmgrinfo_app_control_list_cb appcontrol_func, void *user_data);
4328  * @fn  int pkgmgrinfo_usr_appinfo_foreach_appcontrol(pkgmgrinfo_appinfo_h handle,
4329                         pkgmgrinfo_app_control_list_cb appcontrol_func, void *user_data, uid_t uid);
4330  * @brief       This API gets the list of app-control for a particular application
4331  *
4332  * @par         This API is for package-manager client application
4333  * @par Sync (or) Async : Synchronous API
4334  * @param[in]   handle          pointer to the application info handle.
4335  * @param[in]   appcontrol_func         callback function for list
4336  * @param[in] user_data user data to be passed to callback function
4337  * @param[in]   uid     the addressee user id of the instruction
4338  * @return      0 if success, error code(<0) if fail
4339  * @retval      PMINFO_R_OK     success
4340  * @retval      PMINFO_R_EINVAL invalid argument
4341  * @retval      PMINFO_R_ERROR  internal error
4342  * @pre         pkgmgrinfo_appinfo_get_appinfo()
4343  * @post                pkgmgrinfo_appinfo_destroy_appinfo()
4344  * @code
4345 int appcontrol_func(pkgmgrinfo_appcontrol_h handle, void *user_data)
4346 {
4347         int oc = 0;
4348         int i = 0;
4349         char **operation;
4350         pkgmgrinfo_appinfo_get_operation(handle, &oc, &operation);
4351         for (i = 0; i < oc; i++) {
4352                 if (strcmp(operation[i], (char *)user_data) == 0)
4353                         return -1;
4354                 else
4355                         return 0;
4356         }
4357 }
4358
4359 static int check_operation(const char *appid, char *operation)
4360 {
4361         int ret = 0;
4362         pkgmgrinfo_appinfo_h handle;
4363         ret = pkgmgrinfo_appinfo_get_appinfo(appid, &handle);
4364         if (ret != PMINFO_R_OK)
4365                 return -1;
4366         ret = pkgmgrinfo_appinfo_foreach_appcontrol(handle, appcontrol_func, (void *)operation);
4367         if (ret != PMINFO_R_OK) {
4368                 pkgmgrinfo_appinfo_destroy_appinfo(handle);
4369                 return -1;
4370         }
4371         pkgmgrinfo_appinfo_destroy_appinfo(handle);
4372         return 0;
4373 }
4374  * @endcode
4375  */
4376 int pkgmgrinfo_appinfo_foreach_appcontrol(pkgmgrinfo_appinfo_h handle,
4377                         pkgmgrinfo_app_control_list_cb appcontrol_func, void *user_data);
4378
4379 /**
4380  * @brief
4381  */
4382 int pkgmgrinfo_appinfo_foreach_background_category(pkgmgrinfo_appinfo_h handle,
4383                 pkgmgrinfo_app_background_category_list_cb category_func, void *user_data);
4384
4385 /**
4386  * @fn  int pkgmgrinfo_appinfo_foreach_splash_screen(pkgmgrinfo_appinfo_h handle,
4387                         pkgmgrinfo_app_splash_screen_list_cb splash_screen_func, void *user_data);
4388  * @brief       This API gets the list of splashscreen for a particular application
4389  *
4390  * @par         This API is for package-manager client application
4391  * @par Sync (or) Async : Synchronous API
4392  * @param[in]   handle          pointer to the application info handle.
4393  * @param[in]   splash_screen_func              callback function for list
4394  * @param[in]   user_data       user data to be passed to callback function
4395  * @return      0 if success, error code(<0) if fail
4396  * @retval      PMINFO_R_OK     success
4397  * @retval      PMINFO_R_EINVAL invalid argument
4398  * @retval      PMINFO_R_ERROR  internal error
4399  * @pre         pkgmgrinfo_appinfo_get_appinfo()
4400  * @post                pkgmgrinfo_appinfo_destroy_appinfo()
4401  * @code
4402  */
4403 int pkgmgrinfo_appinfo_foreach_splash_screen(pkgmgrinfo_appinfo_h handle,
4404                 pkgmgrinfo_app_splash_screen_list_cb splash_screen_func, void *user_data);
4405
4406 /**
4407  * @fn int pkgmgrinfo_appinfo_is_nodisplay(pkgmgrinfo_appinfo_h handle, bool *nodisplay)
4408  * @brief       This API gets the application 'nodisplay' value from the app ID
4409  *
4410  * @par         This API is for package-manager client application
4411  * @par Sync (or) Async : Synchronous API
4412  *
4413  * @param[in]   handle  pointer to application info handle
4414  * @param[out] nodisplay                pointer to hold package nodisplay value
4415  * @return      0 if success, error code(<0) if fail
4416  * @retval      PMINFO_R_OK     success
4417  * @retval      PMINFO_R_EINVAL invalid argument
4418  * @retval      PMINFO_R_ERROR  internal error
4419  * @pre         pkgmgrinfo_appinfo_get_appinfo()
4420  * @post                pkgmgrinfo_appinfo_destroy_appinfo()
4421  * @see         pkgmgrinfo_appinfo_get_appid()
4422  * @see         pkgmgrinfo_appinfo_is_multiple()
4423  * @code
4424 static int get_app_nodisplay(const char *appid)
4425 {
4426         int ret = 0;
4427         bool nodisplay;
4428         pkgmgrinfo_appinfo_h handle;
4429         ret = pkgmgrinfo_appinfo_get_appinfo(appid, &handle);
4430         if (ret != PMINFO_R_OK)
4431                 return -1;
4432         ret = pkgmgrinfo_appinfo_is_nodisplay(handle, &nodisplay);
4433         if (ret != PMINFO_R_OK) {
4434                 pkgmgrinfo_appinfo_destroy_appinfo(handle);
4435                 return -1;
4436         }
4437         printf("app nodisplay: %d\n", nodisplay);
4438         pkgmgrinfo_appinfo_destroy_appinfo(handle);
4439         return 0;
4440 }
4441  * @endcode
4442  */
4443 int pkgmgrinfo_appinfo_is_nodisplay(pkgmgrinfo_appinfo_h  handle, bool *nodisplay);
4444
4445 /**
4446  * @fn int pkgmgrinfo_appinfo_is_multiple(pkgmgrinfo_appinfo_h handle, bool *multiple)
4447  * @brief       This API gets the application 'multiple' value from the app ID
4448  *
4449  * @par         This API is for package-manager client application
4450  * @par Sync (or) Async : Synchronous API
4451  *
4452  * @param[in]   handle  pointer to application info handle
4453  * @param[out] multiple         pointer to hold package multiple value
4454  * @return      0 if success, error code(<0) if fail
4455  * @retval      PMINFO_R_OK     success
4456  * @retval      PMINFO_R_EINVAL invalid argument
4457  * @retval      PMINFO_R_ERROR  internal error
4458  * @pre         pkgmgrinfo_appinfo_get_appinfo()
4459  * @post                pkgmgrinfo_appinfo_destroy_appinfo()
4460  * @see         pkgmgrinfo_appinfo_get_appid()
4461  * @see         pkgmgrinfo_appinfo_is_nodisplay()
4462  * @code
4463 static int get_app_multiple(const char *appid)
4464 {
4465         int ret = 0;
4466         bool multiple;
4467         pkgmgrinfo_appinfo_h handle;
4468         ret = pkgmgrinfo_appinfo_get_appinfo(appid, &handle);
4469         if (ret != PMINFO_R_OK)
4470                 return -1;
4471         ret = pkgmgrinfo_appinfo_is_multiple(handle, &multiple);
4472         if (ret != PMINFO_R_OK) {
4473                 pkgmgrinfo_appinfo_destroy_appinfo(handle);
4474                 return -1;
4475         }
4476         printf("app multiple: %d\n", multiple);
4477         pkgmgrinfo_appinfo_destroy_appinfo(handle);
4478         return 0;
4479 }
4480  * @endcode
4481  */
4482 int pkgmgrinfo_appinfo_is_multiple(pkgmgrinfo_appinfo_h  handle, bool *multiple);
4483
4484 /**
4485  * @fn int pkgmgrinfo_appinfo_is_indicator_display_allowed(pkgmgrinfo_appinfo_h handle, bool *indicator_disp)
4486  * @brief       This API gets the application 'indicatordisplay' value. If true, indicator will be displayed during
4487  *              application launching effect. If fales, indicator will be hidden during application launching effect
4488  *
4489  * @par         This API is for package-manager client application
4490  * @par Sync (or) Async : Synchronous API
4491  *
4492  * @param[in]   handle  pointer to application info handle
4493  * @param[out]  indicator_disp contains indicator display status for application launching effect
4494  * @return      0 if success, error code(<0) if fail
4495  * @retval      PMINFO_R_OK     success
4496  * @retval      PMINFO_R_EINVAL invalid argument
4497  * @retval      PMINFO_R_ERROR  internal error
4498  * @pre         pkgmgrinfo_appinfo_get_appinfo()
4499  * @post                pkgmgrinfo_appinfo_destroy_appinfo()
4500  * @see         pkgmgrinfo_appinfo_get_appid()
4501  * @see         pkgmgrinfo_appinfo_is_nodisplay()
4502  * @code
4503 static int get_app_indicator_display(const char *appid)
4504 {
4505         int ret = 0;
4506         bool indicator_disp;
4507         pkgmgrinfo_appinfo_h handle;
4508         ret = pkgmgrinfo_appinfo_get_appinfo(appid, &handle);
4509         if (ret != PMINFO_R_OK)
4510                 return -1;
4511         ret = pkgmgrinfo_appinfo_is_indicator_display_allowed(handle, &indicator_disp);
4512         if (ret != PMINFO_R_OK){
4513                 pkgmgrinfo_appinfo_destroy_appinfo(handle);
4514                 return -1;
4515         }
4516         printf("app indicator disp : %d\n", indicator_disp);
4517         pkgmgrinfo_appinfo_destroy_appinfo(handle);
4518         return 0;
4519 }
4520  * @endcode
4521  */
4522 int pkgmgrinfo_appinfo_is_indicator_display_allowed(pkgmgrinfo_appinfo_h handle, bool *indicator_disp);
4523
4524 /**
4525  * @fn int pkgmgrinfo_appinfo_is_taskmanage(pkgmgrinfo_appinfo_h handle, bool *taskmanage)
4526  * @brief       This API gets the application 'taskmanage' value from the app ID
4527  *
4528  * @par         This API is for package-manager client application
4529  * @par Sync (or) Async : Synchronous API
4530  *
4531  * @param[in]   handle  pointer to application info handle
4532  * @param[out] taskmanage               pointer to hold package taskmanage value
4533  * @return      0 if success, error code(<0) if fail
4534  * @retval      PMINFO_R_OK     success
4535  * @retval      PMINFO_R_EINVAL invalid argument
4536  * @retval      PMINFO_R_ERROR  internal error
4537  * @pre         pkgmgrinfo_appinfo_get_appinfo()
4538  * @post                pkgmgrinfo_appinfo_destroy_appinfo()
4539  * @see         pkgmgrinfo_appinfo_get_appid()
4540  * @see         pkgmgrinfo_appinfo_is_multiple()
4541  * @code
4542 static int get_app_taskmanage(const char *appid)
4543 {
4544         int ret = 0;
4545         bool taskmanage;
4546         pkgmgrinfo_appinfo_h handle;
4547         ret = pkgmgrinfo_appinfo_get_appinfo(appid, &handle);
4548         if (ret != PMINFO_R_OK)
4549                 return -1;
4550         ret = pkgmgrinfo_appinfo_is_taskmanage(handle, &taskmanage);
4551         if (ret != PMINFO_R_OK) {
4552                 pkgmgrinfo_appinfo_destroy_appinfo(handle);
4553                 return -1;
4554         }
4555         printf("app taskmanage: %d\n", taskmanage);
4556         pkgmgrinfo_appinfo_destroy_appinfo(handle);
4557         return 0;
4558 }
4559  * @endcode
4560  */
4561 int pkgmgrinfo_appinfo_is_taskmanage(pkgmgrinfo_appinfo_h  handle, bool *taskmanage);
4562
4563 /**
4564  * @fn int pkgmgrinfo_appinfo_is_enabled(pkgmgrinfo_appinfo_h handle, bool *enabled)
4565  * @brief       This API gets the application 'taskmanage' value from the app ID
4566  *
4567  * @par         This API is for package-manager client application
4568  * @par Sync (or) Async : Synchronous API
4569  *
4570  * @param[in]   handle  pointer to application info handle
4571  * @param[out] enabled          pointer to hold package enabled value
4572  * @return      0 if success, error code(<0) if fail
4573  * @retval      PMINFO_R_OK     success
4574  * @retval      PMINFO_R_EINVAL invalid argument
4575  * @retval      PMINFO_R_ERROR  internal error
4576  * @pre         pkgmgrinfo_appinfo_get_appinfo()
4577  * @post                pkgmgrinfo_appinfo_destroy_appinfo()
4578  * @see         pkgmgrinfo_appinfo_get_appid()
4579  * @see         pkgmgrinfo_appinfo_is_multiple()
4580  * @code
4581 static int get_app_enabled(const char *appid)
4582 {
4583         int ret = 0;
4584         bool enabled;
4585         pkgmgrinfo_appinfo_h handle;
4586         ret = pkgmgrinfo_appinfo_get_appinfo(appid, &handle);
4587         if (ret != PMINFO_R_OK)
4588                 return -1;
4589         ret = pkgmgrinfo_appinfo_is_taskmanage(handle, &enabled);
4590         if (ret != PMINFO_R_OK) {
4591                 pkgmgrinfo_appinfo_destroy_appinfo(handle);
4592                 return -1;
4593         }
4594         printf("app enabled: %d\n", enabled);
4595         pkgmgrinfo_appinfo_destroy_appinfo(handle);
4596         return 0;
4597 }
4598  * @endcode
4599  */
4600 int pkgmgrinfo_appinfo_is_enabled(pkgmgrinfo_appinfo_h  handle, bool *enabled);
4601
4602 /**
4603  * @fn int pkgmgrinfo_appinfo_is_onboot(pkgmgrinfo_appinfo_h handle, bool *onboot)
4604  * @brief       This API gets the application 'onboot' value from the app ID
4605  *
4606  * @par         This API is for package-manager client application
4607  * @par Sync (or) Async : Synchronous API
4608  *
4609  * @param[in]   handle  pointer to application info handle
4610  * @param[out] onboot           pointer to hold package onboot value
4611  * @return      0 if success, error code(<0) if fail
4612  * @retval      PMINFO_R_OK     success
4613  * @retval      PMINFO_R_EINVAL invalid argument
4614  * @retval      PMINFO_R_ERROR  internal error
4615  * @pre         pkgmgrinfo_appinfo_get_appinfo()
4616  * @post                pkgmgrinfo_appinfo_destroy_appinfo()
4617  * @see         pkgmgrinfo_appinfo_get_appid()
4618  * @see         pkgmgrinfo_appinfo_is_multiple()
4619  * @code
4620 static int get_app_onboot(const char *appid)
4621 {
4622         int ret = 0;
4623         bool onboot;
4624         pkgmgrinfo_appinfo_h handle;
4625         ret = pkgmgrinfo_appinfo_get_appinfo(appid, &handle);
4626         if (ret != PMINFO_R_OK)
4627                 return -1;
4628         ret = pkgmgrinfo_appinfo_is_onboot(handle, &onboot);
4629         if (ret != PMINFO_R_OK) {
4630                 pkgmgrinfo_appinfo_destroy_appinfo(handle);
4631                 return -1;
4632         }
4633         printf("app onboot: %d\n", onboot);
4634         pkgmgrinfo_appinfo_destroy_appinfo(handle);
4635         return 0;
4636 }
4637  * @endcode
4638  */
4639 int pkgmgrinfo_appinfo_is_onboot(pkgmgrinfo_appinfo_h  handle, bool *onboot);
4640
4641 /**
4642  * @fn int pkgmgrinfo_appinfo_is_autorestart(pkgmgrinfo_appinfo_h handle, bool *autorestart)
4643  * @brief       This API gets the application 'autorestart' value from the app ID
4644  *
4645  * @par         This API is for package-manager client application
4646  * @par Sync (or) Async : Synchronous API
4647  *
4648  * @param[in]   handle  pointer to application info handle
4649  * @param[out] autorestart              pointer to hold package autorestart value
4650  * @return      0 if success, error code(<0) if fail
4651  * @retval      PMINFO_R_OK     success
4652  * @retval      PMINFO_R_EINVAL invalid argument
4653  * @retval      PMINFO_R_ERROR  internal error
4654  * @pre         pkgmgrinfo_appinfo_get_appinfo()
4655  * @post                pkgmgrinfo_appinfo_destroy_appinfo()
4656  * @see         pkgmgrinfo_appinfo_get_appid()
4657  * @see         pkgmgrinfo_appinfo_is_multiple()
4658  * @code
4659 static int get_app_autorestart(const char *appid)
4660 {
4661         int ret = 0;
4662         bool autorestart;
4663         pkgmgrinfo_appinfo_h handle;
4664         ret = pkgmgrinfo_appinfo_get_appinfo(appid, &handle);
4665         if (ret != PMINFO_R_OK)
4666                 return -1;
4667         ret = pkgmgrinfo_appinfo_is_autorestart(handle, &autorestart);
4668         if (ret != PMINFO_R_OK) {
4669                 pkgmgrinfo_appinfo_destroy_appinfo(handle);
4670                 return -1;
4671         }
4672         printf("app autorestart: %d\n", autorestart);
4673         pkgmgrinfo_appinfo_destroy_appinfo(handle);
4674         return 0;
4675 }
4676  * @endcode
4677  */
4678 int pkgmgrinfo_appinfo_is_autorestart(pkgmgrinfo_appinfo_h  handle, bool *autorestart);
4679
4680 /**
4681  * @fn int pkgmgrinfo_appinfo_is_mainapp(pkgmgrinfo_appinfo_h  handle, bool *mainapp)
4682  * @brief       This API gets the value for given application is main app or not from handle
4683  *
4684  * @par         This API is for package-manager client application
4685  * @par Sync (or) Async : Synchronous API
4686  *
4687  * @param[in]   handle  pointer to application info handle
4688  * @param[out] mainapp          pointer to hold package mainapp is or not
4689  * @return      0 if success, error code(<0) if fail
4690  * @retval      PMINFO_R_OK     success
4691  * @retval      PMINFO_R_EINVAL invalid argument
4692  * @retval      PMINFO_R_ERROR  internal error
4693  * @pre         pkgmgrinfo_appinfo_get_appinfo()
4694  * @post                pkgmgrinfo_appinfo_destroy_appinfo()
4695  * @see         pkgmgrinfo_appinfo_get_appid()
4696  * @see         pkgmgrinfo_appinfo_is_multiple()
4697  * @code
4698 static int get_app_mainapp(const char *appid)
4699 {
4700         int ret = 0;
4701         bool mainapp;
4702         pkgmgrinfo_appinfo_h handle;
4703         ret = pkgmgrinfo_appinfo_get_appinfo(appid, &handle);
4704         if (ret != PMINFO_R_OK)
4705                 return -1;
4706         ret = pkgmgrinfo_appinfo_is_mainapp(handle, &mainapp);
4707         if (ret != PMINFO_R_OK) {
4708                 pkgmgrinfo_appinfo_destroy_appinfo(handle);
4709                 return -1;
4710         }
4711         printf("mainapp: %d\n", mainapp);
4712         pkgmgrinfo_appinfo_destroy_appinfo(handle);
4713         return 0;
4714 }
4715  * @endcode
4716  */
4717 int pkgmgrinfo_appinfo_is_mainapp(pkgmgrinfo_appinfo_h  handle, bool *mainapp);
4718
4719
4720 /**
4721  * @fn int pkgmgrinfo_appinfo_is_preload(pkgmgrinfo_appinfo_h handle, bool *preload)
4722  * @brief       This API gets the value for given application is preload or not from handle
4723  *
4724  * @par         This API is for package-manager client application
4725  * @par Sync (or) Async : Synchronous API
4726  *
4727  * @param[in]   handle  pointer to application info handle
4728  * @param[out] preload          pointer to hold preload is or not
4729  * @return      0 if success, error code(<0) if fail
4730  * @retval      PMINFO_R_OK     success
4731  * @retval      PMINFO_R_EINVAL invalid argument
4732  * @retval      PMINFO_R_ERROR  internal error
4733  * @pre         pkgmgrinfo_appinfo_get_appinfo()
4734  * @post                pkgmgrinfo_appinfo_destroy_appinfo()
4735  * @see         pkgmgrinfo_appinfo_get_appid()
4736  * @see         pkgmgrinfo_appinfo_is_multiple()
4737  * @code
4738 static int get_app_preload(const char *appid)
4739 {
4740         int ret = 0;
4741         bool preload = 0;
4742         pkgmgrinfo_appinfo_h handle = NULL;
4743         ret = pkgmgrinfo_appinfo_get_appinfo(appid, &handle);
4744         if (ret != PMINFO_R_OK)
4745                 return -1;
4746         ret = pkgmgrinfo_appinfo_is_preload(handle, &preload);
4747         if (ret != PMINFO_R_OK) {
4748                 pkgmgrinfo_appinfo_destroy_appinfo(handle);
4749                 return -1;
4750         }
4751         printf("preload: %d\n", preload);
4752         pkgmgrinfo_appinfo_destroy_appinfo(handle);
4753         return 0;
4754 }
4755  * @endcode
4756  */
4757 int pkgmgrinfo_appinfo_is_preload(pkgmgrinfo_appinfo_h handle, bool *preload);
4758
4759 /**
4760  * @fn int pkgmgrinfo_appinfo_is_submode(pkgmgrinfo_appinfo_h handle, bool *submode)
4761  * @brief       This API gets the value for given application is submode or not from handle
4762  *
4763  * @par         This API is for package-manager client application
4764  * @par Sync (or) Async : Synchronous API
4765  *
4766  * @param[in]   handle  pointer to application info handle
4767  * @param[out] submode          pointer to hold submode is or not
4768  * @return      0 if success, error code(<0) if fail
4769  * @retval      PMINFO_R_OK     success
4770  * @retval      PMINFO_R_EINVAL invalid argument
4771  * @retval      PMINFO_R_ERROR  internal error
4772  * @pre         pkgmgrinfo_appinfo_get_appinfo()
4773  * @post                pkgmgrinfo_appinfo_destroy_appinfo()
4774  * @see         pkgmgrinfo_appinfo_get_appid()
4775  * @see         pkgmgrinfo_appinfo_is_multiple()
4776  * @code
4777 static int get_app_submode(const char *appid)
4778 {
4779         int ret = 0;
4780         bool submode = 0;
4781         pkgmgrinfo_appinfo_h handle = NULL;
4782         ret = pkgmgrinfo_appinfo_get_appinfo(appid, &handle);
4783         if (ret != PMINFO_R_OK)
4784                 return -1;
4785         ret = pkgmgrinfo_appinfo_is_submode(handle, &submode);
4786         if (ret != PMINFO_R_OK) {
4787                 pkgmgrinfo_appinfo_destroy_appinfo(handle);
4788                 return -1;
4789         }
4790         printf("submode: %d\n", submode);
4791         pkgmgrinfo_appinfo_destroy_appinfo(handle);
4792         return 0;
4793 }
4794  * @endcode
4795  */
4796 int pkgmgrinfo_appinfo_is_submode(pkgmgrinfo_appinfo_h handle, bool *submode);
4797
4798 /**
4799  * @fn int int pkgmgrinfo_appinfo_is_process_pool(pkgmgrinfo_appinfo_h handle, bool *process_pool)
4800  * @brief       This API gets the value for given application is process_pool or not from handle
4801  *
4802  * @par         This API is for package-manager client application
4803  * @par Sync (or) Async : Synchronous API
4804  *
4805  * @param[in]   handle  pointer to application info handle
4806  * @param[out] process_pool             pointer to hold process_pool is or not
4807  * @return      0 if success, error code(<0) if fail
4808  * @retval      PMINFO_R_OK     success
4809  * @retval      PMINFO_R_EINVAL invalid argument
4810  * @retval      PMINFO_R_ERROR  internal error
4811  * @pre         pkgmgrinfo_appinfo_get_appinfo()
4812  * @post                pkgmgrinfo_appinfo_destroy_appinfo()
4813  * @see         pkgmgrinfo_appinfo_get_appid()
4814  * @code
4815 static int get_app_process_pool(const char *appid)
4816 {
4817         int ret = 0;
4818         bool process_pool = 0;
4819         pkgmgrinfo_appinfo_h handle = NULL;
4820         ret = pkgmgrinfo_appinfo_get_appinfo(appid, &handle);
4821         if (ret != PMINFO_R_OK)
4822                 return -1;
4823         ret = pkgmgrinfo_appinfo_is_process_pool(handle, &process_pool);
4824         if (ret != PMINFO_R_OK) {
4825                 pkgmgrinfo_appinfo_destroy_appinfo(handle);
4826                 return -1;
4827         }
4828         printf("process_pool: %d\n", process_pool);
4829         pkgmgrinfo_appinfo_destroy_appinfo(handle);
4830         return 0;
4831 }
4832  * @endcode
4833  */
4834 int pkgmgrinfo_appinfo_is_process_pool(pkgmgrinfo_appinfo_h handle, bool *process_pool);
4835
4836 /**
4837  * @fn int pkgmgrinfo_appinfo_get_installed_storage_location(pkgmgrinfo_appinfo_h handle, pkgmgrinfo_installed_storage *storage)
4838  * @brief       This API gets the installed storage location of the application
4839  *
4840  * @par This API is for package-manager client application
4841  * @par Sync (or) Async : Synchronous API
4842  *
4843  * @param[in] handle            pointer to the application info handle.
4844  * @param[out] app_type         pointer to hold installed storage location
4845  * @return      0 if success, error code(<0) if fail
4846  * @retval      PMINFO_R_OK success
4847  * @retval      PMINFO_R_EINVAL invalid argument
4848  * @retval      PMINFO_R_ERROR  internal error
4849  * @pre pkgmgrinfo_appinfo_get_appinfo()
4850  * @post        pkgmgrinfo_appinfo_destroy_appinfo()
4851  * @see pkgmgrinfo_appinfo_get_appid()
4852  * @code
4853 static int get_app_installed_location(const char *appid)
4854 {
4855         int ret = 0;
4856         pkgmgrinfo_installed_storage storage;
4857         pkgmgrinfo_appinfo_h handle = NULL;
4858         ret = pkgmgrinfo_appinfo_get_appinfo(appid, &handle);
4859         if (ret != PMINFO_R_OK)
4860                 return -1;
4861         ret = pkgmgrinfo_appinfo_get_installed_storage_location(handle, &storage);
4862         if (ret != PMINFO_R_OK) {
4863                 pkgmgrinfo_appinfo_destroy_appinfo(handle);
4864                 return -1;
4865         }
4866         printf("Installed storage location : %d\n", storage);
4867         pkgmgrinfo_appinfo_destroy_appinfo(handle);
4868         return 0;
4869 }
4870  * @endcode
4871  */
4872 int pkgmgrinfo_appinfo_get_installed_storage_location(pkgmgrinfo_appinfo_h handle, pkgmgrinfo_installed_storage *storage);
4873
4874
4875 /**
4876  * @fn int pkgmgrinfo_appinfo_is_category_exist(pkgmgrinfo_appinfo_h handle, const char *category, bool *exist)
4877  * @brief       This API checks if the application has the given category
4878  *
4879  * @par         This API is for package-manager client application
4880  * @par Sync (or) Async : Synchronous API
4881  *
4882  * @param[in]   handle  pointer to the application info handle
4883  * @param[in]   category        category
4884  * @param[out] exist            value Gets whether the application has the given category
4885  * @return      0 if success, error code(<0) if fail
4886  * @retval      PMINFO_R_OK     success
4887  * @retval      PMINFO_R_EINVAL invalid argument
4888  * @retval      PMINFO_R_ERROR  internal error
4889  * @code
4890 static int is_category_exist(const char *appid, const char *category)
4891 {
4892         int ret = 0;
4893         pkgmgrinfo_appinfo_h handle;
4894         bool exist = false;
4895
4896         ret = pkgmgrinfo_appinfo_get_appinfo(appid, &handle);
4897         if (ret != PMINFO_R_OK)
4898                 return -1;
4899
4900         ret = pkgmgrinfo_appinfo_is_category_exist(handle, category, &exist);
4901         if (ret != PMINFO_R_OK) {
4902                 pkgmgrinfo_appinfo_destroy_appinfo(handle);
4903                 return -1;
4904         }
4905
4906         pkgmgrinfo_appinfo_destroy_appinfo(handle);
4907         return 0;
4908 }
4909  * @endcode
4910  */
4911 int pkgmgrinfo_appinfo_is_category_exist(pkgmgrinfo_appinfo_h handle, const char *category, bool *exist);
4912
4913 /**
4914  * @fn int pkgmgrinfo_appinfo_is_ui_gadget(pkgmgrinfo_appinfo_h handle, bool *ui_gadget)
4915  * @brief       This API gets the application 'ui_gadget' value from the app ID
4916  *
4917  * @par         This API is for package-manager client application
4918  * @par Sync (or) Async : Synchronous API
4919  *
4920  * @param[in]   handle  pointer to application info handle
4921  * @param[out]  ui_gadget       pointer to hold package ui_gadget value
4922  * @return      0 if success, error code(<0) if fail
4923  * @retval      PMINFO_R_OK     success
4924  * @retval      PMINFO_R_EINVAL invalid argument
4925  * @pre         pkgmgrinfo_appinfo_get_appinfo()
4926  * @post        pkgmgrinfo_appinfo_destroy_appinfo()
4927  * @code
4928 static int get_app_ui_gadget(const char *appid)
4929 {
4930         int ret = 0;
4931         bool ui_gadget;
4932         pkgmgrinfo_appinfo_h handle = NULL;
4933         ret = pkgmgrinfo_appinfo_get_appinfo(appid, &handle);
4934         if (ret != PMINFO_R_OK)
4935                 return -1;
4936         ret = pkgmgrinfo_appinfo_is_ui_gadget(handle, &ui_gadget);
4937         if (ret != PMINFO_R_OK) {
4938                 pkgmgrinfo_appinfo_destroy_appinfo(handle);
4939                 return -1;
4940         }
4941         printf("app ui_gadget: %d\n", ui_gadget);
4942         pkgmgrinfo_appinfo_destroy_appinfo(handle);
4943         return 0;
4944 }
4945  * @endcode
4946  */
4947 int pkgmgrinfo_appinfo_is_ui_gadget(pkgmgrinfo_appinfo_h handle, bool *ui_gadget);
4948
4949 /**
4950  * @fn int pkgmgrinfo_appinfo_is_support_disable(pkgmgrinfo_appinfo_h handle, bool *support_disable)
4951  * @brief       This API gets the application 'support_disable' value from the app ID
4952  *
4953  * @par         This API is for package-manager client application
4954  * @par Sync (or) Async : Synchronous API
4955  *
4956  * @param[in]   handle  pointer to application info handle
4957  * @param[out]  support_disable pointer to hold package support_disable value
4958  * @return      0 if success, error code(<0) if fail
4959  * @retval      PMINFO_R_OK     success
4960  * @retval      PMINFO_R_EINVAL invalid argument
4961  * @pre         pkgmgrinfo_appinfo_get_appinfo()
4962  * @post        pkgmgrinfo_appinfo_destroy_appinfo()
4963  * @code
4964 static int get_app_support_disable(const char *appid)
4965 {
4966         int ret = 0;
4967         bool support_disable;
4968         pkgmgrinfo_appinfo_h handle = NULL;
4969         ret = pkgmgrinfo_appinfo_get_appinfo(appid, &handle);
4970         if (ret != PMINFO_R_OK)
4971                 return -1;
4972         ret = pkgmgrinfo_appinfo_is_support_disable(handle, &support_disable);
4973         if (ret != PMINFO_R_OK) {
4974                 pkgmgrinfo_appinfo_destroy_appinfo(handle);
4975                 return -1;
4976         }
4977         printf("app support_disable: %d\n", support_disable);
4978         pkgmgrinfo_appinfo_destroy_appinfo(handle);
4979         return 0;
4980 }
4981  * @endcode
4982  */
4983 int pkgmgrinfo_appinfo_is_support_disable(pkgmgrinfo_appinfo_h handle, bool *support_disable);
4984
4985 /**
4986  * @fn int pkgmgrinfo_appinfo_is_removable(pkgmgrinfo_appinfo_h handle, bool *removable)
4987  * @brief       This API gets the application 'removable' value from the app ID
4988  *
4989  * @par         This API is for package-manager client application
4990  * @par Sync (or) Async : Synchronous API
4991  *
4992  * @param[in]   handle  pointer to application info handle
4993  * @param[out]  removable       pointer to hold package removable value
4994  * @return      0 if success, error code(<0) if fail
4995  * @retval      PMINFO_R_OK     success
4996  * @retval      PMINFO_R_EINVAL invalid argument
4997  * @retval      PMINFO_R_ERROR  internal error
4998  * @pre         pkgmgrinfo_appinfo_get_appinfo()
4999  * @post                pkgmgrinfo_appinfo_destroy_appinfo()
5000  * @see         pkgmgrinfo_appinfo_get_appid()
5001  * @code
5002 static int get_app_removable(const char *appid)
5003 {
5004         int ret = 0;
5005         bool removable;
5006         pkgmgrinfo_appinfo_h handle = NULL;
5007         ret = pkgmgrinfo_appinfo_get_appinfo(appid, &handle);
5008         if (ret != PMINFO_R_OK)
5009                 return -1;
5010         ret = pkgmgrinfo_appinfo_is_removable(handle, &removable);
5011         if (ret != PMINFO_R_OK) {
5012                 pkgmgrinfo_appinfo_destroy_appinfo(handle);
5013                 return -1;
5014         }
5015         printf("app removable: %d\n", removable);
5016         pkgmgrinfo_appinfo_destroy_appinfo(handle);
5017         return 0;
5018 }
5019  * @endcode
5020  */
5021 int pkgmgrinfo_appinfo_is_removable(pkgmgrinfo_appinfo_h handle, bool *removable);
5022
5023 /**
5024  * @fn int pkgmgrinfo_appinfo_is_system(pkgmgrinfo_appinfo_h handle, bool *system)
5025  * @brief       This API gets the application 'system' value from the app ID
5026  *
5027  * @par         This API is for package-manager client application
5028  * @par Sync (or) Async : Synchronous API
5029  *
5030  * @param[in]   handle  pointer to application info handle
5031  * @param[out]  system  pointer to hold package system value
5032  * @return      0 if success, error code(<0) if fail
5033  * @retval      PMINFO_R_OK     success
5034  * @retval      PMINFO_R_EINVAL invalid argument
5035  * @retval      PMINFO_R_ERROR  internal error
5036  * @pre         pkgmgrinfo_appinfo_get_appinfo()
5037  * @post                pkgmgrinfo_appinfo_destroy_appinfo()
5038  * @see         pkgmgrinfo_appinfo_get_appid()
5039  * @code
5040 static int get_app_system(const char *appid)
5041 {
5042         int ret = 0;
5043         bool system = false;
5044         pkgmgrinfo_appinfo_h handle = NULL;
5045         ret = pkgmgrinfo_appinfo_get_appinfo(appid, &handle);
5046         if (ret != PMINFO_R_OK)
5047                 return -1;
5048         ret = pkgmgrinfo_appinfo_is_system(handle, &system);
5049         if (ret != PMINFO_R_OK) {
5050                 pkgmgrinfo_appinfo_destroy_appinfo(handle);
5051                 return -1;
5052         }
5053         printf("app system: %d\n", system);
5054         pkgmgrinfo_appinfo_destroy_appinfo(handle);
5055         return 0;
5056 }
5057  * @endcode
5058  */
5059 int pkgmgrinfo_appinfo_is_system(pkgmgrinfo_appinfo_h handle, bool *system);
5060
5061
5062 /**
5063  * @fn int pkgmgrinfo_appinfo_is_disabled(pkgmgrinfo_appinfo_h handle, bool *disabled)
5064  * @brief       This API gets the application 'is_disable' value from the app ID
5065  *
5066  * @par         This API is for package-manager client application
5067  * @par Sync (or) Async : Synchronous API
5068  *
5069  * @param[in]   handle  pointer to application info handle
5070  * @param[out]  disabled        pointer to hold application is_disabled value
5071  * @return      0 if success, error code(<0) if fail
5072  * @retval      PMINFO_R_OK     success
5073  * @retval      PMINFO_R_EINVAL invalid argument
5074  * @pre         pkgmgrinfo_appinfo_get_appinfo()
5075  * @post        pkgmgrinfo_appinfo_destroy_appinfo()
5076  * @code
5077 static int get_app_is_disable(const char *appid)
5078 {
5079         int ret = 0;
5080         bool is_disable;
5081         pkgmgrinfo_appinfo_h handle = NULL;
5082         ret = pkgmgrinfo_appinfo_get_appinfo(appid, &handle);
5083         if (ret != PMINFO_R_OK)
5084                 return -1;
5085         ret = pkgmgrinfo_appinfo_is_disabled(handle, &is_disable);
5086         if (ret != PMINFO_R_OK) {
5087                 pkgmgrinfo_appinfo_destroy_appinfo(handle);
5088                 return -1;
5089         }
5090         printf("app is_disable: %d\n", is_disable);
5091         pkgmgrinfo_appinfo_destroy_appinfo(handle);
5092         return 0;
5093 }
5094  * @endcode
5095  */
5096 int pkgmgrinfo_appinfo_is_disabled(pkgmgrinfo_appinfo_h handle, bool *disabled);
5097
5098 /**
5099  * @fn int pkgmgrinfo_appinfo_is_global(pkgmgrinfo_appinfo_h handle, bool *global)
5100  * @brief       This API gets whethere the given application is global application or user application
5101  *
5102  * @par         This API is for package-manager client application
5103  * @par Sync (or) Async : Synchronous API
5104  *
5105  * @param[in]   handle  pointer to application info handle
5106  * @param[in]   global  pointer to hold application global value
5107  * @return      0 if success, error code(<0) if fail
5108  * @retval      PMINFO_R_OK     success
5109  * @retval      PMINFO_R_EINVAL invalid argument
5110  * @retval      PMINFO_R_ERROR  internal error
5111  * @pre         pkgmgrinfo_appinfo_get_appinfo()
5112  * @post                pkgmgrinfo_appinfo_destroy_appinfo()
5113  * @see         pkgmgrinfo_appinfo_get_appid()
5114  static int get_app_is_global(const char *appid)
5115  {
5116          int ret = 0;
5117          bool global;
5118          pkgmgrinfo_appinfo_h handle = NULL;
5119          ret = pkgmgrinfo_appinfo_get_appinfo(appid, &handle);
5120          if (ret != PMINFO_R_OK)
5121                  return -1;
5122          ret = pkgmgrinfo_appinfo_is_global(handle, &global);
5123          if (ret != PMINFO_R_OK) {
5124                  pkgmgrinfo_appinfo_destroy_appinfo(handle);
5125                  return -1;
5126          }
5127          printf("app is_global: %d\n", global);
5128          pkgmgrinfo_appinfo_destroy_appinfo(handle);
5129          return 0;
5130  }
5131   * @endcode
5132   */
5133 int pkgmgrinfo_appinfo_is_global(pkgmgrinfo_appinfo_h handle, bool *global);
5134
5135 /**
5136  * @fn int pkgmgrinfo_appinfo_get_splash_screen_display(pkgmgrinfo_appinfo_h handle, bool *splash_screen_display)
5137  * @brief       This API gets the application 'splash_screen_display' value from the app ID
5138  *
5139  * @par         This API is for package-manager client application
5140  * @par Sync (or) Async : Synchronous API
5141  *
5142  * @param[in]   handle          pointer to application info handle
5143  * @param[out]  splash_screen_display   pointer to hold package splash_screen_display value
5144  * @return      0 if success, error code(<0) if fail
5145  * @retval      PMINFO_R_OK     success
5146  * @retval      PMINFO_R_EINVAL invalid argument
5147  * @retval      PMINFO_R_ERROR  internal error
5148  */
5149 int pkgmgrinfo_appinfo_get_splash_screen_display(pkgmgrinfo_appinfo_h handle, bool *splash_screen_display);
5150
5151 /**
5152  * @fn int pkgmgrinfo_appinfo_get_setup_appid(pkgmgrinfo_appinfo_h handle, char **setup_appid)
5153  * @brief       This API gets the application 'setup_appid' value from the app ID
5154  *
5155  * @par         This API is for package-manager client application
5156  * @par Sync (or) Async : Synchronous API
5157  *
5158  * @param[in]   handle          pointer to application info handle
5159  * @param[out]  setup_appid     pointer to hold package setup_appid value
5160  * @return      0 if success, error code(<0) if fail
5161  * @retval      PMINFO_R_OK     success
5162  * @retval      PMINFO_R_EINVAL invalid argument
5163  * @retval      PMINFO_R_ERROR  internal error
5164  */
5165 int pkgmgrinfo_appinfo_get_setup_appid(pkgmgrinfo_appinfo_h handle, char **setup_appid);
5166
5167 /**
5168  * @fn int pkgmgrinfo_appinfo_is_support_ambient(pkgmgrinfo_appinfo_h handle, bool *support_ambient)
5169  * @brief       This API gets the application 'support_ambient' value from the app ID
5170  *
5171  * @par         This API is for package-manager client application
5172  * @par Sync (or) Async : Synchronous API
5173  *
5174  * @param[in]   handle          pointer to application info handle
5175  * @param[out]  support_ambient pointer to hold package support_ambient value
5176  * @return      0 if success, error code(<0) if fail
5177  * @retval      PMINFO_R_OK     success
5178  * @retval      PMINFO_R_EINVAL invalid argument
5179  * @retval      PMINFO_R_ERROR  internal error
5180  */
5181 int pkgmgrinfo_appinfo_is_support_ambient(pkgmgrinfo_appinfo_h handle, bool *support_ambient);
5182
5183 /**
5184  * @fn int pkgmgrinfo_appinfo_destroy_appinfo(pkgmgrinfo_appinfo_h handle)
5185  * @brief       This API destroys the application information handle freeing up all the resources
5186  *
5187  * @par         This API is for package-manager client application
5188  * @par Sync (or) Async : Synchronous API
5189  *
5190  * @param[in] handle            pointer to the application info handle.
5191  * @return      0 if success, error code(<0) if fail
5192  * @retval      PMINFO_R_OK     success
5193  * @retval      PMINFO_R_EINVAL invalid argument
5194  * @retval      PMINFO_R_ERROR  internal error
5195  * @pre         pkgmgrinfo_appinfo_get_appinfo()
5196  * @post                None
5197  * @see         pkgmgrinfo_appinfo_get_pkgid()
5198  * @see         pkgmgrinfo_appinfo_is_multiple()
5199  * @code
5200 static int get_app_type(const char *appid)
5201 {
5202         int ret = 0;
5203         char *type = NULL;
5204         pkgmgrinfo_appinfo_h handle;
5205         ret = pkgmgrinfo_appinfo_get_appinfo(appid, &handle);
5206         if (ret != PMINFO_R_OK)
5207                 return -1;
5208         ret = pkgmgrinfo_appinfo_get_apptype(handle, &type);
5209         if (ret != PMINFO_R_OK) {
5210                 pkgmgrinfo_appinfo_destroy_appinfo(handle);
5211                 return -1;
5212         }
5213         printf("apptype: %s\n", type);
5214         pkgmgrinfo_appinfo_destroy_appinfo(handle);
5215         return 0;
5216 }
5217  * @endcode
5218  */
5219 int pkgmgrinfo_appinfo_destroy_appinfo(pkgmgrinfo_appinfo_h  handle);
5220
5221 /**
5222  * @fn int pkgmgrinfo_appinfo_filter_create(pkgmgrinfo_appinfo_filter_h *handle)
5223  * @brief       This API creates the application information filter handle from db.  All filter properties will be ANDed.
5224  The query will search the entire application information collected from the manifest file of all the installed packages
5225  *
5226  * @par         This API is for package-manager client application
5227  * @par Sync (or) Async : Synchronous API
5228  *
5229  * @param[out] handle           pointer to the application info filter handle.
5230  * @return      0 if success, error code(<0) if fail
5231  * @retval      PMINFO_R_OK     success
5232  * @retval      PMINFO_R_EINVAL invalid argument
5233  * @retval      PMINFO_R_ERROR  internal error
5234  * @pre         None
5235  * @post                pkgmgrinfo_appinfo_filter_destroy()
5236  * @see         pkgmgrinfo_appinfo_filter_count()
5237  * @see         pkgmgrinfo_appinfo_filter_foreach_appinfo()
5238  * @code
5239 static int get_capp_count()
5240 {
5241         int ret = 0;
5242         int count = 0;
5243         pkgmgrinfo_appinfo_filter_h handle;
5244         ret = pkgmgrinfo_appinfo_filter_create(&handle);
5245         if (ret != PMINFO_R_OK)
5246                 return -1;
5247         ret = pkgmgrinfo_appinfo_filter_add_string(handle, PMINFO_APPINFO_PROP_APP_TYPE, "capp");
5248         if (ret != PMINFO_R_OK) {
5249                 pkgmgrinfo_appinfo_filter_destroy(handle);
5250                 return -1;
5251         }
5252         ret = pkgmgrinfo_appinfo_filter_count(handle, &count);
5253         if (ret != PMINFO_R_OK) {
5254                 pkgmgrinfo_appinfo_filter_destroy(handle);
5255                 return -1;
5256         }
5257         printf("No of capp: %d\n", count);
5258         pkgmgrinfo_appinfo_filter_destroy(handle);
5259         return 0;
5260 }
5261  * @endcode
5262  */
5263 int pkgmgrinfo_appinfo_filter_create(pkgmgrinfo_appinfo_filter_h *handle);
5264
5265 /**
5266  * @fn int pkgmgrinfo_appinfo_filter_destroy(pkgmgrinfo_appinfo_filter_h handle)
5267  * @brief       This API destroys the application information filter handle freeing up all the resources
5268  *
5269  * @par         This API is for package-manager client application
5270  * @par Sync (or) Async : Synchronous API
5271  *
5272  * @param[in] handle            pointer to the application info filter handle.
5273  * @return      0 if success, error code(<0) if fail
5274  * @retval      PMINFO_R_OK     success
5275  * @retval      PMINFO_R_EINVAL invalid argument
5276  * @retval      PMINFO_R_ERROR  internal error
5277  * @pre         pkgmgrinfo_appinfo_filter_create()
5278  * @post                None
5279  * @see         pkgmgrinfo_appinfo_filter_count()
5280  * @see         pkgmgrinfo_appinfo_filter_foreach_appinfo()
5281  * @code
5282 static int get_capp_count()
5283 {
5284         int ret = 0;
5285         int count = 0;
5286         pkgmgrinfo_appinfo_filter_h handle;
5287         ret = pkgmgrinfo_appinfo_filter_create(&handle);
5288         if (ret != PMINFO_R_OK)
5289                 return -1;
5290         ret = pkgmgrinfo_appinfo_filter_add_string(handle, PMINFO_APPINFO_PROP_APP_TYPE, "capp");
5291         if (ret != PMINFO_R_OK) {
5292                 pkgmgrinfo_appinfo_filter_destroy(handle);
5293                 return -1;
5294         }
5295         ret = pkgmgrinfo_appinfo_filter_count(handle, &count);
5296         if (ret != PMINFO_R_OK) {
5297                 pkgmgrinfo_appinfo_filter_destroy(handle);
5298                 return -1;
5299         }
5300         printf("No of capp: %d\n", count);
5301         pkgmgrinfo_appinfo_filter_destroy(handle);
5302         return 0;
5303 }
5304  * @endcode
5305  */
5306 int pkgmgrinfo_appinfo_filter_destroy(pkgmgrinfo_appinfo_filter_h handle);
5307
5308 /**
5309  * @fn int pkgmgrinfo_appinfo_filter_add_bool(pkgmgrinfo_appinfo_filter_h handle, const char *property, const bool value)
5310  * @brief       This API adds a boolean filter property to the filter handle
5311  *
5312  * @par         This API is for package-manager client application
5313  * @par Sync (or) Async : Synchronous API
5314  *
5315  * @param[in] handle            pointer to the application info filter handle.
5316  * @param[in] property          boolean property name.
5317  * @param[in] value             value corresponding to the property.
5318  * @return      0 if success, error code(<0) if fail
5319  * @retval      PMINFO_R_OK     success
5320  * @retval      PMINFO_R_EINVAL invalid argument
5321  * @retval      PMINFO_R_ERROR  internal error
5322  * @pre         pkgmgrinfo_appinfo_filter_create()
5323  * @post                pkgmgrinfo_appinfo_filter_destroy()
5324  * @see         pkgmgrinfo_appinfo_filter_count()
5325  * @see         pkgmgrinfo_appinfo_filter_foreach_appinfo()
5326  * @code
5327 static int get_taskmanageable_app_count()
5328 {
5329         int ret = 0;
5330         int count = 0;
5331         pkgmgrinfo_appinfo_filter_h handle;
5332         ret = pkgmgrinfo_appinfo_filter_create(&handle);
5333         if (ret != PMINFO_R_OK)
5334                 return -1;
5335         ret = pkgmgrinfo_appinfo_filter_add_bool(handle, PMINFO_APPINFO_PROP_APP_TASKMANAGE, 1);
5336         if (ret != PMINFO_R_OK) {
5337                 pkgmgrinfo_appinfo_filter_destroy(handle);
5338                 return -1;
5339         }
5340         ret = pkgmgrinfo_appinfo_filter_count(handle, &count);
5341         if (ret != PMINFO_R_OK) {
5342                 pkgmgrinfo_appinfo_filter_destroy(handle);
5343                 return -1;
5344         }
5345         printf("No of taskmanageable apps: %d\n", count);
5346         pkgmgrinfo_appinfo_filter_destroy(handle);
5347         return 0;
5348 }
5349  * @endcode
5350  */
5351 int pkgmgrinfo_appinfo_filter_add_bool(pkgmgrinfo_appinfo_filter_h handle,
5352                 const char *property, const bool value);
5353
5354 /**
5355  * @fn int pkgmgrinfo_appinfo_filter_add_int(pkgmgrinfo_appinfo_filter_h handle, const char *property, const int value)
5356  * @brief       This API adds an integer filter property to the filter handle
5357  *
5358  * @par         This API is for package-manager client application
5359  * @par Sync (or) Async : Synchronous API
5360  *
5361  * @param[in] handle            pointer to the application info filter handle.
5362  * @param[in] property          integer property name.
5363  * @param[in] value             value corresponding to the property.
5364  * @return      0 if success, error code(<0) if fail
5365  * @retval      PMINFO_R_OK     success
5366  * @retval      PMINFO_R_EINVAL invalid argument
5367  * @retval      PMINFO_R_ERROR  internal error
5368  * @pre         pkgmgrinfo_appinfo_filter_create()
5369  * @post                pkgmgrinfo_appinfo_filter_destroy()
5370  * @see         pkgmgrinfo_appinfo_filter_count()
5371  * @see         pkgmgrinfo_appinfo_filter_foreach_appinfo()
5372  * @code
5373 static int get_taskmanageable_app_count()
5374 {
5375         int ret = 0;
5376         int count = 0;
5377         pkgmgrinfo_appinfo_filter_h handle;
5378         ret = pkgmgrinfo_appinfo_filter_create(&handle);
5379         if (ret != PMINFO_R_OK)
5380                 return -1;
5381         ret = pkgmgrinfo_appinfo_filter_add_bool(handle, PMINFO_APPINFO_PROP_APP_XXX, 10);
5382         if (ret != PMINFO_R_OK) {
5383                 pkgmgrinfo_appinfo_filter_destroy(handle);
5384                 return -1;
5385         }
5386         ret = pkgmgrinfo_appinfo_filter_count(handle, &count);
5387         if (ret != PMINFO_R_OK) {
5388                 pkgmgrinfo_appinfo_filter_destroy(handle);
5389                 return -1;
5390         }
5391         printf("No of apps: %d\n", count);
5392         pkgmgrinfo_appinfo_filter_destroy(handle);
5393         return 0;
5394 }
5395  * @endcode
5396  */
5397 int pkgmgrinfo_appinfo_filter_add_int(pkgmgrinfo_appinfo_filter_h handle,
5398                 const char *property, const int value);
5399
5400 /**
5401  * @fn int pkgmgrinfo_appinfo_filter_add_string(pkgmgrinfo_appinfo_filter_h handle, const char *property, const char *value)
5402  * @brief       This API adds a string filter property to the filter handle
5403  *
5404  * @par         This API is for package-manager client application
5405  * @par Sync (or) Async : Synchronous API
5406  *
5407  * @param[in] handle            pointer to the application info filter handle.
5408  * @param[in] property          string property name.
5409  * @param[in] value             value corresponding to the property.
5410  * @return      0 if success, error code(<0) if fail
5411  * @retval      PMINFO_R_OK     success
5412  * @retval      PMINFO_R_EINVAL invalid argument
5413  * @retval      PMINFO_R_ERROR  internal error
5414  * @pre         pkgmgrinfo_appinfo_filter_create()
5415  * @post                pkgmgrinfo_appinfo_filter_destroy()
5416  * @see         pkgmgrinfo_appinfo_filter_count()
5417  * @see         pkgmgrinfo_appinfo_filter_foreach_appinfo()
5418  * @code
5419 static int get_capp_count()
5420 {
5421         int ret = 0;
5422         int count = 0;
5423         pkgmgrinfo_appinfo_filter_h handle;
5424         ret = pkgmgrinfo_appinfo_filter_create(&handle);
5425         if (ret != PMINFO_R_OK)
5426                 return -1;
5427         ret = pkgmgrinfo_appinfo_filter_add_string(handle, PMINFO_APPINFO_PROP_APP_TYPE, "capp");
5428         if (ret != PMINFO_R_OK) {
5429                 pkgmgrinfo_appinfo_filter_destroy(handle);
5430                 return -1;
5431         }
5432         ret = pkgmgrinfo_appinfo_filter_count(handle, &count);
5433         if (ret != PMINFO_R_OK) {
5434                 pkgmgrinfo_appinfo_filter_destroy(handle);
5435                 return -1;
5436         }
5437         printf("No of capp: %d\n", count);
5438         pkgmgrinfo_appinfo_filter_destroy(handle);
5439         return 0;
5440 }
5441  * @endcode
5442  */
5443 int pkgmgrinfo_appinfo_filter_add_string(pkgmgrinfo_appinfo_filter_h handle,
5444                 const char *property, const char *value);
5445
5446 /**
5447  * @fn int pkgmgrinfo_appinfo_filter_foreach_appinfo(pkgmgrinfo_appinfo_filter_h handle, pkgmgrinfo_app_list_cb app_cb, void *user_data)
5448  * @brief       This API executes the user supplied callback function for each application that satisfy the filter conditions
5449  *
5450  * @par         This API is for package-manager client application
5451  * @par Sync (or) Async : Synchronous API
5452  *
5453  * @param[in] handle            pointer to the application info filter handle.
5454  * @param[in] app_cb            callback function.
5455  * @param[in] user_data         user data to be passed to the callback function
5456  * @return      0 if success, error code(<0) if fail
5457  * @retval      PMINFO_R_OK     success
5458  * @retval      PMINFO_R_EINVAL invalid argument
5459  * @retval      PMINFO_R_ERROR  internal error
5460  * @pre         pkgmgrinfo_appinfo_filter_create()
5461  * @post                pkgmgrinfo_appinfo_filter_destroy()
5462  * @see         pkgmgrinfo_appinfo_filter_count()
5463  * @code
5464 int app_list_cb(pkgmgrinfo_appinfo_h handle, void *user_data)
5465 {
5466         char *appid = NULL;
5467         pkgmgrinfo_appinfo_get_appid(handle, &appid);
5468         printf("appid : %s\n", appid);
5469         return 0;
5470 }
5471
5472 static int get_capp_list()
5473 {
5474         int ret = 0;
5475         pkgmgrinfo_appinfo_filter_h handle;
5476         ret = pkgmgrinfo_appinfo_filter_create(&handle);
5477         if (ret != PMINFO_R_OK)
5478                 return -1;
5479         ret = pkgmgrinfo_appinfo_filter_add_string(handle, PMINFO_APPINFO_PROP_APP_TYPE, "capp");
5480         if (ret != PMINFO_R_OK) {
5481                 pkgmgrinfo_appinfo_filter_destroy(handle);
5482                 return -1;
5483         }
5484         ret = pkgmgrinfo_appinfo_filter_foreach_appinfo(handle, app_list_cb, NULL);
5485         if (ret != PMINFO_R_OK) {
5486                 pkgmgrinfo_appinfo_filter_destroy(handle);
5487                 return -1;
5488         }
5489         pkgmgrinfo_appinfo_filter_destroy(handle);
5490         return 0;
5491 }
5492  * @endcode
5493  */
5494 int pkgmgrinfo_appinfo_filter_foreach_appinfo(pkgmgrinfo_appinfo_filter_h handle,
5495                 pkgmgrinfo_app_list_cb app_cb, void *user_data);
5496 int pkgmgrinfo_appinfo_usr_filter_foreach_appinfo(pkgmgrinfo_appinfo_filter_h handle,
5497                 pkgmgrinfo_app_list_cb app_cb, void *user_data, uid_t uid);
5498
5499 /**
5500  * @fn int pkgmgrinfo_appinfo_filter_count(pkgmgrinfo_appinfo_filter_h handle, int *count)
5501  * @fn int pkgmgrinfo_appinfo_usr_filter_count(pkgmgrinfo_appinfo_filter_h handle, int *count, uid_t uid)
5502  * @brief       This API counts the application that satisfy the filter conditions
5503  *
5504  * @par         This API is for package-manager client application
5505  * @par Sync (or) Async : Synchronous API
5506  *
5507  * @param[in] handle            pointer to the application info filter handle.
5508  * @param[in] count             pointer to store count value
5509  * @param[in]   uid     the addressee user id of the instruction
5510  * @return      0 if success, error code(<0) if fail
5511  * @retval      PMINFO_R_OK     success
5512  * @retval      PMINFO_R_EINVAL invalid argument
5513  * @retval      PMINFO_R_ERROR  internal error
5514  * @pre         pkgmgrinfo_appinfo_filter_create()
5515  * @post                pkgmgrinfo_appinfo_filter_destroy()
5516  * @see         pkgmgrinfo_appinfo_filter_foreach_appinfo()
5517  * @code
5518 static int get_capp_count()
5519 {
5520         int ret = 0;
5521         int count = 0;
5522         pkgmgrinfo_appinfo_filter_h handle;
5523         ret = pkgmgrinfo_appinfo_filter_create(&handle);
5524         if (ret != PMINFO_R_OK)
5525                 return -1;
5526         ret = pkgmgrinfo_appinfo_filter_add_string(handle, PMINFO_APPINFO_PROP_APP_TYPE, "capp");
5527         if (ret != PMINFO_R_OK) {
5528                 pkgmgrinfo_appinfo_filter_destroy(handle);
5529                 return -1;
5530         }
5531         ret = pkgmgrinfo_appinfo_filter_count(handle, &count);
5532         if (ret != PMINFO_R_OK) {
5533                 pkgmgrinfo_appinfo_filter_destroy(handle);
5534                 return -1;
5535         }
5536         printf("No of capp: %d\n", count);
5537         pkgmgrinfo_appinfo_filter_destroy(handle);
5538         return 0;
5539 }
5540  * @endcode
5541  */
5542 int pkgmgrinfo_appinfo_filter_count(pkgmgrinfo_appinfo_filter_h handle, int *count);
5543 int pkgmgrinfo_appinfo_usr_filter_count(pkgmgrinfo_appinfo_filter_h handle, int *count, uid_t uid);
5544 /**
5545  * @fn int pkgmgrinfo_appinfo_metadata_filter_create(pkgmgrinfo_appinfo_metadata_filter_h *handle)
5546  * @brief       This API creates the application's metadata  information filter handle from db.
5547  *
5548  * @par         This API is for package-manager client application
5549  * @par Sync (or) Async : Synchronous API
5550  *
5551  * @param[out] handle           pointer to the application metadata info filter handle.
5552  * @return      0 if success, error code(<0) if fail
5553  * @retval      PMINFO_R_OK     success
5554  * @retval      PMINFO_R_EINVAL invalid argument
5555  * @retval      PMINFO_R_ERROR  internal error
5556  * @pre         None
5557  * @post                pkgmgrinfo_appinfo_metadata_filter_destroy()
5558  * @see         pkgmgrinfo_appinfo_metadata_filter_foreach()
5559  * @code
5560 int app_list_cb(pkgmgrinfo_appinfo_h handle, void *user_data)
5561 {
5562         char *appid = NULL;
5563         pkgmgrinfo_appinfo_get_appid(handle, &appid);
5564         printf("appid : %s\n", appid);
5565         return 0;
5566 }
5567
5568 static int get_app_list(const char *mkey, const char *mvalue)
5569 {
5570         int ret = 0;
5571         pkgmgrinfo_appinfo_metadata_filter_h handle;
5572         ret = pkgmgrinfo_appinfo_metadata_filter_create(&handle);
5573         if (ret != PMINFO_R_OK)
5574                 return -1;
5575         ret = pkgmgrinfo_appinfo_metadata_filter_add(handle, mkey, mvalue);
5576         if (ret != PMINFO_R_OK) {
5577                 pkgmgrinfo_appinfo_metadata_filter_destroy(handle);
5578                 return -1;
5579         }
5580         ret = pkgmgrinfo_appinfo_metadata_filter_foreach(handle, app_list_cb, NULL);
5581         if (ret != PMINFO_R_OK) {
5582                 pkgmgrinfo_appinfo_metadata_filter_destroy(handle);
5583                 return -1;
5584         }
5585         pkgmgrinfo_appinfo_metadata_filter_destroy(handle);
5586         return 0;
5587 }
5588  * @endcode
5589  */
5590 int pkgmgrinfo_appinfo_metadata_filter_create(pkgmgrinfo_appinfo_metadata_filter_h *handle);
5591
5592 /**
5593  * @fn int pkgmgrinfo_appinfo_metadata_filter_destroy(pkgmgrinfo_appinfo_metadata_filter_h handle)
5594  * @brief       This API destroys the application's metadata  information filter handle.
5595  *
5596  * @par         This API is for package-manager client application
5597  * @par Sync (or) Async : Synchronous API
5598  *
5599  * @param[in] handle            pointer to the application metadata info filter handle.
5600  * @return      0 if success, error code(<0) if fail
5601  * @retval      PMINFO_R_OK     success
5602  * @retval      PMINFO_R_EINVAL invalid argument
5603  * @retval      PMINFO_R_ERROR  internal error
5604  * @pre         pkgmgrinfo_appinfo_metadata_filter_create()
5605  * @post                None
5606  * @see         pkgmgrinfo_appinfo_metadata_filter_foreach()
5607  * @code
5608 int app_list_cb(pkgmgrinfo_appinfo_h handle, void *user_data)
5609 {
5610         char *appid = NULL;
5611         pkgmgrinfo_appinfo_get_appid(handle, &appid);
5612         printf("appid : %s\n", appid);
5613         return 0;
5614 }
5615
5616 static int get_app_list(const char *mkey, const char *mvalue)
5617 {
5618         int ret = 0;
5619         pkgmgrinfo_appinfo_metadata_filter_h handle;
5620         ret = pkgmgrinfo_appinfo_metadata_filter_create(&handle);
5621         if (ret != PMINFO_R_OK)
5622                 return -1;
5623         ret = pkgmgrinfo_appinfo_metadata_filter_add(handle, mkey, mvalue);
5624         if (ret != PMINFO_R_OK) {
5625                 pkgmgrinfo_appinfo_metadata_filter_destroy(handle);
5626                 return -1;
5627         }
5628         ret = pkgmgrinfo_appinfo_metadata_filter_foreach(handle, app_list_cb, NULL);
5629         if (ret != PMINFO_R_OK) {
5630                 pkgmgrinfo_appinfo_metadata_filter_destroy(handle);
5631                 return -1;
5632         }
5633         pkgmgrinfo_appinfo_metadata_filter_destroy(handle);
5634         return 0;
5635 }
5636  * @endcode
5637  */
5638 int pkgmgrinfo_appinfo_metadata_filter_destroy(pkgmgrinfo_appinfo_metadata_filter_h handle);
5639
5640 /**
5641  * @fn int pkgmgrinfo_appinfo_metadata_filter_add(pkgmgrinfo_appinfo_metadata_filter_h handle, const char *key, const char *value)
5642  * @brief       This API adds filter condition for the query API.  The query will search the entire application metadata  information collected from
5643  * the manifest file of all the installed packages. You can specify value as NULL to search based on key only.
5644  *
5645  * @par         This API is for package-manager client application
5646  * @par Sync (or) Async : Synchronous API
5647  *
5648  * @param[in] handle            pointer to the application metadata info filter handle.
5649  * @param[in] key                       pointer to metadata key
5650  * @param[in] value                     pointer to metadata value
5651  * @return      0 if success, error code(<0) if fail
5652  * @retval      PMINFO_R_OK     success
5653  * @retval      PMINFO_R_EINVAL invalid argument
5654  * @retval      PMINFO_R_ERROR  internal error
5655  * @pre         pkgmgrinfo_appinfo_metadata_filter_create()
5656  * @post                pkgmgrinfo_appinfo_metadata_filter_foreach(), pkgmgrinfo_appinfo_metadata_filter_destroy()
5657  * @see         pkgmgrinfo_appinfo_metadata_filter_foreach()
5658  * @code
5659 int app_list_cb(pkgmgrinfo_appinfo_h handle, void *user_data)
5660 {
5661         char *appid = NULL;
5662         pkgmgrinfo_appinfo_get_appid(handle, &appid);
5663         printf("appid : %s\n", appid);
5664         return 0;
5665 }
5666
5667 static int get_app_list(const char *mkey, const char *mvalue)
5668 {
5669         int ret = 0;
5670         pkgmgrinfo_appinfo_metadata_filter_h handle;
5671         ret = pkgmgrinfo_appinfo_metadata_filter_create(&handle);
5672         if (ret != PMINFO_R_OK)
5673                 return -1;
5674         ret = pkgmgrinfo_appinfo_metadata_filter_add(handle, mkey, mvalue);
5675         if (ret != PMINFO_R_OK) {
5676                 pkgmgrinfo_appinfo_metadata_filter_destroy(handle);
5677                 return -1;
5678         }
5679         ret = pkgmgrinfo_appinfo_metadata_filter_foreach(handle, app_list_cb, NULL);
5680         if (ret != PMINFO_R_OK) {
5681                 pkgmgrinfo_appinfo_metadata_filter_destroy(handle);
5682                 return -1;
5683         }
5684         pkgmgrinfo_appinfo_metadata_filter_destroy(handle);
5685         return 0;
5686 }
5687  * @endcode
5688  */
5689 int pkgmgrinfo_appinfo_metadata_filter_add(pkgmgrinfo_appinfo_metadata_filter_h handle,
5690                 const char *key, const char *value);
5691
5692 /**
5693  * @fn int pkgmgrinfo_appinfo_metadata_filter_foreach(pkgmgrinfo_appinfo_metadata_filter_h handle, pkgmgrinfo_app_list_cb app_cb, void *user_data)
5694  * @fn int pkgmgrinfo_appinfo_usr_metadata_filter_foreach(pkgmgrinfo_appinfo_metadata_filter_h handle, pkgmgrinfo_app_list_cb app_cb, void *user_data, uid_t uid)
5695  * @brief       This API executes the filter query. The query will search the entire application metadata  information collected from
5696  * the manifest file of all the installed packages. For each application returned by the query, the callback will be called. If callback returns
5697  * negative value, no more callbacks will be called and API will return.
5698  *
5699  * @par         This API is for package-manager client application
5700  * @par Sync (or) Async : Synchronous API
5701  *
5702  * @param[in] handle            pointer to the application metadata info filter handle.
5703  * @param[in] app_cb            function pointer to callback
5704  * @param[in] user_data         pointer to user data
5705  * @param[in]   uid     the addressee user id of the instruction
5706  * @return      0 if success, error code(<0) if fail
5707  * @retval      PMINFO_R_OK     success
5708  * @retval      PMINFO_R_EINVAL invalid argument
5709  * @retval      PMINFO_R_ERROR  internal error
5710  * @pre         pkgmgrinfo_appinfo_metadata_filter_create()
5711  * @post                pkgmgrinfo_appinfo_metadata_filter_destroy()
5712  * @code
5713 int app_list_cb(pkgmgrinfo_appinfo_h handle, void *user_data)
5714 {
5715         char *appid = NULL;
5716         pkgmgrinfo_appinfo_get_appid(handle, &appid);
5717         printf("appid : %s\n", appid);
5718         return 0;
5719 }
5720
5721 static int get_app_list(const char *mkey, const char *mvalue)
5722 {
5723         int ret = 0;
5724         pkgmgrinfo_appinfo_metadata_filter_h handle;
5725         ret = pkgmgrinfo_appinfo_metadata_filter_create(&handle);
5726         if (ret != PMINFO_R_OK)
5727                 return -1;
5728         ret = pkgmgrinfo_appinfo_metadata_filter_add(handle, mkey, mvalue);
5729         if (ret != PMINFO_R_OK) {
5730                 pkgmgrinfo_appinfo_metadata_filter_destroy(handle);
5731                 return -1;
5732         }
5733         ret = pkgmgrinfo_appinfo_metadata_filter_foreach(handle, app_list_cb, NULL);
5734         if (ret != PMINFO_R_OK) {
5735                 pkgmgrinfo_appinfo_metadata_filter_destroy(handle);
5736                 return -1;
5737         }
5738         pkgmgrinfo_appinfo_metadata_filter_destroy(handle);
5739         return 0;
5740 }
5741  * @endcode
5742  */
5743 int pkgmgrinfo_appinfo_metadata_filter_foreach(pkgmgrinfo_appinfo_metadata_filter_h handle,
5744                 pkgmgrinfo_app_list_cb app_cb, void *user_data);
5745 int pkgmgrinfo_appinfo_usr_metadata_filter_foreach(pkgmgrinfo_appinfo_metadata_filter_h handle,
5746                 pkgmgrinfo_app_list_cb app_cb, void *user_data, uid_t uid);
5747 /**
5748  * @fn int pkgmgrinfo_pkginfo_create_certinfo(pkgmgrinfo_certinfo_h *handle)
5749  * @brief       This API creates the package cert information handle to get data from db.
5750  *
5751  * @par         This API is for package-manager client application
5752  * @par Sync (or) Async : Synchronous API
5753  *
5754  * @param[out] handle           pointer to the package cert handle.
5755  * @return      0 if success, error code(<0) if fail
5756  * @retval      PMINFO_R_OK     success
5757  * @retval      PMINFO_R_EINVAL invalid argument
5758  * @retval      PMINFO_R_ERROR  internal error
5759  * @pre         None
5760  * @post                pkgmgrinfo_pkginfo_destroy_certinfo()
5761  * @see         pkgmgrinfo_pkginfo_get_cert_value()
5762  * @see         pkgmgrinfo_pkginfo_load_certinfo()
5763  * @code
5764 static int get_cert_info(const char *pkgid)
5765 {
5766         int ret = 0;
5767         pkgmgrinfo_certinfo_h handle;
5768         char *auth_cert = NULL;
5769         ret = pkgmgrinfo_pkginfo_create_certinfo(&handle);
5770         if (ret != PMINFO_R_OK)
5771                 return -1;
5772         ret = pkgmgrinfo_pkginfo_load_certinfo(pkgid, handle);
5773         if (ret != PMINFO_R_OK) {
5774                 pkgmgrinfo_pkginfo_destroy_certinfo(handle);
5775                 return -1;
5776         }
5777         ret = pkgmgrinfo_pkginfo_get_cert_value(handle, PMINFO_AUTHOR_ROOT_CERT, &auth_cert);
5778         if (ret != PMINFO_R_OK) {
5779                 pkgmgrinfo_pkginfo_destroy_certinfo(handle);
5780                 return -1;
5781         }
5782         printf("Author root certificate: %s\n", auth_root);
5783         pkgmgrinfo_pkginfo_destroy_certinfo(handle);
5784         return 0;
5785 }
5786  * @endcode
5787  */
5788 int pkgmgrinfo_pkginfo_create_certinfo(pkgmgrinfo_certinfo_h *handle);
5789
5790 /**
5791  * @fn int pkgmgrinfo_pkginfo_load_certinfo(const char *pkgid, pkgmgrinfo_certinfo_h handle)
5792  * @brief       This API loads the package cert information handle with data from db.
5793  *
5794  * @par         This API is for package-manager client application
5795  * @par Sync (or) Async : Synchronous API
5796  *
5797  * @param[in] pkgid             pointer to the package ID.
5798  * @param[in] handle            pointer to the package cert handle.
5799  * @return      0 if success, error code(<0) if fail
5800  * @retval      PMINFO_R_OK     success
5801  * @retval      PMINFO_R_EINVAL invalid argument
5802  * @retval      PMINFO_R_ERROR  internal error
5803  * @pre         pkgmgrinfo_pkginfo_create_certinfo()
5804  * @post                pkgmgrinfo_pkginfo_destroy_certinfo()
5805  * @see         pkgmgrinfo_pkginfo_get_cert_value()
5806  * @code
5807 static int get_cert_info(const char *pkgid)
5808 {
5809         int ret = 0;
5810         pkgmgrinfo_certinfo_h handle;
5811         char *auth_cert = NULL;
5812         ret = pkgmgrinfo_pkginfo_create_certinfo(&handle);
5813         if (ret != PMINFO_R_OK)
5814                 return -1;
5815         ret = pkgmgrinfo_pkginfo_load_certinfo(pkgid, handle);
5816         if (ret != PMINFO_R_OK) {
5817                 pkgmgrinfo_pkginfo_destroy_certinfo(handle);
5818                 return -1;
5819         }
5820         ret = pkgmgrinfo_pkginfo_get_cert_value(handle, PMINFO_AUTHOR_ROOT_CERT, &auth_cert);
5821         if (ret != PMINFO_R_OK) {
5822                 pkgmgrinfo_pkginfo_destroy_certinfo(handle);
5823                 return -1;
5824         }
5825         printf("Author root certificate: %s\n", auth_root);
5826         pkgmgrinfo_pkginfo_destroy_certinfo(handle);
5827         return 0;
5828 }
5829  * @endcode
5830  */
5831 int pkgmgrinfo_pkginfo_load_certinfo(const char *pkgid, pkgmgrinfo_certinfo_h handle, uid_t uid);
5832
5833 /**
5834  * @fn int pkgmgrinfo_pkginfo_get_cert_value(pkgmgrinfo_certinfo_h handle, pkgmgrinfo_cert_type cert_type, const char **cert_value)
5835  * @brief       This API gets the package cert information from the handle
5836  *
5837  * @par         This API is for package-manager client application
5838  * @par Sync (or) Async : Synchronous API
5839  *
5840  * @param[in] handle            pointer to the package cert handle.
5841  * @param[in] cert_type         certificate type
5842  * @param[out] cert_value       pointer to hold certificate value
5843  * @return      0 if success, error code(<0) if fail
5844  * @retval      PMINFO_R_OK     success
5845  * @retval      PMINFO_R_EINVAL invalid argument
5846  * @retval      PMINFO_R_ERROR  internal error
5847  * @pre         pkgmgrinfo_pkginfo_create_certinfo()
5848  * @post                pkgmgrinfo_pkginfo_destroy_certinfo()
5849  * @see         pkgmgrinfo_pkginfo_load_certinfo()
5850  * @code
5851 static int get_cert_info(const char *pkgid)
5852 {
5853         int ret = 0;
5854         pkgmgrinfo_certinfo_h handle;
5855         char *auth_cert = NULL;
5856         ret = pkgmgrinfo_pkginfo_create_certinfo(&handle);
5857         if (ret != PMINFO_R_OK)
5858                 return -1;
5859         ret = pkgmgrinfo_pkginfo_load_certinfo(pkgid, handle);
5860         if (ret != PMINFO_R_OK) {
5861                 pkgmgrinfo_pkginfo_destroy_certinfo(handle);
5862                 return -1;
5863         }
5864         ret = pkgmgrinfo_pkginfo_get_cert_value(handle, PMINFO_AUTHOR_ROOT_CERT, &auth_cert);
5865         if (ret != PMINFO_R_OK) {
5866                 pkgmgrinfo_pkginfo_destroy_certinfo(handle);
5867                 return -1;
5868         }
5869         printf("Author root certificate: %s\n", auth_root);
5870         pkgmgrinfo_pkginfo_destroy_certinfo(handle);
5871         return 0;
5872 }
5873  * @endcode
5874  */
5875 int pkgmgrinfo_pkginfo_get_cert_value(pkgmgrinfo_certinfo_h handle, pkgmgrinfo_cert_type cert_type, const char **cert_value);
5876
5877 /**
5878  * @fn int pkgmgrinfo_pkginfo_destroy_certinfo(pkgmgrinfo_certinfo_h handle)
5879  * @brief       This API destroys the package cert information handle freeing up all the resources
5880  *
5881  * @par         This API is for package-manager client application
5882  * @par Sync (or) Async : Synchronous API
5883  *
5884  * @param[in] handle            pointer to the package cert handle.
5885  * @return      0 if success, error code(<0) if fail
5886  * @retval      PMINFO_R_OK     success
5887  * @retval      PMINFO_R_EINVAL invalid argument
5888  * @retval      PMINFO_R_ERROR  internal error
5889  * @pre         pkgmgrinfo_pkginfo_create_certinfo()
5890  * @post                None
5891  * @see         pkgmgrinfo_pkginfo_load_certinfo()
5892  * @code
5893 static int get_cert_info(const char *pkgid)
5894 {
5895         int ret = 0;
5896         pkgmgrinfo_certinfo_h handle;
5897         char *auth_cert = NULL;
5898         ret = pkgmgrinfo_pkginfo_create_certinfo(&handle);
5899         if (ret != PMINFO_R_OK)
5900                 return -1;
5901         ret = pkgmgrinfo_pkginfo_load_certinfo(pkgid, handle);
5902         if (ret != PMINFO_R_OK) {
5903                 pkgmgrinfo_pkginfo_destroy_certinfo(handle);
5904                 return -1;
5905         }
5906         ret = pkgmgrinfo_pkginfo_get_cert_value(handle, PMINFO_AUTHOR_ROOT_CERT, &auth_cert);
5907         if (ret != PMINFO_R_OK) {
5908                 pkgmgrinfo_pkginfo_destroy_certinfo(handle);
5909                 return -1;
5910         }
5911         printf("Author root certificate: %s\n", auth_root);
5912         pkgmgrinfo_pkginfo_destroy_certinfo(handle);
5913         return 0;
5914 }
5915  * @endcode
5916  */
5917 int pkgmgrinfo_pkginfo_destroy_certinfo(pkgmgrinfo_certinfo_h handle);
5918
5919 /**
5920  * @fn int pkgmgrinfo_delete_certinfo(const char *pkgid)
5921  * @brief       This API deletes the package cert information from DB
5922  *
5923  * @par         This API is for package-manager client application
5924  * @par Sync (or) Async : Synchronous API
5925  *
5926  * @param[in] pkgid             pointer to the package ID.
5927  * @return      0 if success, error code(<0) if fail
5928  * @retval      PMINFO_R_OK     success
5929  * @retval      PMINFO_R_EINVAL invalid argument
5930  * @retval      PMINFO_R_ERROR  internal error
5931  * @pre         None
5932  * @post                None
5933  * @code
5934 static int delete_cert_info(const char *pkgid)
5935 {
5936         int ret = 0;
5937         ret = pkgmgrinfo_delete_certinfo(pkgid);
5938         if (ret != PMINFO_R_OK)
5939                 return -1;
5940         return 0;
5941 }
5942  * @endcode
5943  */
5944 int pkgmgrinfo_delete_certinfo(const char *pkgid);
5945 int pkgmgrinfo_delete_usr_certinfo(const char *pkgid, uid_t uid);
5946
5947 /**
5948  * @fn int pkgmgrinfo_create_certinfo_set_handle(pkgmgrinfo_instcertinfo_h *handle)
5949  * @brief       This API creates the package cert information handle to set data in db.
5950  *
5951  * @par         This API is for package-manager client application
5952  * @par Sync (or) Async : Synchronous API
5953  *
5954  * @param[out] handle           pointer to the package cert handle.
5955  * @return      0 if success, error code(<0) if fail
5956  * @retval      PMINFO_R_OK     success
5957  * @retval      PMINFO_R_EINVAL invalid argument
5958  * @retval      PMINFO_R_ERROR  internal error
5959  * @pre         None
5960  * @post                pkgmgrinfo_destroy_certinfo_set_handle()
5961  * @see         pkgmgrinfo_set_cert_value()
5962  * @see         pkgmgrinfo_save_certinfo()
5963  * @code
5964 static int set_cert_in_db(const char *pkgid)
5965 {
5966         int ret = 0;
5967         pkgmgrinfo_instcertinfo_h handle;
5968         ret = pkgmgrinfo_create_certinfo_set_handle(&handle);
5969         if (ret != PMINFO_R_OK)
5970                 return -1;
5971         ret = pkgmgrinfo_set_cert_value(handle, PMINFO_SET_AUTHOR_ROOT_CERT, "author root certificate");
5972         if (ret != PMINFO_R_OK) {
5973                 pkgmgrinfo_destroy_certinfo_set_handle(handle);
5974                 return -1;
5975         }
5976         ret = pkgmgrinfo_save_certinfo(pkgid, handle);
5977         if (ret != PMINFO_R_OK) {
5978                 pkgmgrinfo_destroy_certinfo_set_handle(handle);
5979                 return -1;
5980         }
5981         pkgmgrinfo_destroy_certinfo_set_handle(handle);
5982         return 0;
5983 }
5984  * @endcode
5985  */
5986 int pkgmgrinfo_create_certinfo_set_handle(pkgmgrinfo_instcertinfo_h *handle);
5987
5988 /**
5989  * @fn int pkgmgrinfo_set_cert_value(pkgmgrinfo_instcertinfo_h handle, pkgmgrinfo_instcert_type cert_type, char *cert_value)
5990  * @brief       This API sets the package cert information in the handle.
5991  *
5992  * @par         This API is for package-manager client application
5993  * @par Sync (or) Async : Synchronous API
5994  *
5995  * @param[in] handle            pointer to the package cert handle.
5996  * @param[in] cert_type         certificate type.
5997  * @param[in] cert_value        certificate value.
5998  * @return      0 if success, error code(<0) if fail
5999  * @retval      PMINFO_R_OK     success
6000  * @retval      PMINFO_R_EINVAL invalid argument
6001  * @retval      PMINFO_R_ERROR  internal error
6002  * @pre         pkgmgrinfo_create_certinfo_set_handle()
6003  * @post                pkgmgrinfo_destroy_certinfo_set_handle()
6004  * @see         pkgmgrinfo_save_certinfo()
6005  * @code
6006 static int set_cert_in_db(const char *pkgid)
6007 {
6008         int ret = 0;
6009         pkgmgrinfo_instcertinfo_h handle;
6010         ret = pkgmgrinfo_create_certinfo_set_handle(&handle);
6011         if (ret != PMINFO_R_OK)
6012                 return -1;
6013         ret = pkgmgrinfo_set_cert_value(handle, PMINFO_SET_AUTHOR_ROOT_CERT, "author root certificate");
6014         if (ret != PMINFO_R_OK) {
6015                 pkgmgrinfo_destroy_certinfo_set_handle(handle);
6016                 return -1;
6017         }
6018         ret = pkgmgrinfo_save_certinfo(pkgid, handle);
6019         if (ret != PMINFO_R_OK) {
6020                 pkgmgrinfo_destroy_certinfo_set_handle(handle);
6021                 return -1;
6022         }
6023         pkgmgrinfo_destroy_certinfo_set_handle(handle);
6024         return 0;
6025 }
6026  * @endcode
6027  */
6028 int pkgmgrinfo_set_cert_value(pkgmgrinfo_instcertinfo_h handle, pkgmgrinfo_instcert_type cert_type, char *cert_value);
6029
6030 /**
6031  * @fn int pkgmgrinfo_save_certinfo(const char *pkgid, pkgmgrinfo_instcertinfo_h handle)
6032  * @brief       This API saves the package cert information in the DB.
6033  *
6034  * @par         This API is for package-manager client application
6035  * @par Sync (or) Async : Synchronous API
6036  *
6037  * @param[in] pkgid             pointer to the package ID.
6038  * @param[in] handle            pointer to the package cert handle.
6039  * @return      0 if success, error code(<0) if fail
6040  * @retval      PMINFO_R_OK     success
6041  * @retval      PMINFO_R_EINVAL invalid argument
6042  * @retval      PMINFO_R_ERROR  internal error
6043  * @pre         pkgmgrinfo_create_certinfo_set_handle()
6044  * @post                pkgmgrinfo_destroy_certinfo_set_handle()
6045  * @see         pkgmgrinfo_save_certinfo()
6046  * @code
6047 static int set_cert_in_db(const char *pkgid)
6048 {
6049         int ret = 0;
6050         pkgmgrinfo_instcertinfo_h handle;
6051         ret = pkgmgrinfo_create_certinfo_set_handle(&handle);
6052         if (ret != PMINFO_R_OK)
6053                 return -1;
6054         ret = pkgmgrinfo_set_cert_value(handle, PMINFO_SET_AUTHOR_ROOT_CERT, "author root certificate");
6055         if (ret != PMINFO_R_OK) {
6056                 pkgmgrinfo_destroy_certinfo_set_handle(handle);
6057                 return -1;
6058         }
6059         ret = pkgmgrinfo_save_certinfo(pkgid, handle);
6060         if (ret != PMINFO_R_OK) {
6061                 pkgmgrinfo_destroy_certinfo_set_handle(handle);
6062                 return -1;
6063         }
6064         pkgmgrinfo_destroy_certinfo_set_handle(handle);
6065         return 0;
6066 }
6067  * @endcode
6068  */
6069 int pkgmgrinfo_save_certinfo(const char *pkgid, pkgmgrinfo_instcertinfo_h handle, uid_t uid);
6070
6071 /**
6072  * @fn int pkgmgrinfo_destroy_certinfo_set_handle(pkgmgrinfo_instcertinfo_h handle)
6073  * @brief       This API destroys the package cert information handle freeing up all the resources.
6074  *
6075  * @par         This API is for package-manager client application
6076  * @par Sync (or) Async : Synchronous API
6077  *
6078  * @param[in] handle            pointer to the package cert handle.
6079  * @return      0 if success, error code(<0) if fail
6080  * @retval      PMINFO_R_OK     success
6081  * @retval      PMINFO_R_EINVAL invalid argument
6082  * @retval      PMINFO_R_ERROR  internal error
6083  * @pre         pkgmgrinfo_create_certinfo_set_handle()
6084  * @post                None
6085  * @see         pkgmgrinfo_save_certinfo()
6086  * @code
6087 static int set_cert_in_db(const char *pkgid)
6088 {
6089         int ret = 0;
6090         pkgmgrinfo_instcertinfo_h handle;
6091         ret = pkgmgrinfo_create_certinfo_set_handle(&handle);
6092         if (ret != PMINFO_R_OK)
6093                 return -1;
6094         ret = pkgmgrinfo_set_cert_value(handle, PMINFO_SET_AUTHOR_ROOT_CERT, "author root certificate");
6095         if (ret != PMINFO_R_OK) {
6096                 pkgmgrinfo_destroy_certinfo_set_handle(handle);
6097                 return -1;
6098         }
6099         ret = pkgmgrinfo_save_certinfo(pkgid, handle);
6100         if (ret != PMINFO_R_OK) {
6101                 pkgmgrinfo_destroy_certinfo_set_handle(handle);
6102                 return -1;
6103         }
6104         pkgmgrinfo_destroy_certinfo_set_handle(handle);
6105         return 0;
6106 }
6107  * @endcode
6108  */
6109 int pkgmgrinfo_destroy_certinfo_set_handle(pkgmgrinfo_instcertinfo_h handle);
6110
6111 /**
6112  * @fn int pkgmgrinfo_datacontrol_get_info(const char *providerid, const char * type, char **appid, char **access)
6113  * @brief       This API gets the datacontrol info
6114  *
6115  * @par         This API is for package-manager client application
6116  * @par Sync (or) Async : Synchronous API
6117  *
6118  * @param[in] providerid                pointer to the providerid of dataconltrol.
6119  * @param[in] type                      pointer to the type of dataconltrol.
6120  * @param[out] appid                    pointer to hold appid, need to free after using
6121  * @param[out] access                   pointer to hold access, need to free after using
6122  * @return      0 if success, error code(<0) if fail
6123  * @retval      PMINFO_R_OK     success
6124  * @retval      PMINFO_R_EINVAL invalid argument
6125  * @retval      PMINFO_R_ERROR  internal error
6126  * @endcode
6127  */
6128 int pkgmgrinfo_datacontrol_get_info(const char *providerid, const char * type, char **appid, char **access);
6129
6130 /**
6131  * @fn int pkgmgrinfo_appinfo_is_guestmode_appstatus(pkgmgrinfo_appinfo_h handle, bool *status)
6132  * @brief       This API gets the application 'guest mode visibility' value from the DB
6133  *
6134  * @par         This API is for package-manager client application
6135  * @par Sync (or) Async : Synchronous API
6136  *
6137  * @param[in]   handle  pointer to application info handle
6138  * @param[out] status           pointer to hold app guest mode visibility value
6139  * @return      0 if success, error code(<0) if fail
6140  * @retval      PMINFO_R_OK     success
6141  * @retval      PMINFO_R_EINVAL invalid argument
6142  * @retval      PMINFO_R_ERROR  internal error
6143  * @pre         pkgmgrinfo_appinfo_get_appinfo()
6144  * @post                pkgmgrinfo_appinfo_destroy_appinfo()
6145  * @see         pkgmgrinfo_appinfo_get_appid()
6146  * @see         pkgmgrinfo_appinfo_is_multiple()
6147  * @code
6148 static int get_app_guestmode_visibility(const char *appid)
6149 {
6150         int ret = 0;
6151         bool status;
6152         pkgmgrinfo_appinfo_h handle;
6153         ret = pkgmgrinfo_appinfo_get_appinfo(appid, &handle);
6154         if (ret != PMINFO_R_OK)
6155                 return -1;
6156         ret = pkgmgrinfo_appinfo_is_guestmode_visibility(handle, &status);
6157         if (ret != PMINFO_R_OK) {
6158                 pkgmgrinfo_appinfo_destroy_appinfo(handle);
6159                 return -1;
6160         }
6161         printf("app guest mode visibility: %d\n", status);
6162         pkgmgrinfo_appinfo_destroy_appinfo(handle);
6163         return 0;
6164 }
6165  * @endcode
6166  */
6167 int pkgmgrinfo_appinfo_is_guestmode_visibility(pkgmgrinfo_appinfo_h handle, bool *status);
6168
6169 /**
6170 * @fn int pkgmgrinfo_pkginfo_set_installed_storage(const char *pkgid, INSTALL_LOCATION location)
6171 * @brief         This API sets the package 'installed_storage' value in db
6172 *
6173 * @par  This API is for package-manager client application
6174 * @par Sync (or) Async : Synchronous API
6175 *
6176 * @param[in] pkgid              pointer to the package ID.
6177 * @param[in] location  package install location
6178 * @param[in] external_pkg_path  image path if pkg has installed at external storage
6179 * @return  0 if success, error code(<0) if fail
6180 * @retval  PMINFO_R_OK success
6181 * @retval  PMINFO_R_EINVAL       invalid argument
6182 * @retval  PMINFO_R_ERROR internal error
6183 * @code
6184 static int set_app_installed_storage(const char *appid, INSTALL_LOCATION location)
6185 {
6186         int ret = 0;
6187
6188         ret = pkgmgrinfo_pkginfo_set_installed_storage(handle, INSTALL_EXTERNAL);
6189         if (ret != PMINFO_R_OK) {
6190                 return -1;
6191         }
6192         return 0;
6193 }
6194 * @endcode
6195 */
6196 int pkgmgrinfo_pkginfo_set_installed_storage(const char *pkgid, INSTALL_LOCATION location, const char *external_pkg_path);
6197 int pkgmgrinfo_pkginfo_set_usr_installed_storage(const char *pkgid, INSTALL_LOCATION location, const char *external_pkg_path, uid_t uid);
6198
6199 /* version compare */
6200 int pkgmgrinfo_compare_package_version(const char *current_version,
6201                 const char *target_version, pkgmgrinfo_version_compare_type *res);
6202
6203 /**
6204  * @brief       TEMP
6205  */
6206
6207
6208 int pkgmgrinfo_pkginfo_get_usr_list_full(pkgmgrinfo_pkg_list_cb pkg_list_cb,
6209                 int flag, void *user_data, uid_t uid);
6210 int pkgmgrinfo_pkginfo_get_list_full(pkgmgrinfo_pkg_list_cb pkg_list_cb,
6211                 int flag, void *user_data);
6212 int pkgmgrinfo_appinfo_get_usr_installed_list_full(
6213                 pkgmgrinfo_app_list_cb app_func, uid_t uid, int flag,
6214                 void *user_data);
6215 int pkgmgrinfo_appinfo_get_installed_list_full(
6216                 pkgmgrinfo_app_list_cb app_func, int flag, void *user_data);
6217
6218
6219 int pkgmgrinfo_archiveinfo_get_archiveinfo(const char *path,
6220                 pkgmgrinfo_archiveinfo_h *handle);
6221 int pkgmgrinfo_archiveinfo_destroy_archiveinfo(pkgmgrinfo_archiveinfo_h handle);
6222 int pkgmgrinfo_archiveinfo_get_pkgid(pkgmgrinfo_archiveinfo_h handle,
6223                 const char **pkgid);
6224 int pkgmgrinfo_archiveinfo_get_type(pkgmgrinfo_archiveinfo_h handle,
6225                 const char **type);
6226 int pkgmgrinfo_archiveinfo_get_version(pkgmgrinfo_archiveinfo_h handle,
6227                 const char **version);
6228 int pkgmgrinfo_archiveinfo_get_api_version(pkgmgrinfo_archiveinfo_h handle,
6229                 const char **api_version);
6230 int pkgmgrinfo_archiveinfo_get_description(pkgmgrinfo_archiveinfo_h handle,
6231                 const char **description);
6232 int pkgmgrinfo_archiveinfo_get_label(pkgmgrinfo_archiveinfo_h handle,
6233                 const char **label);
6234 int pkgmgrinfo_archiveinfo_get_author(pkgmgrinfo_archiveinfo_h handle,
6235                 const char **author);
6236 int pkgmgrinfo_archiveinfo_get_icon(pkgmgrinfo_archiveinfo_h handle,
6237                 const unsigned char **icon, size_t *size);
6238
6239 /**
6240  * @pkgmgrinfo client API end
6241 **/
6242
6243
6244 /** @} */
6245 #ifdef __cplusplus
6246 }
6247 #endif
6248 #endif                          /* __PKG_INFO_H__ */
6249 /**
6250  * @}
6251  * @}
6252  */
6253