gc(1)

gc1

Count graph components

Usage

gc [-necCaDUrsv?] [files]

Overview

gc is a graph analogue to wc in that it prints to standard output the number of nodes, edges, connected components or clusters contained in the input files. It also prints a total count for all graphs if more than one graph is given.

Options

The following options are supported:

-n

Count nodes.

-e

Count edges.

-c

Count connected components.

-C

Count clusters. By definition, a cluster is a graph or subgraph whose name begins, case insensitively, with "cluster" or who has the cluster=true attribute.

-a

Count all. Equivalent to -encC

-r

Recursively analyze subgraphs.

-s

Print no output. Only exit value is important.

-D

Only analyze directed graphs.

-U

Only analyze undirected graphs.

-v

Verbose output.

-?

Print usage information.

By default, gc returns the number of nodes and edges.

Operands

The following operand is supported:

files

Names of files containing 1 or more graphs in dot format. If no files operand is specified, the standard input will be used.

Exit status

The following exit values are returned:

0

Successful completion.

1

The -U or -E option was used, and a graph of the wrong type was encountered.

Releases

12 releases since Debian 3.1 (Sarge); the text changed 2 times.

  1. 3.1–7
  2. 8–13
  3. Arch

-v since Debian 8 (Jessie).

Author

Emden R. Gansner <[email protected]>

From graphviz 16.1.0-2 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.