mirror of
https://github.com/ceph/ceph-csi.git
synced 2025-03-08 16:39:29 +00:00
f87d06ed85
Several packages are only used while running the e2e suite. These packages are less important to update, as the they can not influence the final executable that is part of the Ceph-CSI container-image. By moving these dependencies out of the main Ceph-CSI go.mod, it is easier to identify if a reported CVE affects Ceph-CSI, or only the testing (like most of the Kubernetes CVEs). Signed-off-by: Niels de Vos <ndevos@ibm.com>
72 lines
2.6 KiB
Go
72 lines
2.6 KiB
Go
/*
|
|
Package dbus implements bindings to the D-Bus message bus system.
|
|
|
|
To use the message bus API, you first need to connect to a bus (usually the
|
|
session or system bus). The acquired connection then can be used to call methods
|
|
on remote objects and emit or receive signals. Using the Export method, you can
|
|
arrange D-Bus methods calls to be directly translated to method calls on a Go
|
|
value.
|
|
|
|
Conversion Rules
|
|
|
|
For outgoing messages, Go types are automatically converted to the
|
|
corresponding D-Bus types. See the official specification at
|
|
https://dbus.freedesktop.org/doc/dbus-specification.html#type-system for more
|
|
information on the D-Bus type system. The following types are directly encoded
|
|
as their respective D-Bus equivalents:
|
|
|
|
Go type | D-Bus type
|
|
------------+-----------
|
|
byte | BYTE
|
|
bool | BOOLEAN
|
|
int16 | INT16
|
|
uint16 | UINT16
|
|
int | INT32
|
|
uint | UINT32
|
|
int32 | INT32
|
|
uint32 | UINT32
|
|
int64 | INT64
|
|
uint64 | UINT64
|
|
float64 | DOUBLE
|
|
string | STRING
|
|
ObjectPath | OBJECT_PATH
|
|
Signature | SIGNATURE
|
|
Variant | VARIANT
|
|
interface{} | VARIANT
|
|
UnixFDIndex | UNIX_FD
|
|
|
|
Slices and arrays encode as ARRAYs of their element type.
|
|
|
|
Maps encode as DICTs, provided that their key type can be used as a key for
|
|
a DICT.
|
|
|
|
Structs other than Variant and Signature encode as a STRUCT containing their
|
|
exported fields in order. Fields whose tags contain `dbus:"-"` and unexported
|
|
fields will be skipped.
|
|
|
|
Pointers encode as the value they're pointed to.
|
|
|
|
Types convertible to one of the base types above will be mapped as the
|
|
base type.
|
|
|
|
Trying to encode any other type or a slice, map or struct containing an
|
|
unsupported type will result in an InvalidTypeError.
|
|
|
|
For incoming messages, the inverse of these rules are used, with the exception
|
|
of STRUCTs. Incoming STRUCTS are represented as a slice of empty interfaces
|
|
containing the struct fields in the correct order. The Store function can be
|
|
used to convert such values to Go structs.
|
|
|
|
Unix FD passing
|
|
|
|
Handling Unix file descriptors deserves special mention. To use them, you should
|
|
first check that they are supported on a connection by calling SupportsUnixFDs.
|
|
If it returns true, all method of Connection will translate messages containing
|
|
UnixFD's to messages that are accompanied by the given file descriptors with the
|
|
UnixFD values being substituted by the correct indices. Similarly, the indices
|
|
of incoming messages are automatically resolved. It shouldn't be necessary to use
|
|
UnixFDIndex.
|
|
|
|
*/
|
|
package dbus
|