Enable build with iniparser v 3.1

[platform/framework/native/appfw.git] / inc / FAppPkgPackageInfo.h

diff --git a/inc/FAppPkgPackageInfo.h b/inc/FAppPkgPackageInfo.h
index 940d80f..42a11c8 100755 (executable)
--- a/inc/FAppPkgPackageInfo.h
+++ b/inc/FAppPkgPackageInfo.h
@@ -1,5 +1,4 @@
 //
-// Open Service Platform
 // Copyright (c) 2012 Samsung Electronics Co., Ltd.
 //
 // Licensed under the Apache License, Version 2.0 (the License);
@@ -55,11 +54,11 @@ public:
        virtual ~PackageInfo(void);
 
        /**
-        * Gets a package ID.
+        * Gets the package ID.
         *
         * @since       2.0
         *
-        * @return A package ID
+        * @return      The package ID
         */
        PackageId GetId(void) const;
 
@@ -68,7 +67,7 @@ public:
         *
         * @since       2.0
         *
-        * @return      The version of a package
+        * @return      The version of the package
         */
        Tizen::Base::String GetVersion(void) const;
 
@@ -77,7 +76,7 @@ public:
         *
         * @since       2.0
         *
-        * @return      The display name of a package
+        * @return      The display name of the package
         */
        Tizen::Base::String GetDisplayName(void) const;
 
@@ -86,7 +85,7 @@ public:
         *
         * @since       2.0
         *
-        * @return      The description of a package, @n
+        * @return      The description of the package, @n
         *          else an empty string is returned if there is no value
         */
        Tizen::Base::String GetDescription(void) const;
@@ -96,7 +95,7 @@ public:
         *
         * @since       2.0
         *
-        * @return      The author of a package, @n
+        * @return      The author of the package, @n
         *          else an empty string is returned if there is no value
         */
        Tizen::Base::String GetAuthor(void) const;
@@ -106,56 +105,56 @@ public:
         *
         * @since       2.0
         *
-        * @return      The URL of a package, @n
+        * @return      The URL of the package, @n
         *          else an empty string is returned if there is no value
         */
        Tizen::Base::String GetUrl(void) const;
 
        /**
-        * Gets the date and time when a package is installed.
+        * Gets the date and the time when a package is installed.
         *
         * @since       2.0
         *
-        * @return      An instance of Tizen::Base::DateTime when a package is installed
+        * @return      An instance of Tizen::Base::DateTime which contains the package installation details
         */
        Tizen::Base::DateTime GetInstallationTime(void) const;
 
        /**
-        * Checks whether a package is installed in the external storage.
+        * Checks if a package is installed in the external storage.
         *
         * @since       2.0
         *
-        * @return      @c true if a package is installed in the external storage, @n
+        * @return      @c true if the package is installed in the external storage, @n
         *                      else @c false
         */
        bool IsInstalledInExternalStorage(void) const;
 
        /**
-        * Checks whether it is possible to uninstall a package.
+        * Checks if it is possible to uninstall a package.
         *
         * @since       2.0
         *
-        * @return      @c true if it is possible to uninstall a package, @n
+        * @return      @c true if it is possible to uninstall the package, @n
         *                      else @c false
         */
        bool IsUninstallable(void) const;
 
        /**
-        * Checks whether it is possible to move a package to either internal or external storage.
+        * Checks if it is possible to move a package to either the internal or the external storage.
         *
         * @since       2.0
         *
-        * @return      @c true if it is possible to move a package to either internal or external storage, @n
+        * @return      @c true if it is possible to move the package to either the internal or the external storage, @n
         *                      else @c false
         */
        bool IsMovable(void) const;
 
        /**
-        * Checks whether a package is downloaded.
+        * Checks if a package is downloaded.
         *
         * @since       2.0
         *
-        * @return      @c true if a package is downloaded, @n
+        * @return      @c true if the package is downloaded, @n
         *                      else @c false
         */
        bool IsDownloaded(void) const;
@@ -165,7 +164,7 @@ public:
         *
         * @since       2.0
         *
-        * @return      The size of a package
+        * @return      The size of the package
         */
        long long GetSize(void) const;
 
@@ -174,7 +173,7 @@ public:
         *
         * @since       2.0
         *
-        * @return      The data size of a package
+        * @return      The data size of the package
         */
        long long GetDataSize(void) const;
 
@@ -213,29 +212,41 @@ public:
         *
         * @since       2.0
         *
-        * @return              A pointer to PackageAppInfo
+        * @return              A pointer to the PackageAppInfo instance
         * @param[in]   appId                           The application ID
         * @exception   E_SUCCESS                       The method is successful.
         * @exception   E_INVALID_ARG           The specified input parameter is invalid.
-        * @exception   E_OBJ_NOT_FOUND         The application information is not found.
+        * @exception   E_OBJ_NOT_FOUND         The application information has not been found.
         * @exception   E_SYSTEM                        The method cannot proceed due to a severe system error.
         * @remarks             The specific error code can be accessed using the GetLastResult() method.
         */
-       Tizen::App::Package::PackageAppInfo* GetPackageAppInfoN(const AppId& appId) const;
+       PackageAppInfo* GetPackageAppInfoN(const AppId& appId) const;
 
        /**
-        * @if VISPARTNER-MANUFACTURER
         * Gets the type of a package.
         *
-        * @since       2.0
-        * @visibility  partner-manufacturer
-        * @privilege   %http://tizen.org/privilege/packagesetting
+        * @since               2.0
+        * @privlevel   platform
+        * @privilege   %http://tizen.org/privilege/packagemanager.setting @n
+        *              (%http://tizen.org/privilege/packagesetting is deprecated.)
         *
-        * @return The package type
-        * @endif
+        * @return              The package type
         */
        PackageType GetType(void) const;
 
+       /**
+       * Gets the privilege information list of a package.
+       *
+       * @since         2.1
+       *
+       * @return        A pointer to the list of the Tizen::Security::PrivilegeInfo instances, @n
+       *                else @c null if it fails
+       * @exception     E_SUCCESS            The method is successful.
+       * @exception     E_SYSTEM             The method cannot proceed due to a severe system error.
+       * @remarks      The specific error code can be accessed using the GetLastResult() method.
+       */
+       Tizen::Base::Collection::IList* GetPrivilegeListN(void) const;
+
 private:
        /**
         * This is the default constructor for this class. This default constructor is intentionally
@@ -258,6 +269,7 @@ private:
 
        friend class _PackageInfoImpl;
        friend class _PackageManagerImpl;
+       friend class _PackageManagerServer;
 
 }; // PackageInfo