Copyright | Will Thompson and Iñaki García Etxebarria |
---|---|
License | LGPL-2.1 |
Maintainer | Iñaki García Etxebarria |
Safe Haskell | None |
Language | Haskell2010 |
GI.NM.Structs.WireGuardPeer
Contents
Description
The settings of one WireGuard peer.
Since: 1.16
Synopsis
- newtype WireGuardPeer = WireGuardPeer (ManagedPtr WireGuardPeer)
- wireGuardPeerAppendAllowedIp :: (HasCallStack, MonadIO m) => WireGuardPeer -> Text -> Bool -> m Bool
- wireGuardPeerClearAllowedIps :: (HasCallStack, MonadIO m) => WireGuardPeer -> m ()
- wireGuardPeerCmp :: (HasCallStack, MonadIO m) => Maybe WireGuardPeer -> Maybe WireGuardPeer -> SettingCompareFlags -> m Int32
- wireGuardPeerGetAllowedIp :: (HasCallStack, MonadIO m) => WireGuardPeer -> Word32 -> Bool -> m (Maybe Text)
- wireGuardPeerGetAllowedIpsLen :: (HasCallStack, MonadIO m) => WireGuardPeer -> m Word32
- wireGuardPeerGetEndpoint :: (HasCallStack, MonadIO m) => WireGuardPeer -> m Text
- wireGuardPeerGetPersistentKeepalive :: (HasCallStack, MonadIO m) => WireGuardPeer -> m Word16
- wireGuardPeerGetPresharedKey :: (HasCallStack, MonadIO m) => WireGuardPeer -> m Text
- wireGuardPeerGetPresharedKeyFlags :: (HasCallStack, MonadIO m) => WireGuardPeer -> m [SettingSecretFlags]
- wireGuardPeerGetPublicKey :: (HasCallStack, MonadIO m) => WireGuardPeer -> m Text
- wireGuardPeerIsSealed :: (HasCallStack, MonadIO m) => WireGuardPeer -> m Bool
- wireGuardPeerIsValid :: (HasCallStack, MonadIO m) => WireGuardPeer -> Bool -> Bool -> m ()
- wireGuardPeerNew :: (HasCallStack, MonadIO m) => m WireGuardPeer
- wireGuardPeerNewClone :: (HasCallStack, MonadIO m) => WireGuardPeer -> Bool -> m WireGuardPeer
- wireGuardPeerRef :: (HasCallStack, MonadIO m) => Maybe WireGuardPeer -> m WireGuardPeer
- wireGuardPeerRemoveAllowedIp :: (HasCallStack, MonadIO m) => WireGuardPeer -> Word32 -> m Bool
- wireGuardPeerSeal :: (HasCallStack, MonadIO m) => WireGuardPeer -> m ()
- wireGuardPeerSetEndpoint :: (HasCallStack, MonadIO m) => WireGuardPeer -> Text -> Bool -> m Bool
- wireGuardPeerSetPersistentKeepalive :: (HasCallStack, MonadIO m) => WireGuardPeer -> Word16 -> m ()
- wireGuardPeerSetPresharedKey :: (HasCallStack, MonadIO m) => WireGuardPeer -> Maybe Text -> Bool -> m Bool
- wireGuardPeerSetPresharedKeyFlags :: (HasCallStack, MonadIO m) => WireGuardPeer -> [SettingSecretFlags] -> m ()
- wireGuardPeerSetPublicKey :: (HasCallStack, MonadIO m) => WireGuardPeer -> Maybe Text -> Bool -> m Bool
- wireGuardPeerUnref :: (HasCallStack, MonadIO m) => Maybe WireGuardPeer -> m ()
Exported types
newtype WireGuardPeer Source #
Memory-managed wrapper type.
Constructors
WireGuardPeer (ManagedPtr WireGuardPeer) |
Instances
Eq WireGuardPeer Source # | |
Defined in GI.NM.Structs.WireGuardPeer Methods (==) :: WireGuardPeer -> WireGuardPeer -> Bool # (/=) :: WireGuardPeer -> WireGuardPeer -> Bool # | |
GBoxed WireGuardPeer Source # | |
Defined in GI.NM.Structs.WireGuardPeer | |
ManagedPtrNewtype WireGuardPeer Source # | |
Defined in GI.NM.Structs.WireGuardPeer Methods | |
TypedObject WireGuardPeer Source # | |
Defined in GI.NM.Structs.WireGuardPeer | |
HasParentTypes WireGuardPeer Source # | |
Defined in GI.NM.Structs.WireGuardPeer | |
IsGValue (Maybe WireGuardPeer) Source # | Convert |
Defined in GI.NM.Structs.WireGuardPeer Methods gvalueGType_ :: IO GType # gvalueSet_ :: Ptr GValue -> Maybe WireGuardPeer -> IO () # gvalueGet_ :: Ptr GValue -> IO (Maybe WireGuardPeer) # | |
type ParentTypes WireGuardPeer Source # | |
Defined in GI.NM.Structs.WireGuardPeer |
Methods
Click to display all available methods, including inherited ones
Methods
appendAllowedIp, clearAllowedIps, cmp, isSealed, isValid, newClone, ref, removeAllowedIp, seal, unref.
Getters
getAllowedIp, getAllowedIpsLen, getEndpoint, getPersistentKeepalive, getPresharedKey, getPresharedKeyFlags, getPublicKey.
Setters
setEndpoint, setPersistentKeepalive, setPresharedKey, setPresharedKeyFlags, setPublicKey.
appendAllowedIp
wireGuardPeerAppendAllowedIp Source #
Arguments
:: (HasCallStack, MonadIO m) | |
=> WireGuardPeer |
|
-> Text |
|
-> Bool |
|
-> m Bool | Returns: |
Appends allowedIp
setting to the list. This does not check
for duplicates and always appends allowedIp
to the end of the
list. If allowedIp
is valid, it will be normalized and a modified
for might be appended. If allowedIp
is invalid, it will still be
appended, but later verification will fail.
It is a bug trying to modify a sealed WireGuardPeer
instance.
Since: 1.16
clearAllowedIps
wireGuardPeerClearAllowedIps Source #
Arguments
:: (HasCallStack, MonadIO m) | |
=> WireGuardPeer |
|
-> m () |
Removes all allowed-ip entries.
It is a bug trying to modify a sealed WireGuardPeer
instance.
Since: 1.16
cmp
Arguments
:: (HasCallStack, MonadIO m) | |
=> Maybe WireGuardPeer |
|
-> Maybe WireGuardPeer |
|
-> SettingCompareFlags |
|
-> m Int32 | Returns: zero of the two instances are equivalent or a non-zero integer otherwise. This defines a total ordering over the peers. Whether a peer is sealed or not, does not affect the comparison. |
No description available in the introspection data.
Since: 1.16
getAllowedIp
wireGuardPeerGetAllowedIp Source #
Arguments
:: (HasCallStack, MonadIO m) | |
=> WireGuardPeer |
|
-> Word32 |
|
-> Bool |
|
-> m (Maybe Text) | Returns: the allowed-ip setting at index |
No description available in the introspection data.
Since: 1.16
getAllowedIpsLen
wireGuardPeerGetAllowedIpsLen Source #
Arguments
:: (HasCallStack, MonadIO m) | |
=> WireGuardPeer |
|
-> m Word32 | Returns: the number of allowed-ips entries. |
No description available in the introspection data.
Since: 1.16
getEndpoint
wireGuardPeerGetEndpoint Source #
Arguments
:: (HasCallStack, MonadIO m) | |
=> WireGuardPeer |
|
-> m Text | Returns: the endpoint or |
No description available in the introspection data.
Since: 1.16
getPersistentKeepalive
wireGuardPeerGetPersistentKeepalive Source #
Arguments
:: (HasCallStack, MonadIO m) | |
=> WireGuardPeer |
|
-> m Word16 | Returns: get the persistent-keepalive setting in seconds. Set to zero to disable keep-alive. |
No description available in the introspection data.
Since: 1.16
getPresharedKey
wireGuardPeerGetPresharedKey Source #
Arguments
:: (HasCallStack, MonadIO m) | |
=> WireGuardPeer |
|
-> m Text | Returns: the preshared key or |
No description available in the introspection data.
Since: 1.16
getPresharedKeyFlags
wireGuardPeerGetPresharedKeyFlags Source #
Arguments
:: (HasCallStack, MonadIO m) | |
=> WireGuardPeer |
|
-> m [SettingSecretFlags] | Returns: get the secret flags for the preshared-key. |
No description available in the introspection data.
Since: 1.16
getPublicKey
wireGuardPeerGetPublicKey Source #
Arguments
:: (HasCallStack, MonadIO m) | |
=> WireGuardPeer |
|
-> m Text | Returns: the public key or |
No description available in the introspection data.
Since: 1.16
isSealed
wireGuardPeerIsSealed Source #
Arguments
:: (HasCallStack, MonadIO m) | |
=> WireGuardPeer |
|
-> m Bool | Returns: whether |
No description available in the introspection data.
Since: 1.16
isValid
Arguments
:: (HasCallStack, MonadIO m) | |
=> WireGuardPeer |
|
-> Bool |
|
-> Bool |
|
-> m () | (Can throw |
No description available in the introspection data.
Since: 1.16
new
Arguments
:: (HasCallStack, MonadIO m) | |
=> m WireGuardPeer | Returns: a new, default, unsealed |
No description available in the introspection data.
Since: 1.16
newClone
wireGuardPeerNewClone Source #
Arguments
:: (HasCallStack, MonadIO m) | |
=> WireGuardPeer |
|
-> Bool |
|
-> m WireGuardPeer | Returns: a clone of |
No description available in the introspection data.
Since: 1.16
ref
Arguments
:: (HasCallStack, MonadIO m) | |
=> Maybe WireGuardPeer |
|
-> m WireGuardPeer | Returns: returns the input argument Since 1.42, ref-counting of |
No description available in the introspection data.
Since: 1.16
removeAllowedIp
wireGuardPeerRemoveAllowedIp Source #
Arguments
:: (HasCallStack, MonadIO m) | |
=> WireGuardPeer |
|
-> Word32 |
|
-> m Bool | Returns: |
Removes the allowed-ip at the given idx
. This shifts all
following entries one index down.
It is a bug trying to modify a sealed WireGuardPeer
instance.
Since: 1.16
seal
Arguments
:: (HasCallStack, MonadIO m) | |
=> WireGuardPeer |
|
-> m () |
Seal the WireGuardPeer
instance. Afterwards, it is a bug
to call all functions that modify the instance (except ref/unref).
A sealed instance cannot be unsealed again, but you can create
an unsealed copy with wireGuardPeerNewClone
.
Since: 1.16
setEndpoint
wireGuardPeerSetEndpoint Source #
Arguments
:: (HasCallStack, MonadIO m) | |
=> WireGuardPeer |
|
-> Text |
|
-> Bool |
|
-> m Bool | Returns: |
Sets or clears the endpoint of self
.
It is a bug trying to modify a sealed WireGuardPeer
instance.
Since: 1.16
setPersistentKeepalive
wireGuardPeerSetPersistentKeepalive Source #
Arguments
:: (HasCallStack, MonadIO m) | |
=> WireGuardPeer |
|
-> Word16 |
|
-> m () |
It is a bug trying to modify a sealed WireGuardPeer
instance.
Since: 1.16
setPresharedKey
wireGuardPeerSetPresharedKey Source #
Arguments
:: (HasCallStack, MonadIO m) | |
=> WireGuardPeer |
|
-> Maybe Text |
|
-> Bool |
|
-> m Bool | Returns: |
Reset the preshared key. Note that if the preshared key is valid, it will be normalized (which may or may not modify the set value).
Note that the preshared-key is a secret and consequently has corresponding
preshared-key-flags property. This is so that secrets can be optional
and requested on demand from a secret-agent. Also, an invalid preshared-key
may optionally cause wireGuardPeerIsValid
to fail or it may
be accepted.
It is a bug trying to modify a sealed WireGuardPeer
instance.
Since: 1.16
setPresharedKeyFlags
wireGuardPeerSetPresharedKeyFlags Source #
Arguments
:: (HasCallStack, MonadIO m) | |
=> WireGuardPeer |
|
-> [SettingSecretFlags] |
|
-> m () |
It is a bug trying to modify a sealed WireGuardPeer
instance.
Since: 1.16
setPublicKey
wireGuardPeerSetPublicKey Source #
Arguments
:: (HasCallStack, MonadIO m) | |
=> WireGuardPeer |
|
-> Maybe Text |
|
-> Bool |
|
-> m Bool | Returns: |
Reset the public key. Note that if the public key is valid, it will be normalized (which may or may not modify the set value).
It is a bug trying to modify a sealed WireGuardPeer
instance.
Since: 1.16
unref
Arguments
:: (HasCallStack, MonadIO m) | |
=> Maybe WireGuardPeer |
|
-> m () |
Drop a reference to self
. If the last reference is dropped,
the instance is freed and all associate data released.
Since 1.42, ref-counting of WireGuardPeer
is thread-safe.
Since: 1.16