1
0
Fork 0
mirror of https://github.com/ansible-collections/community.general.git synced 2024-09-14 20:13:21 +02:00

wait_for: Add note about path and port (#48930)

Path and Port are mutually exclusive parameters but not documented.
This fix documents this requirement.

Fixes: #15732

Signed-off-by: Abhijeet Kasurde <akasurde@redhat.com>
This commit is contained in:
Abhijeet Kasurde 2018-11-26 13:49:25 +05:30 committed by GitHub
parent 731bf1b11d
commit 70f992c618
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23

View file

@ -50,6 +50,7 @@ options:
port: port:
description: description:
- Port number to poll. - Port number to poll.
- C(path) and C(port) are mutually exclusive parameters.
active_connection_states: active_connection_states:
description: description:
- The list of TCP connection states which are counted as active connections. - The list of TCP connection states which are counted as active connections.
@ -67,6 +68,7 @@ options:
version_added: "1.4" version_added: "1.4"
description: description:
- Path to a file on the filesystem that must exist before continuing. - Path to a file on the filesystem that must exist before continuing.
- C(path) and C(port) are mutually exclusive parameters.
search_regex: search_regex:
version_added: "1.4" version_added: "1.4"
description: description:
@ -87,7 +89,7 @@ options:
- This overrides the normal error message from a failure to meet the required conditions. - This overrides the normal error message from a failure to meet the required conditions.
notes: notes:
- The ability to use search_regex with a port connection was added in 1.7. - The ability to use search_regex with a port connection was added in 1.7.
- Prior to 2.4, testing for the absense of a directory or UNIX socket did not work correctly. - Prior to 2.4, testing for the absence of a directory or UNIX socket did not work correctly.
- Prior to 2.4, testing for the presence of a file did not work correctly if the remote user did not have read access to that file. - Prior to 2.4, testing for the presence of a file did not work correctly if the remote user did not have read access to that file.
- Under some circumstances when using mandatory access control, a path may always be treated as being absent even if it exists, but - Under some circumstances when using mandatory access control, a path may always be treated as being absent even if it exists, but
can't be modified or created by the remote user either. can't be modified or created by the remote user either.