Ticket 22440

Summary: --export-fie removed in 23.11.10 code, but not in docs
Product: Slurm Reporter: Ric Anderson <ric>
Component: DocumentationAssignee: Stephen Kendall <stephen>
Status: RESOLVED INFOGIVEN QA Contact:
Severity: 4 - Minor Issue    
Priority: ---    
Version: 23.11.10   
Hardware: Linux   
OS: Linux   
Site: U of AZ Alineos Sites: ---
Atos/Eviden Sites: --- Confidential Site: ---
Coreweave sites: --- Cray Sites: ---
DS9 clusters: --- HPCnow Sites: ---
HPE Sites: --- IBM Sites: ---
NOAA SIte: --- NoveTech Sites: ---
Nvidia HWinf-CS Sites: --- OCF Sites: ---
Recursion Pharma Sites: --- SFW Sites: ---
SNIC sites: --- Tzag Elita Sites: ---
Linux Distro: --- Machine Name:
CLE Version: Version Fixed:
Target Release: --- DevPrio: ---
Emory-Cloud Sites: ---

Description Ric Anderson 2025-03-26 12:46:56 MDT
For Slurm 23.1.10, the man page /usr/share/man/man1/sbatch.1.gz shows 
       --export-file={<filename>|<fd>}
              If a number between 3 and OPEN_MAX is specified as the  argument
              to  this  option,  a  readable  file  descriptor will be assumed
              (STDIN and STDOUT are not supported as valid arguments).  Other-
              wise a filename is assumed. Export environment variables defined
              in <filename> or read from <fd> to the job's execution  environ-
              ment.  The  content  is one or more environment variable defini-
              tions of the form NAME=value, each separated by a  null  charac-
              ter.  This  allows  the use of special characters in environment
              definitions.
However
  /usr/bin/sbatch --help | grep -i export
only shows
      --export[=names]        specify environment variables to export
I found in this info in slurm-23.11.10/RELEASE_NOTES.
      -- sbatch - removed --export-file option (used with defunct Moab integration).

Should the docs be updated, or is this feature coming back in slurm 24?
Comment 1 Stephen Kendall 2025-03-26 13:07:33 MDT
That one's interesting; although it was removed in 23.11, it was then brought back in 24.05.
https://github.com/SchedMD/slurm/commit/286f203d552a16cca2701d1893d491347cdb1695

If it is important to have that option, I would suggest you upgrade to 24.05.7 or 24.11.3. Refer to our upgrade guide for more guidance on performing the upgrade.
https://slurm.schedmd.com/upgrades.html

Let me know if you have any further questions.

Best regards,
Stephen
Comment 2 Ric Anderson 2025-03-26 13:15:07 MDT
Stephen:
Thanks for the update - I'll do some local man page surgery for the short term :-) 
Ric
Comment 3 Stephen Kendall 2025-03-31 10:29:18 MDT
That should help reduce confusion in your own environment. Since it looks like there are no further questions, I'll go ahead and close this ticket. Let us know if you need any further assistance.

Best regards,
Stephen