Bug 1279974 - Improve or replace netstat example
Improve or replace netstat example
Product: Red Hat Enterprise Linux 7
Classification: Red Hat
Component: doc-Security_Guide (Show other bugs)
Unspecified Unspecified
high Severity unspecified
: rc
: ---
Assigned To: Mirek Jahoda
: Documentation
Depends On: 1063913 1063927 1063934
Blocks: 1275695 1425467
  Show dependency treegraph
Reported: 2015-11-10 10:48 EST by Robert Krátký
Modified: 2017-05-24 11:51 EDT (History)
2 users (show)

See Also:
Fixed In Version:
Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of:
Last Closed: 2017-05-24 11:51:23 EDT
Type: Bug
Regression: ---
Mount Type: ---
Documentation: ---
Verified Versions:
Category: ---
oVirt Team: ---
RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: ---

Attachments (Terms of Use)

  None (edit)
Description Robert Krátký 2015-11-10 10:48:21 EST
Output listing spans more than a single page is difficult to read. Suggest editing the output to only relevant lines that illustrate the concept. A better example may be to pass the LISTEN directive to netstat by passing the -l option:  For example:  netstat -tlnw.  Additionally, the ss utility (part of iproute) may be a better tool overall for this task.
Comment 3 Mirek Jahoda 2016-05-10 11:46:18 EDT
Hello, can you please check the chapter 4.4.2 [1] - I am not sure if three (short) examples are the best way to go. I have already checked some connected bugzillas and it seems we are still waiting for the functionality in the ss utility (SCTP) or kernel to be precise. There is a plenty of commented code in XML and I am (again) not sure if this is right. Thank you.
[1] http://jenkinscat.gsslab.pnq.redhat.com:8080/job/doc-Red_Hat_Enterprise_Linux-7-Security_Guide%20%28html-single%29/lastStableBuild/artifact/tmp/en-US/html-single/index.html#sec-Verifying_Which_Ports_Are_Listening
Comment 4 Robert Krátký 2016-05-13 14:15:19 EDT
Thanks Mirek. The suggested changes are OK. I fixed some minor language mistakes that were already there and improved the formatting of the command outputs.

This bug needs to stay open because the functionality has not been ported to RHEL yet. When the problems of the utilities are resolved, the section will need to be reviewed again (and the commented content will be used).

I suggest you add yourself to BZ#1063913, so that you can keep track of the development.
Comment 5 Mirek Jahoda 2017-04-27 05:41:49 EDT
I've reworked the whole Which Ports Are Listening section [1]. I'm going to leave the SCTP ports scanning separated at least for some time (to emphasize that this functionality is now properly working). It seems like the netstat utility is not deprecated (and it's installed by default) even in RHEL 7.4 (I've tried it in the Alpha compose) and therefore I think it would be better to mention both (netstat and ss).

[1] http://jenkinscat.gsslab.pnq.redhat.com:8080/job/doc-Red_Hat_Enterprise_Linux-7-Security_Guide%20(html-single)/lastStableBuild/artifact/tmp/en-US/html-single/index.html#sec-Verifying_Which_Ports_Are_Listening

[2] https://gitlab.cee.redhat.com/red-hat-enterprise-linux-documentation/doc-Red_Hat_Enterprise_Linux-7-Security_Guide/commit/40a88cbfc9d562ace36413aac4de62ee7a9350f7
Comment 6 Hubert Kario 2017-05-09 14:51:57 EDT
Looks good to me. r+

Note You need to log in before you can comment on or make changes to this bug.