## PkDistroUpgrade PkDistroUpgrade — DistroUpgrade object |

## Synopsis

    struct              PkDistroUpgrade;
    struct              PkDistroUpgradeClass;
    const gchar *       pk_distro_upgrade_get_id            (PkDistroUpgrade *distro_upgrade);
    PkDistroUpgradeEnum pk_distro_upgrade_get_state         (PkDistroUpgrade *distro_upgrade);
    const gchar *       pk_distro_upgrade_get_summary       (PkDistroUpgrade *distro_upgrade);
    PkDistroUpgrade *   pk_distro_upgrade_new               (void);

## Object Hierarchy

      GObject
       +----PkSource
             +----PkDistroUpgrade

## Properties

      "name"                     gchar*                : Read / Write
      "state"                    guint                 : Read / Write
      "summary"                  gchar*                : Read / Write

## Description

This GObject represents a distro_upgrade from a transaction. These objects represent single items of data from the transaction, and are often present in lists (PkResults) or just refcounted in client programs.

## Details

### struct PkDistroUpgrade

    struct PkDistroUpgrade;

### struct PkDistroUpgradeClass

    struct PkDistroUpgradeClass {
    	PkSourceClass parent_class;
    	/* padding for future expansion */
    	void (*_pk_reserved1) (void);
    	void (*_pk_reserved2) (void);
    	void (*_pk_reserved3) (void);
    	void (*_pk_reserved4) (void);
    	void (*_pk_reserved5) (void);
    };

### pk_distro_upgrade_get_id ()

    const gchar *       pk_distro_upgrade_get_id            (PkDistroUpgrade *distro_upgrade);

Gets the distribution identifier. You use this value to call UpgradeSystem.

`distro_upgrade` : | a valid PkDistroUpgrade object.
Returns : | the distro-id, e.g. "fedora-14"

Since 0.6.11

### pk_distro_upgrade_get_state ()

    PkDistroUpgradeEnum pk_distro_upgrade_get_state         (PkDistroUpgrade *distro_upgrade);

Gets the status of the distribution upgrade.

`distro_upgrade` : | a valid PkDistroUpgrade object.
Returns : | the printable name, e.g. `PK_DISTRO_UPGRADE_ENUM_UNSTABLE`

Since 0.6.11

### pk_distro_upgrade_get_summary ()

    const gchar *       pk_distro_upgrade_get_summary       (PkDistroUpgrade *distro_upgrade);

Gets the description of the distribution upgrade.

`distro_upgrade` : | a valid PkDistroUpgrade object.
Returns : | the printable name, e.g. "Fedora 14"

Since 0.6.11

### pk_distro_upgrade_new ()

    PkDistroUpgrade *   pk_distro_upgrade_new               (void);

Returns : | a new PkDistroUpgrade object.

Since 0.5.4

## Property Details

### The `"name"` property

      "name"                     gchar*                : Read / Write

Default value: NULL

Since 0.5.4

### The `"state"` property

      "state"                    guint                 : Read / Write

Default value: 0

Since 0.5.4

### The `"summary"` property

      "summary"                  gchar*                : Read / Write

Default value: NULL

Since 0.5.4