# nomctl channel

```text
Channel management commands

Usage: nomctl channel <COMMAND>

Commands:
  list    List every channel on a data source
  search  Search channels across one or more data sources
  get     Get a single channel's metadata
  set     Set a channel's metadata (description and/or unit)
  help    Print this message or the help of the given subcommand(s)

Options:
  -h, --help
          Print help
```

## nomctl channel list

```text
List every channel on a data source

Usage: nomctl channel list <DATA_SOURCE_RID>

Arguments:
  <DATA_SOURCE_RID>
          RID of the data source (dataset, video, connection, etc.)

Options:
  -h, --help
          Print help
```

## nomctl channel search

```text
Search channels across one or more data sources

Usage: nomctl channel search [OPTIONS]

Options:
  -d, --data-source <RID>
          Restrict to a specific data source. Repeatable

  -s, --substring <SUBSTR>
          Require channel name to contain this substring (case-insensitive). Repeatable

      --data-type <TYPE>
          Restrict to a specific data type. Repeatable. One of: double, int, uint, string, log, double-array, string-array, struct, video

  -h, --help
          Print help
```

## nomctl channel get

```text
Get a single channel's metadata

Usage: nomctl channel get <DATA_SOURCE_RID> <NAME>

Arguments:
  <DATA_SOURCE_RID>
          RID of the data source that owns the channel

  <NAME>
          Channel name

Options:
  -h, --help
          Print help
```

## nomctl channel set

```text
Set a channel's metadata (description and/or unit)

Usage: nomctl channel set [OPTIONS] --data-type <TYPE> <DATA_SOURCE_RID> <NAME>

Arguments:
  <DATA_SOURCE_RID>
          RID of the data source that owns the channel

  <NAME>
          Channel name

Options:
      --data-type <TYPE>
          Channel data type. One of: double, int, uint, string, log, double-array, string-array, struct, video

  -d, --description <DESCRIPTION>
          Set the channel description

  -u, --unit <UNIT>
          Set the channel unit (e.g. "m/s", "celsius"). Mutually exclusive with --clear-unit

      --clear-unit
          Clear any unit previously set on the channel

  -h, --help
          Print help
```