The library documentation (http://docs.python.org/library/os.html) states:

"""
os.EX_NOTFOUND
Exit code that means something like “an entry was not found”.

Availability: Unix.

New in version 2.3.
"""

However, on both my Linux and OS X installs of OS X this happens:

python
Python 2.6.2 (r262:71600, Oct 24 2009, 03:15:21) 
[GCC 4.4.1 [gcc-4_4-branch revision 150839]] on linux2
Type "help", "copyright", "credits" or "license" for more information.
im>>> import os
>>> os.EX_NOTFOUND
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
AttributeError: 'module' object has no attribute 'EX_NOTFOUND'
>>> 


Unfortunately I don't have another Python version available to test with at the moment so I'm not sure if this affects other versions as well.

That should have read "Linux and OS X installs of *Python*".

The following code exists in Modules/posixmodule.c

8167     /* These come from sysexits.h */
...
8216 #ifdef EX_NOTFOUND
8217     if (ins(d, "EX_NOTFOUND", (long)EX_NOTFOUND)) return -1;
8218 #endif /* EX_NOTFOUND */


sysexits.h on my Mac has no mention of EX_NOTFOUND. I'm guessing it was removed some time ago or maybe it never existed? I wasn't able to find anything after a quick Google search.

Was there any particular reason you need EX_NOTFOUND other than that it's documented? Just trying to trace where this thing came from and went.

Perhaps this constant existed at some point on some linux systems...google found one comment about it referencing posix.2.  I also found it mentioned in a specific version of sendmail, and in bash.  When it appears it seems to most often have the value 127.

I suspect the mention of this constant should just be deleted from the docs.  Google code search finds no mention of it in any sysexits.h file anywhere it has searched, so the chances are this constant will never be defined by Python.

s/linux/unix/

+1 for removing it from the docs.

I mostly wanted to just report the issue rather than propose a solution, so I'm in favor of whatever everyone feels is best.

As for how I came across the issue, it was mostly curiosity, I wanted to see the numerical value of all the os.EX_* constants and was printing them out on the screen when I stumbled upon this.

If there's no chance of it working, which seems to be the case, I agree it should probably be just removed from the documentation.

I fail to see the issue. The documentation clearly says, above the block of all the EX_* constants:

Note

Some of these may not be available on all Unix platforms, since there is some variation. These constants are defined where they are defined by the underlying platform.

That seems to explain the situation well, no?

I agree with Martin.

nosy: + georg.brandl
messages: + msg117263

resolution: works for me

messages: + msg117250

assignee: docs@python
components: + Documentation, - Library (Lib)