Page MenuHomeFreeBSD

ddb: Rework macros to make it easier to add new command tables.
ClosedPublic

Authored by jhb on Jun 30 2023, 10:46 PM.
Tags
None
Referenced Files
Unknown Object (File)
Tue, May 19, 9:56 AM
Unknown Object (File)
Tue, May 19, 5:18 AM
Unknown Object (File)
Tue, May 19, 3:43 AM
Unknown Object (File)
Sun, May 17, 3:17 AM
Unknown Object (File)
Apr 11 2026, 10:17 PM
Unknown Object (File)
Apr 4 2026, 11:38 PM
Unknown Object (File)
Mar 19 2026, 11:58 PM
Unknown Object (File)
Mar 17 2026, 7:18 PM

Details

Summary
  • Add new DB_DEFINE_TABLE and DB_DECLARE_TABLE macros to define new command tables. DB_DECLARE_TABLE is intended for use in headers similar to MALLOC_DECLARE and SYSCTL_DECL.

    DB_DEFINE_TABLE takes three arguments, the name of the parent table, the command name, and the name of the table itself, e.g. DB_DEFINE_TABLE(show, foo, show_foo) defines a new "show foo" table.
  • DB_TABLE_COMMAND, DB_TABLE_COMMAND_FLAGS, DB_TABLE_ALIAS, and DB_ALIAS_FLAGS allow new commands and aliases to be defined. These are similar to the existing DB_COMMAND, etc. except that they take an initial argument giving the name of the parent table, e.g.:

    DB_TABLE_COMMAND(show_foo, bar, db_show_foo_bar)

    defines a new "show foo bar" command.

This provides a cleaner interface than the ad-hoc use of internal
macros like _DB_SET that was required previously (e.g. in cxgbe(4)).

This retires DB_FUNC macro as well as the internal _DB_FUNC macro.

Diff Detail

Repository
rG FreeBSD src repository
Lint
Lint Not Applicable
Unit
Tests Not Applicable