Knowledge base
The top of the domain summary
Prints recipient domains by number of recipients in descending order. The manual calls it equivalent to show domains with –sort=rcpt; the options are the same.
The ceiling is the same — twenty domains by default.
The main trap is expecting a full list from the “top” command. It is the same summary with the same ceiling of twenty lines, only sorted.
What the Hub does. It does not call it: it takes the top domains for the “PMTA monitoring” screen with the /domains request.
Recommended values
When to use it:
| Question | This command or not |
|---|---|
| the largest receivers | yes |
| all receivers | no — show domains with –maxitems |
The equivalence with show domains –sort=rcpt comes from the manual (§ 6.3.18, § 6.3.13). The split of questions is ours.
Example configuration
# the ten largest receivers with errors pmta show topdomains --maxitems=10 --errors
pmta show domains –sort=rcpt –maxitems=10 –errors gives the same.
yellow — — directive names, blue — blocks. They are highlighted the same way in the text of the card.
Compatibility
PowerMTA 6.0
described in the manual of this version · platform: any
The vendor does not state the first version for every directive — there is no note here. The name also appears in the 5.0 edition of the manual.
⇄
Related entries
1 relation
Same name in other blocks
Per-receiver summaryA neighboring command: the same subject from another side. § 6.3.18
How to check on the node
Find out how many domains remain beyond the top:
pmta show topdomains | tail -1
The last line is “N of M domains shown”.
In the Hub
- Cost of a mistake
- safe: a wrong value breaks nothing