---
name: "pmSearchTextInDom"
section: "3"
platform: "linux"
package: "pcp"
version: "7.2.2-2"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/pmSearchTextInDom"
---

# pmSearchTextInDom(3)

search for all entities related to given instance domain

## NAME

**pmSearchTextInDom** - search for all entities related to given instance domain

## C SYNOPSIS

**#include \<pcp/pmwebapi.h\>**

**int pmSearchTextInDom(pmSearchSettings \****settings***,** **pmSearchTextRequest \****request***,** **void \****arg***);**

**cc ... -lpcp\_web**

## DESCRIPTION

Executes search for all metrics, instances and instance domains, that are related to given instance domain as specified by *request*:

- *query*

  Target instance domain.

- *count*

  Limits number of results. Defaults to 10.

- *offset*

  Search offset. Defaults to 0.

Results are ordered by type in an ascending order.

Each entity matched by the **request** above will be passed to **on\_text\_result** callback provided by **settings.**

## DIAGNOSTICS

This function always returns zero on success. On failure a negative PMAPI error code is returned.

## SEE ALSO

[**pmproxy**(1)](/pmproxy/1.md), [**pmlogger**(1)](/pmlogger/1.md), [**pmsearch**(1)](/pmsearch/1.md), [**pmSearchSetup**(3)](/pmSearchSetup/3.md), [**PMAPI**(3)](/PMAPI/3.md) and [**PMWEBAPI**(3)](/PMWEBAPI/3.md).