Skip to content

Commit c42ad03

Browse files
committed
flux-exec(1): add CAVEATS
Problem: flux-exec(1) does not note the rank 0 restrictions, nor does it make it clear that the instance owner has no special powers when it comes to the --jobid option. Add a CAVEATS section that explains these constraints.
1 parent 2317728 commit c42ad03

File tree

1 file changed

+8
-0
lines changed

1 file changed

+8
-0
lines changed

doc/man1/flux-exec.rst

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -100,6 +100,14 @@ OPTIONS
100100
signal remote commands instead of the normal builtin subprocess signaling
101101
mechanism.
102102

103+
CAVEATS
104+
=======
105+
106+
In a multi-user flux instance, access to the rank 0 broker execution
107+
service is restricted to requests that originate from the local broker.
108+
Therefore, :program:`flux exec` (without :option:`--jobid`) must be run
109+
from the rank 0 broker if rank 0 is included in the target *IDSET*.
110+
103111
EXIT STATUS
104112
===========
105113

0 commit comments

Comments
 (0)