Fwupd.Remote
Description: Reference for Fwupd.Remote

### Class

# FwupdRemote

#### Description [src]

    class Fwupd.Remote : GObject.Object {
      parent_instance: GObject
    }

A source of metadata that provides firmware.

Remotes can be local (e.g. folders on a disk) or remote (e.g. downloaded over HTTP or IPFS).

See also: `FwupdClient`

#### Hierarchy

#### Ancestors

- GObject

#### Constructors

###### fwupd_remote_new

Creates a new fwupd remote.

since: 0.9.3

#### Functions

###### fwupd_remote_array_from_variant

Creates an array of new devices using serialized data.

since: 1.2.10

###### fwupd_remote_flag_from_string

Converts a string to an enumerated flag.

since: 1.9.4

###### fwupd_remote_flag_to_string

Returns the printable string for the flag.

since: 1.9.4

###### fwupd_remote_from_variant

Creates a new remote using serialized data.

since: 1.0.0

###### fwupd_remote_kind_from_string

Converts an printable string to an enumerated type.

since: 0.9.6

###### fwupd_remote_kind_to_string

Converts an enumerated type to a printable string.

since: 0.9.6

#### Instance methods

###### fwupd_remote_add_flag

Adds a specific attribute flag to the attribute.

since: 1.9.4

###### fwupd_remote_build_firmware_uri

Builds a URI for the URL using the username and password set for the remote, including any basename URI substitution.

since: 0.9.7

###### fwupd_remote_build_metadata_sig_uri

Builds a URI for the metadata using the username and password set for the remote.

since: 1.9.8

###### fwupd_remote_build_metadata_uri

Builds a URI for the metadata signature using the username and password set for the remote.

since: 1.9.8

###### fwupd_remote_build_report_uri

Builds a URI for the URL using the username and password set for the remote.

since: 1.9.1

###### fwupd_remote_get_age

Gets the age of the remote in seconds.

since: 0.9.5

###### fwupd_remote_get_agreement

Gets the remote agreement in AppStream markup format.

since: 1.0.7

###### fwupd_remote_get_approval_required

Gets if firmware from the remote should be checked against the list of a approved checksums.

since: 1.2.6

###### fwupd_remote_get_automatic_reports

Gets if reports should be automatically uploaded to this remote.

since: 1.3.3

###### fwupd_remote_get_automatic_security_reports

Gets if security reports should be automatically uploaded to this remote.

since: 1.5.0

###### fwupd_remote_get_checksum

Gets the remote signature checksum.

since: 1.0.0

###### fwupd_remote_get_checksum_metadata

Gets the remote metadata checksum.

since: 1.9.4

###### fwupd_remote_get_enabled

Gets if the remote is enabled and should be used.

since: 0.9.3

###### fwupd_remote_get_filename_cache

Gets the path and filename that the remote is using for a cache.

since: 0.9.6

###### fwupd_remote_get_filename_cache_sig

Gets the path and filename that the remote is using for a signature cache.

since: 0.9.7

###### fwupd_remote_get_filename_source

Gets the path and filename of the remote itself, typically a `.conf` file.

since: 0.9.8

###### fwupd_remote_get_firmware_base_uri

Gets the base URI for firmware.

since: 0.9.7

###### fwupd_remote_get_flags

Gets the self flags.

since: 1.9.4

###### fwupd_remote_get_id

Gets the remote ID, e.g. `lvfs-testing`.

since: 0.9.3

###### fwupd_remote_get_keyring_kind

Gets the keyring kind of the remote.

since: 0.9.7

###### fwupd_remote_get_kind

Gets the kind of the remote.

since: 0.9.6

###### fwupd_remote_get_metadata_uri

Gets the URI for the remote metadata.

since: 0.9.7

###### fwupd_remote_get_metadata_uri_sig

Gets the URI for the remote metadata signature.

since: 0.9.7

###### fwupd_remote_get_order_after

Gets the list of remotes this plugin should be ordered after.

since: 0.9.5

###### fwupd_remote_get_order_before

Gets the list of remotes this plugin should be ordered before.

since: 0.9.5

###### fwupd_remote_get_password

Gets the password configured for the remote.

since: 0.9.5

###### fwupd_remote_get_priority

Gets the priority of the remote, where bigger numbers are better.

since: 0.9.5

###### fwupd_remote_get_refresh_interval

Sets the plugin refresh interval in seconds.

since: 1.9.4

###### fwupd_remote_get_remotes_dir

Gets the base directory for storing remote metadata.

since: 1.3.1

###### fwupd_remote_get_report_uri

Gets the URI for the remote reporting.

since: 1.0.4

###### fwupd_remote_get_security_report_uri

Gets the URI for the security report.

since: 1.5.0

###### fwupd_remote_get_title

Gets the remote title, e.g. `Linux Vendor Firmware Service`.

since: 0.9.8

###### fwupd_remote_get_username

Gets the username configured for the remote.

since: 0.9.5

###### fwupd_remote_has_flag

Finds if the remote has a specific flag.

since: 1.9.4

###### fwupd_remote_load_from_filename

Loads metadata about the remote from a keyfile. This can be called zero or multiple times for each remote.

since: 0.9.3

###### fwupd_remote_load_signature

Parses the signature, updating the metadata URI as appropriate.

since: 1.4.0

###### fwupd_remote_load_signature_bytes

Parses the signature, updating the metadata URI as appropriate.

since: 1.4.5

###### fwupd_remote_needs_refresh

Gets if the metadata remote needs re-downloading.

since: 1.9.4

###### fwupd_remote_remove_flag

Removes a specific attribute flag from the remote.

since: 1.9.4

###### fwupd_remote_save_to_filename

Saves metadata about the remote to a keyfile.

since: 1.8.13

###### fwupd_remote_set_agreement

Sets the remote agreement in AppStream markup format.

since: 1.0.7

###### fwupd_remote_set_checksum

Sets the remote signature checksum, typically only useful in the self tests.

since: 1.8.2

###### fwupd_remote_set_enabled

Sets if the remote is enabled and should be used.

since: 1.8.13

###### fwupd_remote_set_filename_cache

Sets the remote filename cache filename, typically only useful in the self tests.

since: 1.8.2

###### fwupd_remote_set_filename_source

Sets the source filename. This is typically a file in `/etc/fwupd/remotes/`.

since: 1.6.1

###### fwupd_remote_set_flags

Sets the attribute flags.

since: 1.9.4

###### fwupd_remote_set_id

Sets the remote title.

since: 1.9.3

###### fwupd_remote_set_keyring_kind

Sets the keyring kind.

since: 1.5.3

###### fwupd_remote_set_metadata_uri

Sets the remote metadata URI.

since: 1.8.13

###### fwupd_remote_set_mtime

Sets the plugin modification time.

since: 0.9.5

###### fwupd_remote_set_priority

Sets the plugin priority.

since: 0.9.5

###### fwupd_remote_set_remotes_dir

Sets the directory to store remote data.

since: 1.3.1

###### fwupd_remote_set_title

Sets the remote title.

since: 1.8.13

###### fwupd_remote_setup

Sets up the remote ready for use, checking that required parameters have been set. Calling this method multiple times has no effect.

since: 1.6.1

###### fwupd_remote_to_json

Adds a fwupd remote to a JSON builder.

since: 1.6.2

###### fwupd_remote_to_variant

Serialize the remote data.

since: 1.0.0

##### Methods inherited from GObject (43)

Please see GObject for a full list of methods.

#### Properties

###### Fwupd.Remote:approval-required

If firmware from the remote should be checked against the system list of approved firmware.

since: 1.2.6

###### Fwupd.Remote:automatic-reports

The behavior for auto-uploading reports.

since: 1.3.3

###### Fwupd.Remote:automatic-security-reports

The behavior for auto-uploading security reports.

since: 1.5.0

###### Fwupd.Remote:enabled

If the remote is enabled and should be used.

since: 0.9.3

###### Fwupd.Remote:flags

The remote flags.

since: 1.9.4

###### Fwupd.Remote:id

The remote ID.

since: 0.9.3

#### Signals

##### Signals inherited from GObject (1)

###### GObject::notify

The notify signal is emitted on an object when one of its properties has its value set through g_object_set_property(), g_object_set(), et al.

#### Class structure

    struct FwupdRemoteClass {
      GObjectClass parent_class;
      void (* _fwupd_reserved1) (
    void
      );
      void (* _fwupd_reserved2) (
    void
      );
      void (* _fwupd_reserved3) (
    void
      );
      void (* _fwupd_reserved4) (
    void
      );
      void (* _fwupd_reserved5) (
    void
      );
      void (* _fwupd_reserved6) (
    void
      );
      void (* _fwupd_reserved7) (
    void
      );

    }

No description available.

###### Class members

`parent_class: GObjectClass`
  No description available.
`_fwupd_reserved1: void (* _fwupd_reserved1) ( void )`
  No description available.
`_fwupd_reserved2: void (* _fwupd_reserved2) ( void )`
  No description available.
`_fwupd_reserved3: void (* _fwupd_reserved3) ( void )`
  No description available.
`_fwupd_reserved4: void (* _fwupd_reserved4) ( void )`
  No description available.
`_fwupd_reserved5: void (* _fwupd_reserved5) ( void )`
  No description available.
`_fwupd_reserved6: void (* _fwupd_reserved6) ( void )`
  No description available.
`_fwupd_reserved7: void (* _fwupd_reserved7) ( void )`
  No description available.