# DNS-SD Control

> Symcon documentation · English · generated on 2026-09-26  
> Index: https://www.symcon.de/en/llms.txt

Source: https://www.symcon.de/en/service/documentation/module-reference/core-instances/dns-sd-control/

_Requires Symcon >= 5.0_

The DNS-SD control module manages established Bonjour services.

> **Note:** For further information one can search for Zeroconf or mDNS.

### Installation

The DNS-SD Control is automatically installed as a core instance. This can be found in the object tree under core instances.

### Configuration

New services (list element) can be added via the configuration page of the DNS-SD Control.

![configuration page](https://www.symcon.de/media/pages/service/dokumentation/modulreferenz/kern-instanzen/dnssd-control/29d165e060-1790424938/dnssd-konfiguration.png)

These need a Name, RegType and Port. Domain and Host are optional, as are values. These are saved as key -> value pairs.

> **Warning:** The same Name and RegType may not be reused for different list elements.

![List element](https://www.symcon.de/media/pages/service/dokumentation/modulreferenz/kern-instanzen/dnssd-control/5eb41a0064-1790424938/dnssd-listenelement.png)

After successfully adding, the new RegType and Name can be found and used directly via a Bonjour browser.

![Bonjour Browser](https://www.symcon.de/media/pages/service/dokumentation/modulreferenz/kern-instanzen/dnssd-control/3df25163a2-1790424938/dnssd-browser.png)

## ZC_QueryService

Source: https://www.symcon.de/en/service/documentation/module-reference/core-instances/dns-sd-control/zc-queryservice/

`array ZC_QueryService(int $InstanceID, string $Name, string $RegType, string $Domain)`

_Requires Symcon >= 5.3_

requests information from a single service

**Parameters**

- `$InstanceID` (int): ID of the DNS-SD control to be requested
- `$Name` (string): Name of the service
- `$RegType` (string): The RegType of the service
- `$Domain` (string): Domain of the service

**Returns** (array): Returns all information about the service found as an array.

Domain of the service

**Example**

```php
ZC_QueryService(12345, "NAS", "_http._tcp", "local.");

// Sample output:
/*
Array
(
    [0] => Array
        (
            [Name] => NAS._http._tcp.local.
            [Host] => NAS.local.
            [Port] => 5000
            [TXTRecords] => Array
                (
                    [0] => vendor=Synology
                    [1] => model=RS818+
                    [2] => serial=xxxxx
                    [3] => version_major=6
                    [4] => version_minor=2
                    [5] => version_build=24922
                    [6] => admin_port=5000
                    [7] => secure_admin_port=5001
                    [8] => mac_address=xxxxxx
                )

            [IPv4] => Array
                (
                    [0] => 192.168.1.105
                )

            [IPv6] => Array
                (
                    [0] => fe60::cc4b:5ccf:fac7:5d82
                )
        )
)
*/
```

## ZC_QueryServiceType

Source: https://www.symcon.de/en/service/documentation/module-reference/core-instances/dns-sd-control/zc-queryservicetype/

`array ZC_QueryServiceType(int $InstanceID, string $RegType, string $Domain (optional))`

_Requires Symcon >= 5.3_

requests information from services of a certain type

**Parameters**

- `$InstanceID` (int): ID of the DNS-SD control to be requested
- `$RegType` (string): The RegType of the service
- `$Domain (optional)` (string): Domain of the service

**Returns** (array): Returns all found services as an array.

Domain of the service

**Example**

```php
ZC_QueryServiceType(12345, "_http._tcp", "");

// Sample output
/*
Array
(
    [0] => Array
        (
            [Name] => NAS
            [Type] => _http._tcp.
            [Domain] => local.
        )
)
*/
```

## ZC_QueryServiceTypes

Source: https://www.symcon.de/en/service/documentation/module-reference/core-instances/dns-sd-control/zc-queryservicetypes/

`array ZC_QueryServiceTypes(int $InstanceID)`

_Requires Symcon >= 5.3_

Queries all the services that have been set up

**Parameters**

- `$InstanceID` (int): ID of the DNS-SD control to be requested

**Returns** (array): Returns all services and information as an array.

ID of the DNS-SD control to be requested

**Example**

```php
// Request the registered services of the DNS-SD Control with the ID 12345
ZC_QueryServiceTypes(12345);

// Sample output
/*
Array
(
    [0] => Array
        (
            [Name] => _afpovertcp
            [Type] => _tcp.local.
            [Domain] => .
        )

    [1] => Array
        (
            [Name] => _airplay
            [Type] => _tcp.local.
            [Domain] => .
        )

    [2] => Array
        (
            [Name] => _airtame
            [Type] => _tcp.local.
            [Domain] => .
        )

    [3] => Array
        (
            [Name] => _apple-mobdev2
            [Type] => _tcp.local.
            [Domain] => .
        )

    [4] => Array
        (
            [Name] => _axis-video
            [Type] => _tcp.local.
            [Domain] => .
        )
)
*/
```