### Class

# Fwupd Remote

#### Description [src]

    class Fwupd.Remote : GObject.Object
      implements Fwupd.Codec {
      /* No available fields */
    }

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

#### Implements

- FwupdCodec

#### Constructors

###### fwupd_remote_new

Creates a new fwupd remote.

since: 0.9.3

#### Functions

###### fwupd_remote_flag_from_string

Converts a string to an enumerated value.

since: 1.9.4

###### fwupd_remote_flag_to_string

Converts an enumerated value to a string.

since: 1.9.4

###### fwupd_remote_kind_from_string

Converts a string to an enumerated value.

since: 0.9.6

###### fwupd_remote_kind_to_string

Converts an enumerated value to a 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_ensure_checksum_sig

Calculates the signature checksum of the remote using the filename cache.

since: 2.0.17

###### fwupd_remote_ensure_mtime

Calculates the mtime of the remote using the filename cache.

since: 2.0.17

###### 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_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_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: 2.0.2

###### 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_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_mtime

Gets the remote mtime in seconds.

since: 2.0.17

###### fwupd_remote_get_order_after

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

since: 0.9.5

###### fwupd_remote_get_order_before

Gets the list of remotes this remote 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_privacy_uri

Gets the remote privacy policy URL, e.g. `https://lvfs.readthedocs.io/en/latest/privacy.html`.

since: 2.0.0

###### fwupd_remote_get_refresh_interval

Gets the remote 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_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_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_load_user_secrets

Loads the secrets from a per-user store.

since: 2.1.4

###### 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_user_secrets

Saves the secrets to a per-user store.

since: 2.1.4

###### fwupd_remote_set_agreement

Sets the remote agreement in AppStream markup format.

since: 1.0.7

###### fwupd_remote_set_checksum_sig

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

since: 2.0.0

###### 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_firmware_base_uri

Sets the firmware base URI.

since: 2.0.2

###### fwupd_remote_set_flags

Sets the attribute flags.

since: 1.9.4

###### fwupd_remote_set_id

Sets the remote ID.

since: 1.9.3

###### fwupd_remote_set_kind

Sets the kind of the remote.

since: 2.0.0

###### fwupd_remote_set_metadata_uri

Sets the remote metadata URI.

since: 1.8.13

###### fwupd_remote_set_mtime

Sets the remote modification time.

since: 0.9.5

###### fwupd_remote_set_order_after

Sets any remotes that should be ordered after this one.

since: 2.0.0

###### fwupd_remote_set_order_before

Sets any remotes that should be ordered before this one.

since: 2.0.0

###### fwupd_remote_set_password

Sets the remote password.

since: 2.0.0

###### fwupd_remote_set_priority

Sets the remote priority.

since: 0.9.5

###### fwupd_remote_set_privacy_uri

Sets the remote privacy policy URL.

since: 2.0.0

###### fwupd_remote_set_refresh_interval

Sets the remote refresh interval in seconds.

since: 2.0.0

###### fwupd_remote_set_remotes_dir

Sets the directory to store remote data.

since: 1.3.1

###### fwupd_remote_set_report_uri

Sets the report URI.

since: 2.0.0

###### fwupd_remote_set_title

Sets the remote title.

since: 1.8.13

###### fwupd_remote_set_username

Sets the remote username.

since: 2.0.0

###### 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

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

Please see GObject for a full list of methods.

##### Methods inherited from FwupdCodec (8)

###### fwupd_codec_add_string

Converts an object that implements `FwupdCodec` to a debug string, appending it to `str`.

since: 2.0.0

###### fwupd_codec_from_json

Converts an object that implements `FwupdCodec` from a JSON object.

since: 2.0.0

###### fwupd_codec_from_json_string

Converts an object that implements `FwupdCodec` from a JSON string.

since: 2.0.0

###### fwupd_codec_from_variant

Converts an object that implements `FwupdCodec` from a `GVariant` value.

since: 2.0.0

###### fwupd_codec_to_json

Converts an object that implements `FwupdCodec` to a JSON builder object.

since: 2.0.0

###### fwupd_codec_to_json_string

Converts an object that implements `FwupdCodec` to a JSON string.

since: 2.0.0

###### fwupd_codec_to_string

Converts an object that implements `FwupdCodec` to a debug string.

since: 2.0.0

###### fwupd_codec_to_variant

Converts an object that implements `FwupdCodec` to a `GVariant`.

since: 2.0.0

#### 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.