org.bluez.AdminPolicySet - Man Page
BlueZ D-Bus AdminPolicySet API documentation
Description
This API provides methods to control the behavior of bluetoothd(8) as an administrator.
Interface AdminPolicySet1 provides methods to set policies. Once the policy is set successfully, it will affect all clients and stay persistently even after restarting bluetoothd(8). The only way to clear it is to overwrite the policy with the same method.
Interface
- Service
org.bluez
- Interface
org.bluez.AdminPolicySet1 [experimental]
- Object path
[variable prefix]/{hci0,hci1,...}
- Used by
Methods
void SetServiceAllowList(array{string} UUIDs)
Sets the service allowlist by specifying service UUIDs.
When called, bluetoothd(8) will block incoming and outgoing connections to the service not in UUIDs for all of the clients.
The allowlist also applies to local adapter/server services. When an allowlist exists, only adapter/server services whose policy UUID is in UUIDs are started or registered.
Updating the allowlist is applied immediately on initialized adapters:
- services that become disallowed are stopped/removed
- services that become allowed are started/registered
This does not require restarting bluetoothd(8) or power-cycling adapters.
Any subsequent calls to this method will supersede any previously set allowlist values. Calling this method with an empty array will allow any service UUIDs to be used.
The default value is an empty array.
Possible errors:
org.bluez.Error.InvalidArguments
org.bluez.Error.Failed
Examples:
- bluetoothctl
> admin.allow [clear/uuid1 uuid2 ...]