NMDeviceTun

NMDeviceTun

Functions

Properties

gint64 group Read
char * mode Read
gboolean multi-queue Read
gboolean no-pi Read
gint64 owner Read
gboolean vnet-hdr Read

Types and Values

Object Hierarchy

    GObject
    ╰── NMObject
        ╰── NMDevice
            ╰── NMDeviceTun

Description

Functions

nm_device_tun_get_hw_address ()

const char *
nm_device_tun_get_hw_address (NMDeviceTun *device);

nm_device_tun_get_hw_address has been deprecated since version 1.24 and should not be used in newly-written code.

Use nm_device_get_hw_address() instead.

Gets the hardware (MAC) address of the NMDeviceTun

[skip]

Parameters

device

a NMDeviceTun

 

Returns

the hardware address. This is the internal string used by the device, and must not be modified.

Since: 1.2


nm_device_tun_get_mode ()

const char *
nm_device_tun_get_mode (NMDeviceTun *device);

Returns the TUN/TAP mode for the device.

Parameters

device

a NMDeviceTun

 

Returns

'tun' or 'tap'

Since: 1.2


nm_device_tun_get_owner ()

gint64
nm_device_tun_get_owner (NMDeviceTun *device);

Gets the tunnel owner.

Parameters

device

a NMDeviceTun

 

Returns

the uid of the tunnel owner, or -1 if it has no owner.

Since: 1.2


nm_device_tun_get_group ()

gint64
nm_device_tun_get_group (NMDeviceTun *device);

Gets the tunnel group.

Parameters

device

a NMDeviceTun

 

Returns

the gid of the tunnel group, or -1 if it has no owner.

Since: 1.2


nm_device_tun_get_no_pi ()

gboolean
nm_device_tun_get_no_pi (NMDeviceTun *device);

Returns whether the NMDeviceTun has the IFF_NO_PI flag.

Parameters

device

a NMDeviceTun

 

Returns

TRUE if the device has the flag, FALSE otherwise

Since: 1.2


nm_device_tun_get_vnet_hdr ()

gboolean
nm_device_tun_get_vnet_hdr (NMDeviceTun *device);

Returns whether the NMDeviceTun has the IFF_VNET_HDR flag.

Parameters

device

a NMDeviceTun

 

Returns

TRUE if the device has the flag, FALSE otherwise

Since: 1.2


nm_device_tun_get_multi_queue ()

gboolean
nm_device_tun_get_multi_queue (NMDeviceTun *device);

Returns whether the NMDeviceTun has the IFF_MULTI_QUEUE flag.

Parameters

device

a NMDeviceTun

 

Returns

TRUE if the device doesn't have the flag, FALSE otherwise

Since: 1.2

Types and Values

NM_DEVICE_TUN_HW_ADDRESS

#define NM_DEVICE_TUN_HW_ADDRESS  "hw-address"

NM_DEVICE_TUN_OWNER

#define NM_DEVICE_TUN_OWNER       "owner"

NM_DEVICE_TUN_GROUP

#define NM_DEVICE_TUN_GROUP       "group"

NM_DEVICE_TUN_MODE

#define NM_DEVICE_TUN_MODE        "mode"

NM_DEVICE_TUN_NO_PI

#define NM_DEVICE_TUN_NO_PI       "no-pi"

NM_DEVICE_TUN_VNET_HDR

#define NM_DEVICE_TUN_VNET_HDR    "vnet-hdr"

NM_DEVICE_TUN_MULTI_QUEUE

#define NM_DEVICE_TUN_MULTI_QUEUE "multi-queue"

NMDeviceTun

typedef struct _NMDeviceTun NMDeviceTun;

Since: 1.2

Property Details

The “group” property

  “group”                    gint64

The gid of the tunnel group, or -1 if it has no owner.

Owner: NMDeviceTun

Flags: Read

Allowed values: [-1,4294967295]

Default value: -1

Since: 1.2


The “mode” property

  “mode”                     char *

The tunnel mode, either "tun" or "tap".

Owner: NMDeviceTun

Flags: Read

Default value: NULL

Since: 1.2


The “multi-queue” property

  “multi-queue”              gboolean

The tunnel's "TUN_TAP_MQ" flag; true if callers can connect to the tap device multiple times, for multiple send/receive queues.

Owner: NMDeviceTun

Flags: Read

Default value: FALSE

Since: 1.2


The “no-pi” property

  “no-pi”                    gboolean

The tunnel's "TUN_NO_PI" flag; true if no protocol info is prepended to the tunnel packets.

Owner: NMDeviceTun

Flags: Read

Default value: FALSE

Since: 1.2


The “owner” property

  “owner”                    gint64

The uid of the tunnel owner, or -1 if it has no owner.

Owner: NMDeviceTun

Flags: Read

Allowed values: [-1,4294967295]

Default value: -1

Since: 1.2


The “vnet-hdr” property

  “vnet-hdr”                 gboolean

The tunnel's "TUN_VNET_HDR" flag; true if the tunnel packets include a virtio network header.

Owner: NMDeviceTun

Flags: Read

Default value: FALSE

Since: 1.2