Utilities

The utility module contains the man command.

Commands

Note

• Parameters in square brackets [-param param] are optional.

• Parameters without square brackets -param2 param2 are required.

Man installation

The man command can be installed optionally as part of the OpenROAD binary. For more instructions, please refer to here.

Man

The man command in OpenROAD is similar in functionality to Unix (and Unix-like operating systems such as Linux) . It is used to display the manual pages for various applications, tools and error messages. These manual pages provide detailed information about how to use a particular command or function, along with its syntax and options.

This can be used for a range of commands in different levels as follows:

• Level 1: Top-level openroad command (e.g. man openroad)

• Level 2: Individual module commands (e.g. man clock_tree_synthesis)

• Level 3: Info, error, warning messages (e.g. man CTS-0001)

man
    name
    [-manpath manpath]
    [-no_pager]

Options

Switch Name	Description
name	Name of the command/message to query.
-manpath	Include optional path to man pages (e.g. ~/OpenROAD/docs/cat).
-no_pager	This flag determines whether you wish to see all of the man output at once. Default value is False, which shows a buffered output.

Example scripts

You may run various commands or message IDs for man pages.

man openroad
man clock_tree_synthesis
man CTS-0005

Regression tests

There are a set of regression tests in ./test. For more information, refer to this section.

For information regarding the Man page test framework, refer to this link.

You should also be aware of the README and Tcl format enforced to ensure accurate parsing of man pages.

Simply run the following script:

./test/regression

Limitations

FAQs

Check out GitHub discussion about this tool.

References

Authors

MAN command is written by Jack Luar with guidance from members of the OpenROAD team, including: Cho Moon, Matt Liberty.

License

BSD 3-Clause License. See LICENSE file.