Require implementations for warnings.showwarning() support the 'line' argument.
[python.git] / Modules / posixmodule.c
blob1e5e3e518722717bb0bff6d6fc0492e67b37a57c
2 /* POSIX module implementation */
4 /* This file is also used for Windows NT/MS-Win and OS/2. In that case the
5 module actually calls itself 'nt' or 'os2', not 'posix', and a few
6 functions are either unimplemented or implemented differently. The source
7 assumes that for Windows NT, the macro 'MS_WINDOWS' is defined independent
8 of the compiler used. Different compilers define their own feature
9 test macro, e.g. '__BORLANDC__' or '_MSC_VER'. For OS/2, the compiler
10 independent macro PYOS_OS2 should be defined. On OS/2 the default
11 compiler is assumed to be IBM's VisualAge C++ (VACPP). PYCC_GCC is used
12 as the compiler specific macro for the EMX port of gcc to OS/2. */
14 /* See also ../Dos/dosmodule.c */
16 #ifdef __APPLE__
18 * Step 1 of support for weak-linking a number of symbols existing on
19 * OSX 10.4 and later, see the comment in the #ifdef __APPLE__ block
20 * at the end of this file for more information.
22 # pragma weak lchown
23 # pragma weak statvfs
24 # pragma weak fstatvfs
26 #endif /* __APPLE__ */
28 #define PY_SSIZE_T_CLEAN
30 #include "Python.h"
31 #include "structseq.h"
33 #if defined(__VMS)
34 # include <unixio.h>
35 #endif /* defined(__VMS) */
37 #ifdef __cplusplus
38 extern "C" {
39 #endif
41 PyDoc_STRVAR(posix__doc__,
42 "This module provides access to operating system functionality that is\n\
43 standardized by the C Standard and the POSIX standard (a thinly\n\
44 disguised Unix interface). Refer to the library manual and\n\
45 corresponding Unix manual entries for more information on calls.");
47 #ifndef Py_USING_UNICODE
48 /* This is used in signatures of functions. */
49 #define Py_UNICODE void
50 #endif
52 #if defined(PYOS_OS2)
53 #define INCL_DOS
54 #define INCL_DOSERRORS
55 #define INCL_DOSPROCESS
56 #define INCL_NOPMAPI
57 #include <os2.h>
58 #if defined(PYCC_GCC)
59 #include <ctype.h>
60 #include <io.h>
61 #include <stdio.h>
62 #include <process.h>
63 #endif
64 #include "osdefs.h"
65 #endif
67 #ifdef HAVE_SYS_TYPES_H
68 #include <sys/types.h>
69 #endif /* HAVE_SYS_TYPES_H */
71 #ifdef HAVE_SYS_STAT_H
72 #include <sys/stat.h>
73 #endif /* HAVE_SYS_STAT_H */
75 #ifdef HAVE_SYS_WAIT_H
76 #include <sys/wait.h> /* For WNOHANG */
77 #endif
79 #ifdef HAVE_SIGNAL_H
80 #include <signal.h>
81 #endif
83 #ifdef HAVE_FCNTL_H
84 #include <fcntl.h>
85 #endif /* HAVE_FCNTL_H */
87 #ifdef HAVE_GRP_H
88 #include <grp.h>
89 #endif
91 #ifdef HAVE_SYSEXITS_H
92 #include <sysexits.h>
93 #endif /* HAVE_SYSEXITS_H */
95 #ifdef HAVE_SYS_LOADAVG_H
96 #include <sys/loadavg.h>
97 #endif
99 /* Various compilers have only certain posix functions */
100 /* XXX Gosh I wish these were all moved into pyconfig.h */
101 #if defined(PYCC_VACPP) && defined(PYOS_OS2)
102 #include <process.h>
103 #else
104 #if defined(__WATCOMC__) && !defined(__QNX__) /* Watcom compiler */
105 #define HAVE_GETCWD 1
106 #define HAVE_OPENDIR 1
107 #define HAVE_SYSTEM 1
108 #if defined(__OS2__)
109 #define HAVE_EXECV 1
110 #define HAVE_WAIT 1
111 #endif
112 #include <process.h>
113 #else
114 #ifdef __BORLANDC__ /* Borland compiler */
115 #define HAVE_EXECV 1
116 #define HAVE_GETCWD 1
117 #define HAVE_OPENDIR 1
118 #define HAVE_PIPE 1
119 #define HAVE_POPEN 1
120 #define HAVE_SYSTEM 1
121 #define HAVE_WAIT 1
122 #else
123 #ifdef _MSC_VER /* Microsoft compiler */
124 #define HAVE_GETCWD 1
125 #define HAVE_SPAWNV 1
126 #define HAVE_EXECV 1
127 #define HAVE_PIPE 1
128 #define HAVE_POPEN 1
129 #define HAVE_SYSTEM 1
130 #define HAVE_CWAIT 1
131 #define HAVE_FSYNC 1
132 #define fsync _commit
133 #else
134 #if defined(PYOS_OS2) && defined(PYCC_GCC) || defined(__VMS)
135 /* Everything needed is defined in PC/os2emx/pyconfig.h or vms/pyconfig.h */
136 #else /* all other compilers */
137 /* Unix functions that the configure script doesn't check for */
138 #define HAVE_EXECV 1
139 #define HAVE_FORK 1
140 #if defined(__USLC__) && defined(__SCO_VERSION__) /* SCO UDK Compiler */
141 #define HAVE_FORK1 1
142 #endif
143 #define HAVE_GETCWD 1
144 #define HAVE_GETEGID 1
145 #define HAVE_GETEUID 1
146 #define HAVE_GETGID 1
147 #define HAVE_GETPPID 1
148 #define HAVE_GETUID 1
149 #define HAVE_KILL 1
150 #define HAVE_OPENDIR 1
151 #define HAVE_PIPE 1
152 #ifndef __rtems__
153 #define HAVE_POPEN 1
154 #endif
155 #define HAVE_SYSTEM 1
156 #define HAVE_WAIT 1
157 #define HAVE_TTYNAME 1
158 #endif /* PYOS_OS2 && PYCC_GCC && __VMS */
159 #endif /* _MSC_VER */
160 #endif /* __BORLANDC__ */
161 #endif /* ! __WATCOMC__ || __QNX__ */
162 #endif /* ! __IBMC__ */
164 #ifndef _MSC_VER
166 #if defined(__sgi)&&_COMPILER_VERSION>=700
167 /* declare ctermid_r if compiling with MIPSPro 7.x in ANSI C mode
168 (default) */
169 extern char *ctermid_r(char *);
170 #endif
172 #ifndef HAVE_UNISTD_H
173 #if defined(PYCC_VACPP)
174 extern int mkdir(char *);
175 #else
176 #if ( defined(__WATCOMC__) || defined(_MSC_VER) ) && !defined(__QNX__)
177 extern int mkdir(const char *);
178 #else
179 extern int mkdir(const char *, mode_t);
180 #endif
181 #endif
182 #if defined(__IBMC__) || defined(__IBMCPP__)
183 extern int chdir(char *);
184 extern int rmdir(char *);
185 #else
186 extern int chdir(const char *);
187 extern int rmdir(const char *);
188 #endif
189 #ifdef __BORLANDC__
190 extern int chmod(const char *, int);
191 #else
192 extern int chmod(const char *, mode_t);
193 #endif
194 /*#ifdef HAVE_FCHMOD
195 extern int fchmod(int, mode_t);
196 #endif*/
197 /*#ifdef HAVE_LCHMOD
198 extern int lchmod(const char *, mode_t);
199 #endif*/
200 extern int chown(const char *, uid_t, gid_t);
201 extern char *getcwd(char *, int);
202 extern char *strerror(int);
203 extern int link(const char *, const char *);
204 extern int rename(const char *, const char *);
205 extern int stat(const char *, struct stat *);
206 extern int unlink(const char *);
207 extern int pclose(FILE *);
208 #ifdef HAVE_SYMLINK
209 extern int symlink(const char *, const char *);
210 #endif /* HAVE_SYMLINK */
211 #ifdef HAVE_LSTAT
212 extern int lstat(const char *, struct stat *);
213 #endif /* HAVE_LSTAT */
214 #endif /* !HAVE_UNISTD_H */
216 #endif /* !_MSC_VER */
218 #ifdef HAVE_UTIME_H
219 #include <utime.h>
220 #endif /* HAVE_UTIME_H */
222 #ifdef HAVE_SYS_UTIME_H
223 #include <sys/utime.h>
224 #define HAVE_UTIME_H /* pretend we do for the rest of this file */
225 #endif /* HAVE_SYS_UTIME_H */
227 #ifdef HAVE_SYS_TIMES_H
228 #include <sys/times.h>
229 #endif /* HAVE_SYS_TIMES_H */
231 #ifdef HAVE_SYS_PARAM_H
232 #include <sys/param.h>
233 #endif /* HAVE_SYS_PARAM_H */
235 #ifdef HAVE_SYS_UTSNAME_H
236 #include <sys/utsname.h>
237 #endif /* HAVE_SYS_UTSNAME_H */
239 #ifdef HAVE_DIRENT_H
240 #include <dirent.h>
241 #define NAMLEN(dirent) strlen((dirent)->d_name)
242 #else
243 #if defined(__WATCOMC__) && !defined(__QNX__)
244 #include <direct.h>
245 #define NAMLEN(dirent) strlen((dirent)->d_name)
246 #else
247 #define dirent direct
248 #define NAMLEN(dirent) (dirent)->d_namlen
249 #endif
250 #ifdef HAVE_SYS_NDIR_H
251 #include <sys/ndir.h>
252 #endif
253 #ifdef HAVE_SYS_DIR_H
254 #include <sys/dir.h>
255 #endif
256 #ifdef HAVE_NDIR_H
257 #include <ndir.h>
258 #endif
259 #endif
261 #ifdef _MSC_VER
262 #ifdef HAVE_DIRECT_H
263 #include <direct.h>
264 #endif
265 #ifdef HAVE_IO_H
266 #include <io.h>
267 #endif
268 #ifdef HAVE_PROCESS_H
269 #include <process.h>
270 #endif
271 #include "osdefs.h"
272 #include <windows.h>
273 #include <shellapi.h> /* for ShellExecute() */
274 #define popen _popen
275 #define pclose _pclose
276 #endif /* _MSC_VER */
278 #if defined(PYCC_VACPP) && defined(PYOS_OS2)
279 #include <io.h>
280 #endif /* OS2 */
282 #ifndef MAXPATHLEN
283 #if defined(PATH_MAX) && PATH_MAX > 1024
284 #define MAXPATHLEN PATH_MAX
285 #else
286 #define MAXPATHLEN 1024
287 #endif
288 #endif /* MAXPATHLEN */
290 #ifdef UNION_WAIT
291 /* Emulate some macros on systems that have a union instead of macros */
293 #ifndef WIFEXITED
294 #define WIFEXITED(u_wait) (!(u_wait).w_termsig && !(u_wait).w_coredump)
295 #endif
297 #ifndef WEXITSTATUS
298 #define WEXITSTATUS(u_wait) (WIFEXITED(u_wait)?((u_wait).w_retcode):-1)
299 #endif
301 #ifndef WTERMSIG
302 #define WTERMSIG(u_wait) ((u_wait).w_termsig)
303 #endif
305 #define WAIT_TYPE union wait
306 #define WAIT_STATUS_INT(s) (s.w_status)
308 #else /* !UNION_WAIT */
309 #define WAIT_TYPE int
310 #define WAIT_STATUS_INT(s) (s)
311 #endif /* UNION_WAIT */
313 /* Don't use the "_r" form if we don't need it (also, won't have a
314 prototype for it, at least on Solaris -- maybe others as well?). */
315 #if defined(HAVE_CTERMID_R) && defined(WITH_THREAD)
316 #define USE_CTERMID_R
317 #endif
319 #if defined(HAVE_TMPNAM_R) && defined(WITH_THREAD)
320 #define USE_TMPNAM_R
321 #endif
323 /* choose the appropriate stat and fstat functions and return structs */
324 #undef STAT
325 #if defined(MS_WIN64) || defined(MS_WINDOWS)
326 # define STAT win32_stat
327 # define FSTAT win32_fstat
328 # define STRUCT_STAT struct win32_stat
329 #else
330 # define STAT stat
331 # define FSTAT fstat
332 # define STRUCT_STAT struct stat
333 #endif
335 #if defined(MAJOR_IN_MKDEV)
336 #include <sys/mkdev.h>
337 #else
338 #if defined(MAJOR_IN_SYSMACROS)
339 #include <sys/sysmacros.h>
340 #endif
341 #if defined(HAVE_MKNOD) && defined(HAVE_SYS_MKDEV_H)
342 #include <sys/mkdev.h>
343 #endif
344 #endif
346 #if defined _MSC_VER && _MSC_VER >= 1400
347 /* Microsoft CRT in VS2005 and higher will verify that a filehandle is
348 * valid and throw an assertion if it isn't.
349 * Normally, an invalid fd is likely to be a C program error and therefore
350 * an assertion can be useful, but it does contradict the POSIX standard
351 * which for write(2) states:
352 * "Otherwise, -1 shall be returned and errno set to indicate the error."
353 * "[EBADF] The fildes argument is not a valid file descriptor open for
354 * writing."
355 * Furthermore, python allows the user to enter any old integer
356 * as a fd and should merely raise a python exception on error.
357 * The Microsoft CRT doesn't provide an official way to check for the
358 * validity of a file descriptor, but we can emulate its internal behaviour
359 * by using the exported __pinfo data member and knowledge of the
360 * internal structures involved.
361 * The structures below must be updated for each version of visual studio
362 * according to the file internal.h in the CRT source, until MS comes
363 * up with a less hacky way to do this.
364 * (all of this is to avoid globally modifying the CRT behaviour using
365 * _set_invalid_parameter_handler() and _CrtSetReportMode())
367 #if _MSC_VER >= 1500 /* VS 2008 */
368 typedef struct {
369 intptr_t osfhnd;
370 char osfile;
371 char pipech;
372 int lockinitflag;
373 CRITICAL_SECTION lock;
374 #ifndef _SAFECRT_IMPL
375 char textmode : 7;
376 char unicode : 1;
377 char pipech2[2];
378 __int64 startpos;
379 BOOL utf8translations;
380 char dbcsBuffer;
381 BOOL dbcsBufferUsed;
382 #endif /* _SAFECRT_IMPL */
383 } ioinfo;
384 #elif _MSC_VER >= 1400 /* VS 2005 */
385 typedef struct {
386 intptr_t osfhnd;
387 char osfile;
388 char pipech;
389 int lockinitflag;
390 CRITICAL_SECTION lock;
391 #ifndef _SAFECRT_IMPL
392 char textmode : 7;
393 char unicode : 1;
394 char pipech2[2];
395 __int64 startpos;
396 BOOL utf8translations;
397 #endif /* _SAFECRT_IMPL */
398 } ioinfo;
399 #endif
401 extern __declspec(dllimport) ioinfo * __pioinfo[];
402 #define IOINFO_L2E 5
403 #define IOINFO_ARRAY_ELTS (1 << IOINFO_L2E)
404 #define IOINFO_ARRAYS 64
405 #define _NHANDLE_ (IOINFO_ARRAYS * IOINFO_ARRAY_ELTS)
406 #define FOPEN 0x01
407 #define _NO_CONSOLE_FILENO (intptr_t)-2
409 /* This function emulates what the windows CRT does to validate file handles */
411 _PyVerify_fd(int fd)
413 const int i1 = fd >> IOINFO_L2E;
414 const int i2 = fd & ((1 << IOINFO_L2E) - 1);
416 /* See that it isn't a special CLEAR fileno */
417 if (fd != _NO_CONSOLE_FILENO) {
418 /* Microsoft CRT would check that 0<=fd<_nhandle but we can't do that. Instead
419 * we check pointer validity and other info
421 if (0 <= i1 && i1 < IOINFO_ARRAYS && __pioinfo[i1] != NULL) {
422 /* finally, check that the file is open */
423 if (__pioinfo[i1][i2].osfile & FOPEN)
424 return 1;
427 errno = EBADF;
428 return 0;
431 /* the special case of checking dup2. The target fd must be in a sensible range */
432 static int
433 _PyVerify_fd_dup2(int fd1, int fd2)
435 if (!_PyVerify_fd(fd1))
436 return 0;
437 if (fd2 == _NO_CONSOLE_FILENO)
438 return 0;
439 if ((unsigned)fd2 < _NHANDLE_)
440 return 1;
441 else
442 return 0;
444 #else
445 /* dummy version. _PyVerify_fd() is already defined in fileobject.h */
446 #define _PyVerify_fd_dup2(A, B) (1)
447 #endif
449 /* Return a dictionary corresponding to the POSIX environment table */
450 #ifdef WITH_NEXT_FRAMEWORK
451 /* On Darwin/MacOSX a shared library or framework has no access to
452 ** environ directly, we must obtain it with _NSGetEnviron().
454 #include <crt_externs.h>
455 static char **environ;
456 #elif !defined(_MSC_VER) && ( !defined(__WATCOMC__) || defined(__QNX__) )
457 extern char **environ;
458 #endif /* !_MSC_VER */
460 static PyObject *
461 convertenviron(void)
463 PyObject *d;
464 char **e;
465 d = PyDict_New();
466 if (d == NULL)
467 return NULL;
468 #ifdef WITH_NEXT_FRAMEWORK
469 if (environ == NULL)
470 environ = *_NSGetEnviron();
471 #endif
472 if (environ == NULL)
473 return d;
474 /* This part ignores errors */
475 for (e = environ; *e != NULL; e++) {
476 PyObject *k;
477 PyObject *v;
478 char *p = strchr(*e, '=');
479 if (p == NULL)
480 continue;
481 k = PyString_FromStringAndSize(*e, (int)(p-*e));
482 if (k == NULL) {
483 PyErr_Clear();
484 continue;
486 v = PyString_FromString(p+1);
487 if (v == NULL) {
488 PyErr_Clear();
489 Py_DECREF(k);
490 continue;
492 if (PyDict_GetItem(d, k) == NULL) {
493 if (PyDict_SetItem(d, k, v) != 0)
494 PyErr_Clear();
496 Py_DECREF(k);
497 Py_DECREF(v);
499 #if defined(PYOS_OS2)
501 APIRET rc;
502 char buffer[1024]; /* OS/2 Provides a Documented Max of 1024 Chars */
504 rc = DosQueryExtLIBPATH(buffer, BEGIN_LIBPATH);
505 if (rc == NO_ERROR) { /* (not a type, envname is NOT 'BEGIN_LIBPATH') */
506 PyObject *v = PyString_FromString(buffer);
507 PyDict_SetItemString(d, "BEGINLIBPATH", v);
508 Py_DECREF(v);
510 rc = DosQueryExtLIBPATH(buffer, END_LIBPATH);
511 if (rc == NO_ERROR) { /* (not a typo, envname is NOT 'END_LIBPATH') */
512 PyObject *v = PyString_FromString(buffer);
513 PyDict_SetItemString(d, "ENDLIBPATH", v);
514 Py_DECREF(v);
517 #endif
518 return d;
522 /* Set a POSIX-specific error from errno, and return NULL */
524 static PyObject *
525 posix_error(void)
527 return PyErr_SetFromErrno(PyExc_OSError);
529 static PyObject *
530 posix_error_with_filename(char* name)
532 return PyErr_SetFromErrnoWithFilename(PyExc_OSError, name);
535 #ifdef Py_WIN_WIDE_FILENAMES
536 static PyObject *
537 posix_error_with_unicode_filename(Py_UNICODE* name)
539 return PyErr_SetFromErrnoWithUnicodeFilename(PyExc_OSError, name);
541 #endif /* Py_WIN_WIDE_FILENAMES */
544 static PyObject *
545 posix_error_with_allocated_filename(char* name)
547 PyObject *rc = PyErr_SetFromErrnoWithFilename(PyExc_OSError, name);
548 PyMem_Free(name);
549 return rc;
552 #ifdef MS_WINDOWS
553 static PyObject *
554 win32_error(char* function, char* filename)
556 /* XXX We should pass the function name along in the future.
557 (_winreg.c also wants to pass the function name.)
558 This would however require an additional param to the
559 Windows error object, which is non-trivial.
561 errno = GetLastError();
562 if (filename)
563 return PyErr_SetFromWindowsErrWithFilename(errno, filename);
564 else
565 return PyErr_SetFromWindowsErr(errno);
568 #ifdef Py_WIN_WIDE_FILENAMES
569 static PyObject *
570 win32_error_unicode(char* function, Py_UNICODE* filename)
572 /* XXX - see win32_error for comments on 'function' */
573 errno = GetLastError();
574 if (filename)
575 return PyErr_SetFromWindowsErrWithUnicodeFilename(errno, filename);
576 else
577 return PyErr_SetFromWindowsErr(errno);
580 static int
581 convert_to_unicode(PyObject **param)
583 if (PyUnicode_CheckExact(*param))
584 Py_INCREF(*param);
585 else if (PyUnicode_Check(*param))
586 /* For a Unicode subtype that's not a Unicode object,
587 return a true Unicode object with the same data. */
588 *param = PyUnicode_FromUnicode(PyUnicode_AS_UNICODE(*param),
589 PyUnicode_GET_SIZE(*param));
590 else
591 *param = PyUnicode_FromEncodedObject(*param,
592 Py_FileSystemDefaultEncoding,
593 "strict");
594 return (*param) != NULL;
597 #endif /* Py_WIN_WIDE_FILENAMES */
599 #endif
601 #if defined(PYOS_OS2)
602 /**********************************************************************
603 * Helper Function to Trim and Format OS/2 Messages
604 **********************************************************************/
605 static void
606 os2_formatmsg(char *msgbuf, int msglen, char *reason)
608 msgbuf[msglen] = '\0'; /* OS/2 Doesn't Guarantee a Terminator */
610 if (strlen(msgbuf) > 0) { /* If Non-Empty Msg, Trim CRLF */
611 char *lastc = &msgbuf[ strlen(msgbuf)-1 ];
613 while (lastc > msgbuf && isspace(Py_CHARMASK(*lastc)))
614 *lastc-- = '\0'; /* Trim Trailing Whitespace (CRLF) */
617 /* Add Optional Reason Text */
618 if (reason) {
619 strcat(msgbuf, " : ");
620 strcat(msgbuf, reason);
624 /**********************************************************************
625 * Decode an OS/2 Operating System Error Code
627 * A convenience function to lookup an OS/2 error code and return a
628 * text message we can use to raise a Python exception.
630 * Notes:
631 * The messages for errors returned from the OS/2 kernel reside in
632 * the file OSO001.MSG in the \OS2 directory hierarchy.
634 **********************************************************************/
635 static char *
636 os2_strerror(char *msgbuf, int msgbuflen, int errorcode, char *reason)
638 APIRET rc;
639 ULONG msglen;
641 /* Retrieve Kernel-Related Error Message from OSO001.MSG File */
642 Py_BEGIN_ALLOW_THREADS
643 rc = DosGetMessage(NULL, 0, msgbuf, msgbuflen,
644 errorcode, "oso001.msg", &msglen);
645 Py_END_ALLOW_THREADS
647 if (rc == NO_ERROR)
648 os2_formatmsg(msgbuf, msglen, reason);
649 else
650 PyOS_snprintf(msgbuf, msgbuflen,
651 "unknown OS error #%d", errorcode);
653 return msgbuf;
656 /* Set an OS/2-specific error and return NULL. OS/2 kernel
657 errors are not in a global variable e.g. 'errno' nor are
658 they congruent with posix error numbers. */
660 static PyObject * os2_error(int code)
662 char text[1024];
663 PyObject *v;
665 os2_strerror(text, sizeof(text), code, "");
667 v = Py_BuildValue("(is)", code, text);
668 if (v != NULL) {
669 PyErr_SetObject(PyExc_OSError, v);
670 Py_DECREF(v);
672 return NULL; /* Signal to Python that an Exception is Pending */
675 #endif /* OS2 */
677 /* POSIX generic methods */
679 static PyObject *
680 posix_fildes(PyObject *fdobj, int (*func)(int))
682 int fd;
683 int res;
684 fd = PyObject_AsFileDescriptor(fdobj);
685 if (fd < 0)
686 return NULL;
687 if (!_PyVerify_fd(fd))
688 return posix_error();
689 Py_BEGIN_ALLOW_THREADS
690 res = (*func)(fd);
691 Py_END_ALLOW_THREADS
692 if (res < 0)
693 return posix_error();
694 Py_INCREF(Py_None);
695 return Py_None;
698 #ifdef Py_WIN_WIDE_FILENAMES
699 static int
700 unicode_file_names(void)
702 static int canusewide = -1;
703 if (canusewide == -1) {
704 /* As per doc for ::GetVersion(), this is the correct test for
705 the Windows NT family. */
706 canusewide = (GetVersion() < 0x80000000) ? 1 : 0;
708 return canusewide;
710 #endif
712 static PyObject *
713 posix_1str(PyObject *args, char *format, int (*func)(const char*))
715 char *path1 = NULL;
716 int res;
717 if (!PyArg_ParseTuple(args, format,
718 Py_FileSystemDefaultEncoding, &path1))
719 return NULL;
720 Py_BEGIN_ALLOW_THREADS
721 res = (*func)(path1);
722 Py_END_ALLOW_THREADS
723 if (res < 0)
724 return posix_error_with_allocated_filename(path1);
725 PyMem_Free(path1);
726 Py_INCREF(Py_None);
727 return Py_None;
730 static PyObject *
731 posix_2str(PyObject *args,
732 char *format,
733 int (*func)(const char *, const char *))
735 char *path1 = NULL, *path2 = NULL;
736 int res;
737 if (!PyArg_ParseTuple(args, format,
738 Py_FileSystemDefaultEncoding, &path1,
739 Py_FileSystemDefaultEncoding, &path2))
740 return NULL;
741 Py_BEGIN_ALLOW_THREADS
742 res = (*func)(path1, path2);
743 Py_END_ALLOW_THREADS
744 PyMem_Free(path1);
745 PyMem_Free(path2);
746 if (res != 0)
747 /* XXX how to report both path1 and path2??? */
748 return posix_error();
749 Py_INCREF(Py_None);
750 return Py_None;
753 #ifdef Py_WIN_WIDE_FILENAMES
754 static PyObject*
755 win32_1str(PyObject* args, char* func,
756 char* format, BOOL (__stdcall *funcA)(LPCSTR),
757 char* wformat, BOOL (__stdcall *funcW)(LPWSTR))
759 PyObject *uni;
760 char *ansi;
761 BOOL result;
762 if (unicode_file_names()) {
763 if (!PyArg_ParseTuple(args, wformat, &uni))
764 PyErr_Clear();
765 else {
766 Py_BEGIN_ALLOW_THREADS
767 result = funcW(PyUnicode_AsUnicode(uni));
768 Py_END_ALLOW_THREADS
769 if (!result)
770 return win32_error_unicode(func, PyUnicode_AsUnicode(uni));
771 Py_INCREF(Py_None);
772 return Py_None;
775 if (!PyArg_ParseTuple(args, format, &ansi))
776 return NULL;
777 Py_BEGIN_ALLOW_THREADS
778 result = funcA(ansi);
779 Py_END_ALLOW_THREADS
780 if (!result)
781 return win32_error(func, ansi);
782 Py_INCREF(Py_None);
783 return Py_None;
787 /* This is a reimplementation of the C library's chdir function,
788 but one that produces Win32 errors instead of DOS error codes.
789 chdir is essentially a wrapper around SetCurrentDirectory; however,
790 it also needs to set "magic" environment variables indicating
791 the per-drive current directory, which are of the form =<drive>: */
792 static BOOL __stdcall
793 win32_chdir(LPCSTR path)
795 char new_path[MAX_PATH+1];
796 int result;
797 char env[4] = "=x:";
799 if(!SetCurrentDirectoryA(path))
800 return FALSE;
801 result = GetCurrentDirectoryA(MAX_PATH+1, new_path);
802 if (!result)
803 return FALSE;
804 /* In the ANSI API, there should not be any paths longer
805 than MAX_PATH. */
806 assert(result <= MAX_PATH+1);
807 if (strncmp(new_path, "\\\\", 2) == 0 ||
808 strncmp(new_path, "//", 2) == 0)
809 /* UNC path, nothing to do. */
810 return TRUE;
811 env[1] = new_path[0];
812 return SetEnvironmentVariableA(env, new_path);
815 /* The Unicode version differs from the ANSI version
816 since the current directory might exceed MAX_PATH characters */
817 static BOOL __stdcall
818 win32_wchdir(LPCWSTR path)
820 wchar_t _new_path[MAX_PATH+1], *new_path = _new_path;
821 int result;
822 wchar_t env[4] = L"=x:";
824 if(!SetCurrentDirectoryW(path))
825 return FALSE;
826 result = GetCurrentDirectoryW(MAX_PATH+1, new_path);
827 if (!result)
828 return FALSE;
829 if (result > MAX_PATH+1) {
830 new_path = malloc(result * sizeof(wchar_t));
831 if (!new_path) {
832 SetLastError(ERROR_OUTOFMEMORY);
833 return FALSE;
835 result = GetCurrentDirectoryW(result, new_path);
836 if (!result) {
837 free(new_path);
838 return FALSE;
841 if (wcsncmp(new_path, L"\\\\", 2) == 0 ||
842 wcsncmp(new_path, L"//", 2) == 0)
843 /* UNC path, nothing to do. */
844 return TRUE;
845 env[1] = new_path[0];
846 result = SetEnvironmentVariableW(env, new_path);
847 if (new_path != _new_path)
848 free(new_path);
849 return result;
851 #endif
853 #ifdef MS_WINDOWS
854 /* The CRT of Windows has a number of flaws wrt. its stat() implementation:
855 - time stamps are restricted to second resolution
856 - file modification times suffer from forth-and-back conversions between
857 UTC and local time
858 Therefore, we implement our own stat, based on the Win32 API directly.
860 #define HAVE_STAT_NSEC 1
862 struct win32_stat{
863 int st_dev;
864 __int64 st_ino;
865 unsigned short st_mode;
866 int st_nlink;
867 int st_uid;
868 int st_gid;
869 int st_rdev;
870 __int64 st_size;
871 int st_atime;
872 int st_atime_nsec;
873 int st_mtime;
874 int st_mtime_nsec;
875 int st_ctime;
876 int st_ctime_nsec;
879 static __int64 secs_between_epochs = 11644473600; /* Seconds between 1.1.1601 and 1.1.1970 */
881 static void
882 FILE_TIME_to_time_t_nsec(FILETIME *in_ptr, int *time_out, int* nsec_out)
884 /* XXX endianness. Shouldn't matter, as all Windows implementations are little-endian */
885 /* Cannot simply cast and dereference in_ptr,
886 since it might not be aligned properly */
887 __int64 in;
888 memcpy(&in, in_ptr, sizeof(in));
889 *nsec_out = (int)(in % 10000000) * 100; /* FILETIME is in units of 100 nsec. */
890 /* XXX Win32 supports time stamps past 2038; we currently don't */
891 *time_out = Py_SAFE_DOWNCAST((in / 10000000) - secs_between_epochs, __int64, int);
894 static void
895 time_t_to_FILE_TIME(int time_in, int nsec_in, FILETIME *out_ptr)
897 /* XXX endianness */
898 __int64 out;
899 out = time_in + secs_between_epochs;
900 out = out * 10000000 + nsec_in / 100;
901 memcpy(out_ptr, &out, sizeof(out));
904 /* Below, we *know* that ugo+r is 0444 */
905 #if _S_IREAD != 0400
906 #error Unsupported C library
907 #endif
908 static int
909 attributes_to_mode(DWORD attr)
911 int m = 0;
912 if (attr & FILE_ATTRIBUTE_DIRECTORY)
913 m |= _S_IFDIR | 0111; /* IFEXEC for user,group,other */
914 else
915 m |= _S_IFREG;
916 if (attr & FILE_ATTRIBUTE_READONLY)
917 m |= 0444;
918 else
919 m |= 0666;
920 return m;
923 static int
924 attribute_data_to_stat(WIN32_FILE_ATTRIBUTE_DATA *info, struct win32_stat *result)
926 memset(result, 0, sizeof(*result));
927 result->st_mode = attributes_to_mode(info->dwFileAttributes);
928 result->st_size = (((__int64)info->nFileSizeHigh)<<32) + info->nFileSizeLow;
929 FILE_TIME_to_time_t_nsec(&info->ftCreationTime, &result->st_ctime, &result->st_ctime_nsec);
930 FILE_TIME_to_time_t_nsec(&info->ftLastWriteTime, &result->st_mtime, &result->st_mtime_nsec);
931 FILE_TIME_to_time_t_nsec(&info->ftLastAccessTime, &result->st_atime, &result->st_atime_nsec);
933 return 0;
936 /* Emulate GetFileAttributesEx[AW] on Windows 95 */
937 static int checked = 0;
938 static BOOL (CALLBACK *gfaxa)(LPCSTR, GET_FILEEX_INFO_LEVELS, LPVOID);
939 static BOOL (CALLBACK *gfaxw)(LPCWSTR, GET_FILEEX_INFO_LEVELS, LPVOID);
940 static void
941 check_gfax()
943 HINSTANCE hKernel32;
944 if (checked)
945 return;
946 checked = 1;
947 hKernel32 = GetModuleHandle("KERNEL32");
948 *(FARPROC*)&gfaxa = GetProcAddress(hKernel32, "GetFileAttributesExA");
949 *(FARPROC*)&gfaxw = GetProcAddress(hKernel32, "GetFileAttributesExW");
952 static BOOL
953 attributes_from_dir(LPCSTR pszFile, LPWIN32_FILE_ATTRIBUTE_DATA pfad)
955 HANDLE hFindFile;
956 WIN32_FIND_DATAA FileData;
957 hFindFile = FindFirstFileA(pszFile, &FileData);
958 if (hFindFile == INVALID_HANDLE_VALUE)
959 return FALSE;
960 FindClose(hFindFile);
961 pfad->dwFileAttributes = FileData.dwFileAttributes;
962 pfad->ftCreationTime = FileData.ftCreationTime;
963 pfad->ftLastAccessTime = FileData.ftLastAccessTime;
964 pfad->ftLastWriteTime = FileData.ftLastWriteTime;
965 pfad->nFileSizeHigh = FileData.nFileSizeHigh;
966 pfad->nFileSizeLow = FileData.nFileSizeLow;
967 return TRUE;
970 static BOOL
971 attributes_from_dir_w(LPCWSTR pszFile, LPWIN32_FILE_ATTRIBUTE_DATA pfad)
973 HANDLE hFindFile;
974 WIN32_FIND_DATAW FileData;
975 hFindFile = FindFirstFileW(pszFile, &FileData);
976 if (hFindFile == INVALID_HANDLE_VALUE)
977 return FALSE;
978 FindClose(hFindFile);
979 pfad->dwFileAttributes = FileData.dwFileAttributes;
980 pfad->ftCreationTime = FileData.ftCreationTime;
981 pfad->ftLastAccessTime = FileData.ftLastAccessTime;
982 pfad->ftLastWriteTime = FileData.ftLastWriteTime;
983 pfad->nFileSizeHigh = FileData.nFileSizeHigh;
984 pfad->nFileSizeLow = FileData.nFileSizeLow;
985 return TRUE;
988 static BOOL WINAPI
989 Py_GetFileAttributesExA(LPCSTR pszFile,
990 GET_FILEEX_INFO_LEVELS level,
991 LPVOID pv)
993 BOOL result;
994 LPWIN32_FILE_ATTRIBUTE_DATA pfad = pv;
995 /* First try to use the system's implementation, if that is
996 available and either succeeds to gives an error other than
997 that it isn't implemented. */
998 check_gfax();
999 if (gfaxa) {
1000 result = gfaxa(pszFile, level, pv);
1001 if (result || GetLastError() != ERROR_CALL_NOT_IMPLEMENTED)
1002 return result;
1004 /* It's either not present, or not implemented.
1005 Emulate using FindFirstFile. */
1006 if (level != GetFileExInfoStandard) {
1007 SetLastError(ERROR_INVALID_PARAMETER);
1008 return FALSE;
1010 /* Use GetFileAttributes to validate that the file name
1011 does not contain wildcards (which FindFirstFile would
1012 accept). */
1013 if (GetFileAttributesA(pszFile) == 0xFFFFFFFF)
1014 return FALSE;
1015 return attributes_from_dir(pszFile, pfad);
1018 static BOOL WINAPI
1019 Py_GetFileAttributesExW(LPCWSTR pszFile,
1020 GET_FILEEX_INFO_LEVELS level,
1021 LPVOID pv)
1023 BOOL result;
1024 LPWIN32_FILE_ATTRIBUTE_DATA pfad = pv;
1025 /* First try to use the system's implementation, if that is
1026 available and either succeeds to gives an error other than
1027 that it isn't implemented. */
1028 check_gfax();
1029 if (gfaxa) {
1030 result = gfaxw(pszFile, level, pv);
1031 if (result || GetLastError() != ERROR_CALL_NOT_IMPLEMENTED)
1032 return result;
1034 /* It's either not present, or not implemented.
1035 Emulate using FindFirstFile. */
1036 if (level != GetFileExInfoStandard) {
1037 SetLastError(ERROR_INVALID_PARAMETER);
1038 return FALSE;
1040 /* Use GetFileAttributes to validate that the file name
1041 does not contain wildcards (which FindFirstFile would
1042 accept). */
1043 if (GetFileAttributesW(pszFile) == 0xFFFFFFFF)
1044 return FALSE;
1045 return attributes_from_dir_w(pszFile, pfad);
1048 static int
1049 win32_stat(const char* path, struct win32_stat *result)
1051 WIN32_FILE_ATTRIBUTE_DATA info;
1052 int code;
1053 char *dot;
1054 /* XXX not supported on Win95 and NT 3.x */
1055 if (!Py_GetFileAttributesExA(path, GetFileExInfoStandard, &info)) {
1056 if (GetLastError() != ERROR_SHARING_VIOLATION) {
1057 /* Protocol violation: we explicitly clear errno, instead of
1058 setting it to a POSIX error. Callers should use GetLastError. */
1059 errno = 0;
1060 return -1;
1061 } else {
1062 /* Could not get attributes on open file. Fall back to
1063 reading the directory. */
1064 if (!attributes_from_dir(path, &info)) {
1065 /* Very strange. This should not fail now */
1066 errno = 0;
1067 return -1;
1071 code = attribute_data_to_stat(&info, result);
1072 if (code != 0)
1073 return code;
1074 /* Set S_IFEXEC if it is an .exe, .bat, ... */
1075 dot = strrchr(path, '.');
1076 if (dot) {
1077 if (stricmp(dot, ".bat") == 0 ||
1078 stricmp(dot, ".cmd") == 0 ||
1079 stricmp(dot, ".exe") == 0 ||
1080 stricmp(dot, ".com") == 0)
1081 result->st_mode |= 0111;
1083 return code;
1086 static int
1087 win32_wstat(const wchar_t* path, struct win32_stat *result)
1089 int code;
1090 const wchar_t *dot;
1091 WIN32_FILE_ATTRIBUTE_DATA info;
1092 /* XXX not supported on Win95 and NT 3.x */
1093 if (!Py_GetFileAttributesExW(path, GetFileExInfoStandard, &info)) {
1094 if (GetLastError() != ERROR_SHARING_VIOLATION) {
1095 /* Protocol violation: we explicitly clear errno, instead of
1096 setting it to a POSIX error. Callers should use GetLastError. */
1097 errno = 0;
1098 return -1;
1099 } else {
1100 /* Could not get attributes on open file. Fall back to
1101 reading the directory. */
1102 if (!attributes_from_dir_w(path, &info)) {
1103 /* Very strange. This should not fail now */
1104 errno = 0;
1105 return -1;
1109 code = attribute_data_to_stat(&info, result);
1110 if (code < 0)
1111 return code;
1112 /* Set IFEXEC if it is an .exe, .bat, ... */
1113 dot = wcsrchr(path, '.');
1114 if (dot) {
1115 if (_wcsicmp(dot, L".bat") == 0 ||
1116 _wcsicmp(dot, L".cmd") == 0 ||
1117 _wcsicmp(dot, L".exe") == 0 ||
1118 _wcsicmp(dot, L".com") == 0)
1119 result->st_mode |= 0111;
1121 return code;
1124 static int
1125 win32_fstat(int file_number, struct win32_stat *result)
1127 BY_HANDLE_FILE_INFORMATION info;
1128 HANDLE h;
1129 int type;
1131 h = (HANDLE)_get_osfhandle(file_number);
1133 /* Protocol violation: we explicitly clear errno, instead of
1134 setting it to a POSIX error. Callers should use GetLastError. */
1135 errno = 0;
1137 if (h == INVALID_HANDLE_VALUE) {
1138 /* This is really a C library error (invalid file handle).
1139 We set the Win32 error to the closes one matching. */
1140 SetLastError(ERROR_INVALID_HANDLE);
1141 return -1;
1143 memset(result, 0, sizeof(*result));
1145 type = GetFileType(h);
1146 if (type == FILE_TYPE_UNKNOWN) {
1147 DWORD error = GetLastError();
1148 if (error != 0) {
1149 return -1;
1151 /* else: valid but unknown file */
1154 if (type != FILE_TYPE_DISK) {
1155 if (type == FILE_TYPE_CHAR)
1156 result->st_mode = _S_IFCHR;
1157 else if (type == FILE_TYPE_PIPE)
1158 result->st_mode = _S_IFIFO;
1159 return 0;
1162 if (!GetFileInformationByHandle(h, &info)) {
1163 return -1;
1166 /* similar to stat() */
1167 result->st_mode = attributes_to_mode(info.dwFileAttributes);
1168 result->st_size = (((__int64)info.nFileSizeHigh)<<32) + info.nFileSizeLow;
1169 FILE_TIME_to_time_t_nsec(&info.ftCreationTime, &result->st_ctime, &result->st_ctime_nsec);
1170 FILE_TIME_to_time_t_nsec(&info.ftLastWriteTime, &result->st_mtime, &result->st_mtime_nsec);
1171 FILE_TIME_to_time_t_nsec(&info.ftLastAccessTime, &result->st_atime, &result->st_atime_nsec);
1172 /* specific to fstat() */
1173 result->st_nlink = info.nNumberOfLinks;
1174 result->st_ino = (((__int64)info.nFileIndexHigh)<<32) + info.nFileIndexLow;
1175 return 0;
1178 #endif /* MS_WINDOWS */
1180 PyDoc_STRVAR(stat_result__doc__,
1181 "stat_result: Result from stat or lstat.\n\n\
1182 This object may be accessed either as a tuple of\n\
1183 (mode, ino, dev, nlink, uid, gid, size, atime, mtime, ctime)\n\
1184 or via the attributes st_mode, st_ino, st_dev, st_nlink, st_uid, and so on.\n\
1186 Posix/windows: If your platform supports st_blksize, st_blocks, st_rdev,\n\
1187 or st_flags, they are available as attributes only.\n\
1189 See os.stat for more information.");
1191 static PyStructSequence_Field stat_result_fields[] = {
1192 {"st_mode", "protection bits"},
1193 {"st_ino", "inode"},
1194 {"st_dev", "device"},
1195 {"st_nlink", "number of hard links"},
1196 {"st_uid", "user ID of owner"},
1197 {"st_gid", "group ID of owner"},
1198 {"st_size", "total size, in bytes"},
1199 /* The NULL is replaced with PyStructSequence_UnnamedField later. */
1200 {NULL, "integer time of last access"},
1201 {NULL, "integer time of last modification"},
1202 {NULL, "integer time of last change"},
1203 {"st_atime", "time of last access"},
1204 {"st_mtime", "time of last modification"},
1205 {"st_ctime", "time of last change"},
1206 #ifdef HAVE_STRUCT_STAT_ST_BLKSIZE
1207 {"st_blksize", "blocksize for filesystem I/O"},
1208 #endif
1209 #ifdef HAVE_STRUCT_STAT_ST_BLOCKS
1210 {"st_blocks", "number of blocks allocated"},
1211 #endif
1212 #ifdef HAVE_STRUCT_STAT_ST_RDEV
1213 {"st_rdev", "device type (if inode device)"},
1214 #endif
1215 #ifdef HAVE_STRUCT_STAT_ST_FLAGS
1216 {"st_flags", "user defined flags for file"},
1217 #endif
1218 #ifdef HAVE_STRUCT_STAT_ST_GEN
1219 {"st_gen", "generation number"},
1220 #endif
1221 #ifdef HAVE_STRUCT_STAT_ST_BIRTHTIME
1222 {"st_birthtime", "time of creation"},
1223 #endif
1227 #ifdef HAVE_STRUCT_STAT_ST_BLKSIZE
1228 #define ST_BLKSIZE_IDX 13
1229 #else
1230 #define ST_BLKSIZE_IDX 12
1231 #endif
1233 #ifdef HAVE_STRUCT_STAT_ST_BLOCKS
1234 #define ST_BLOCKS_IDX (ST_BLKSIZE_IDX+1)
1235 #else
1236 #define ST_BLOCKS_IDX ST_BLKSIZE_IDX
1237 #endif
1239 #ifdef HAVE_STRUCT_STAT_ST_RDEV
1240 #define ST_RDEV_IDX (ST_BLOCKS_IDX+1)
1241 #else
1242 #define ST_RDEV_IDX ST_BLOCKS_IDX
1243 #endif
1245 #ifdef HAVE_STRUCT_STAT_ST_FLAGS
1246 #define ST_FLAGS_IDX (ST_RDEV_IDX+1)
1247 #else
1248 #define ST_FLAGS_IDX ST_RDEV_IDX
1249 #endif
1251 #ifdef HAVE_STRUCT_STAT_ST_GEN
1252 #define ST_GEN_IDX (ST_FLAGS_IDX+1)
1253 #else
1254 #define ST_GEN_IDX ST_FLAGS_IDX
1255 #endif
1257 #ifdef HAVE_STRUCT_STAT_ST_BIRTHTIME
1258 #define ST_BIRTHTIME_IDX (ST_GEN_IDX+1)
1259 #else
1260 #define ST_BIRTHTIME_IDX ST_GEN_IDX
1261 #endif
1263 static PyStructSequence_Desc stat_result_desc = {
1264 "stat_result", /* name */
1265 stat_result__doc__, /* doc */
1266 stat_result_fields,
1270 PyDoc_STRVAR(statvfs_result__doc__,
1271 "statvfs_result: Result from statvfs or fstatvfs.\n\n\
1272 This object may be accessed either as a tuple of\n\
1273 (bsize, frsize, blocks, bfree, bavail, files, ffree, favail, flag, namemax),\n\
1274 or via the attributes f_bsize, f_frsize, f_blocks, f_bfree, and so on.\n\
1276 See os.statvfs for more information.");
1278 static PyStructSequence_Field statvfs_result_fields[] = {
1279 {"f_bsize", },
1280 {"f_frsize", },
1281 {"f_blocks", },
1282 {"f_bfree", },
1283 {"f_bavail", },
1284 {"f_files", },
1285 {"f_ffree", },
1286 {"f_favail", },
1287 {"f_flag", },
1288 {"f_namemax",},
1292 static PyStructSequence_Desc statvfs_result_desc = {
1293 "statvfs_result", /* name */
1294 statvfs_result__doc__, /* doc */
1295 statvfs_result_fields,
1299 static int initialized;
1300 static PyTypeObject StatResultType;
1301 static PyTypeObject StatVFSResultType;
1302 static newfunc structseq_new;
1304 static PyObject *
1305 statresult_new(PyTypeObject *type, PyObject *args, PyObject *kwds)
1307 PyStructSequence *result;
1308 int i;
1310 result = (PyStructSequence*)structseq_new(type, args, kwds);
1311 if (!result)
1312 return NULL;
1313 /* If we have been initialized from a tuple,
1314 st_?time might be set to None. Initialize it
1315 from the int slots. */
1316 for (i = 7; i <= 9; i++) {
1317 if (result->ob_item[i+3] == Py_None) {
1318 Py_DECREF(Py_None);
1319 Py_INCREF(result->ob_item[i]);
1320 result->ob_item[i+3] = result->ob_item[i];
1323 return (PyObject*)result;
1328 /* If true, st_?time is float. */
1329 static int _stat_float_times = 1;
1331 PyDoc_STRVAR(stat_float_times__doc__,
1332 "stat_float_times([newval]) -> oldval\n\n\
1333 Determine whether os.[lf]stat represents time stamps as float objects.\n\
1334 If newval is True, future calls to stat() return floats, if it is False,\n\
1335 future calls return ints. \n\
1336 If newval is omitted, return the current setting.\n");
1338 static PyObject*
1339 stat_float_times(PyObject* self, PyObject *args)
1341 int newval = -1;
1342 if (!PyArg_ParseTuple(args, "|i:stat_float_times", &newval))
1343 return NULL;
1344 if (newval == -1)
1345 /* Return old value */
1346 return PyBool_FromLong(_stat_float_times);
1347 _stat_float_times = newval;
1348 Py_INCREF(Py_None);
1349 return Py_None;
1352 static void
1353 fill_time(PyObject *v, int index, time_t sec, unsigned long nsec)
1355 PyObject *fval,*ival;
1356 #if SIZEOF_TIME_T > SIZEOF_LONG
1357 ival = PyLong_FromLongLong((PY_LONG_LONG)sec);
1358 #else
1359 ival = PyInt_FromLong((long)sec);
1360 #endif
1361 if (!ival)
1362 return;
1363 if (_stat_float_times) {
1364 fval = PyFloat_FromDouble(sec + 1e-9*nsec);
1365 } else {
1366 fval = ival;
1367 Py_INCREF(fval);
1369 PyStructSequence_SET_ITEM(v, index, ival);
1370 PyStructSequence_SET_ITEM(v, index+3, fval);
1373 /* pack a system stat C structure into the Python stat tuple
1374 (used by posix_stat() and posix_fstat()) */
1375 static PyObject*
1376 _pystat_fromstructstat(STRUCT_STAT *st)
1378 unsigned long ansec, mnsec, cnsec;
1379 PyObject *v = PyStructSequence_New(&StatResultType);
1380 if (v == NULL)
1381 return NULL;
1383 PyStructSequence_SET_ITEM(v, 0, PyInt_FromLong((long)st->st_mode));
1384 #ifdef HAVE_LARGEFILE_SUPPORT
1385 PyStructSequence_SET_ITEM(v, 1,
1386 PyLong_FromLongLong((PY_LONG_LONG)st->st_ino));
1387 #else
1388 PyStructSequence_SET_ITEM(v, 1, PyInt_FromLong((long)st->st_ino));
1389 #endif
1390 #if defined(HAVE_LONG_LONG) && !defined(MS_WINDOWS)
1391 PyStructSequence_SET_ITEM(v, 2,
1392 PyLong_FromLongLong((PY_LONG_LONG)st->st_dev));
1393 #else
1394 PyStructSequence_SET_ITEM(v, 2, PyInt_FromLong((long)st->st_dev));
1395 #endif
1396 PyStructSequence_SET_ITEM(v, 3, PyInt_FromLong((long)st->st_nlink));
1397 PyStructSequence_SET_ITEM(v, 4, PyInt_FromLong((long)st->st_uid));
1398 PyStructSequence_SET_ITEM(v, 5, PyInt_FromLong((long)st->st_gid));
1399 #ifdef HAVE_LARGEFILE_SUPPORT
1400 PyStructSequence_SET_ITEM(v, 6,
1401 PyLong_FromLongLong((PY_LONG_LONG)st->st_size));
1402 #else
1403 PyStructSequence_SET_ITEM(v, 6, PyInt_FromLong(st->st_size));
1404 #endif
1406 #if defined(HAVE_STAT_TV_NSEC)
1407 ansec = st->st_atim.tv_nsec;
1408 mnsec = st->st_mtim.tv_nsec;
1409 cnsec = st->st_ctim.tv_nsec;
1410 #elif defined(HAVE_STAT_TV_NSEC2)
1411 ansec = st->st_atimespec.tv_nsec;
1412 mnsec = st->st_mtimespec.tv_nsec;
1413 cnsec = st->st_ctimespec.tv_nsec;
1414 #elif defined(HAVE_STAT_NSEC)
1415 ansec = st->st_atime_nsec;
1416 mnsec = st->st_mtime_nsec;
1417 cnsec = st->st_ctime_nsec;
1418 #else
1419 ansec = mnsec = cnsec = 0;
1420 #endif
1421 fill_time(v, 7, st->st_atime, ansec);
1422 fill_time(v, 8, st->st_mtime, mnsec);
1423 fill_time(v, 9, st->st_ctime, cnsec);
1425 #ifdef HAVE_STRUCT_STAT_ST_BLKSIZE
1426 PyStructSequence_SET_ITEM(v, ST_BLKSIZE_IDX,
1427 PyInt_FromLong((long)st->st_blksize));
1428 #endif
1429 #ifdef HAVE_STRUCT_STAT_ST_BLOCKS
1430 PyStructSequence_SET_ITEM(v, ST_BLOCKS_IDX,
1431 PyInt_FromLong((long)st->st_blocks));
1432 #endif
1433 #ifdef HAVE_STRUCT_STAT_ST_RDEV
1434 PyStructSequence_SET_ITEM(v, ST_RDEV_IDX,
1435 PyInt_FromLong((long)st->st_rdev));
1436 #endif
1437 #ifdef HAVE_STRUCT_STAT_ST_GEN
1438 PyStructSequence_SET_ITEM(v, ST_GEN_IDX,
1439 PyInt_FromLong((long)st->st_gen));
1440 #endif
1441 #ifdef HAVE_STRUCT_STAT_ST_BIRTHTIME
1443 PyObject *val;
1444 unsigned long bsec,bnsec;
1445 bsec = (long)st->st_birthtime;
1446 #ifdef HAVE_STAT_TV_NSEC2
1447 bnsec = st->st_birthtimespec.tv_nsec;
1448 #else
1449 bnsec = 0;
1450 #endif
1451 if (_stat_float_times) {
1452 val = PyFloat_FromDouble(bsec + 1e-9*bnsec);
1453 } else {
1454 val = PyInt_FromLong((long)bsec);
1456 PyStructSequence_SET_ITEM(v, ST_BIRTHTIME_IDX,
1457 val);
1459 #endif
1460 #ifdef HAVE_STRUCT_STAT_ST_FLAGS
1461 PyStructSequence_SET_ITEM(v, ST_FLAGS_IDX,
1462 PyInt_FromLong((long)st->st_flags));
1463 #endif
1465 if (PyErr_Occurred()) {
1466 Py_DECREF(v);
1467 return NULL;
1470 return v;
1473 #ifdef MS_WINDOWS
1475 /* IsUNCRoot -- test whether the supplied path is of the form \\SERVER\SHARE\,
1476 where / can be used in place of \ and the trailing slash is optional.
1477 Both SERVER and SHARE must have at least one character.
1480 #define ISSLASHA(c) ((c) == '\\' || (c) == '/')
1481 #define ISSLASHW(c) ((c) == L'\\' || (c) == L'/')
1482 #ifndef ARRAYSIZE
1483 #define ARRAYSIZE(a) (sizeof(a) / sizeof(a[0]))
1484 #endif
1486 static BOOL
1487 IsUNCRootA(char *path, int pathlen)
1489 #define ISSLASH ISSLASHA
1491 int i, share;
1493 if (pathlen < 5 || !ISSLASH(path[0]) || !ISSLASH(path[1]))
1494 /* minimum UNCRoot is \\x\y */
1495 return FALSE;
1496 for (i = 2; i < pathlen ; i++)
1497 if (ISSLASH(path[i])) break;
1498 if (i == 2 || i == pathlen)
1499 /* do not allow \\\SHARE or \\SERVER */
1500 return FALSE;
1501 share = i+1;
1502 for (i = share; i < pathlen; i++)
1503 if (ISSLASH(path[i])) break;
1504 return (i != share && (i == pathlen || i == pathlen-1));
1506 #undef ISSLASH
1509 #ifdef Py_WIN_WIDE_FILENAMES
1510 static BOOL
1511 IsUNCRootW(Py_UNICODE *path, int pathlen)
1513 #define ISSLASH ISSLASHW
1515 int i, share;
1517 if (pathlen < 5 || !ISSLASH(path[0]) || !ISSLASH(path[1]))
1518 /* minimum UNCRoot is \\x\y */
1519 return FALSE;
1520 for (i = 2; i < pathlen ; i++)
1521 if (ISSLASH(path[i])) break;
1522 if (i == 2 || i == pathlen)
1523 /* do not allow \\\SHARE or \\SERVER */
1524 return FALSE;
1525 share = i+1;
1526 for (i = share; i < pathlen; i++)
1527 if (ISSLASH(path[i])) break;
1528 return (i != share && (i == pathlen || i == pathlen-1));
1530 #undef ISSLASH
1532 #endif /* Py_WIN_WIDE_FILENAMES */
1533 #endif /* MS_WINDOWS */
1535 static PyObject *
1536 posix_do_stat(PyObject *self, PyObject *args,
1537 char *format,
1538 #ifdef __VMS
1539 int (*statfunc)(const char *, STRUCT_STAT *, ...),
1540 #else
1541 int (*statfunc)(const char *, STRUCT_STAT *),
1542 #endif
1543 char *wformat,
1544 int (*wstatfunc)(const Py_UNICODE *, STRUCT_STAT *))
1546 STRUCT_STAT st;
1547 char *path = NULL; /* pass this to stat; do not free() it */
1548 char *pathfree = NULL; /* this memory must be free'd */
1549 int res;
1550 PyObject *result;
1552 #ifdef Py_WIN_WIDE_FILENAMES
1553 /* If on wide-character-capable OS see if argument
1554 is Unicode and if so use wide API. */
1555 if (unicode_file_names()) {
1556 PyUnicodeObject *po;
1557 if (PyArg_ParseTuple(args, wformat, &po)) {
1558 Py_UNICODE *wpath = PyUnicode_AS_UNICODE(po);
1560 Py_BEGIN_ALLOW_THREADS
1561 /* PyUnicode_AS_UNICODE result OK without
1562 thread lock as it is a simple dereference. */
1563 res = wstatfunc(wpath, &st);
1564 Py_END_ALLOW_THREADS
1566 if (res != 0)
1567 return win32_error_unicode("stat", wpath);
1568 return _pystat_fromstructstat(&st);
1570 /* Drop the argument parsing error as narrow strings
1571 are also valid. */
1572 PyErr_Clear();
1574 #endif
1576 if (!PyArg_ParseTuple(args, format,
1577 Py_FileSystemDefaultEncoding, &path))
1578 return NULL;
1579 pathfree = path;
1581 Py_BEGIN_ALLOW_THREADS
1582 res = (*statfunc)(path, &st);
1583 Py_END_ALLOW_THREADS
1585 if (res != 0) {
1586 #ifdef MS_WINDOWS
1587 result = win32_error("stat", pathfree);
1588 #else
1589 result = posix_error_with_filename(pathfree);
1590 #endif
1592 else
1593 result = _pystat_fromstructstat(&st);
1595 PyMem_Free(pathfree);
1596 return result;
1599 /* POSIX methods */
1601 PyDoc_STRVAR(posix_access__doc__,
1602 "access(path, mode) -> True if granted, False otherwise\n\n\
1603 Use the real uid/gid to test for access to a path. Note that most\n\
1604 operations will use the effective uid/gid, therefore this routine can\n\
1605 be used in a suid/sgid environment to test if the invoking user has the\n\
1606 specified access to the path. The mode argument can be F_OK to test\n\
1607 existence, or the inclusive-OR of R_OK, W_OK, and X_OK.");
1609 static PyObject *
1610 posix_access(PyObject *self, PyObject *args)
1612 char *path;
1613 int mode;
1615 #ifdef Py_WIN_WIDE_FILENAMES
1616 DWORD attr;
1617 if (unicode_file_names()) {
1618 PyUnicodeObject *po;
1619 if (PyArg_ParseTuple(args, "Ui:access", &po, &mode)) {
1620 Py_BEGIN_ALLOW_THREADS
1621 /* PyUnicode_AS_UNICODE OK without thread lock as
1622 it is a simple dereference. */
1623 attr = GetFileAttributesW(PyUnicode_AS_UNICODE(po));
1624 Py_END_ALLOW_THREADS
1625 goto finish;
1627 /* Drop the argument parsing error as narrow strings
1628 are also valid. */
1629 PyErr_Clear();
1631 if (!PyArg_ParseTuple(args, "eti:access",
1632 Py_FileSystemDefaultEncoding, &path, &mode))
1633 return 0;
1634 Py_BEGIN_ALLOW_THREADS
1635 attr = GetFileAttributesA(path);
1636 Py_END_ALLOW_THREADS
1637 PyMem_Free(path);
1638 finish:
1639 if (attr == 0xFFFFFFFF)
1640 /* File does not exist, or cannot read attributes */
1641 return PyBool_FromLong(0);
1642 /* Access is possible if either write access wasn't requested, or
1643 the file isn't read-only, or if it's a directory, as there are
1644 no read-only directories on Windows. */
1645 return PyBool_FromLong(!(mode & 2)
1646 || !(attr & FILE_ATTRIBUTE_READONLY)
1647 || (attr & FILE_ATTRIBUTE_DIRECTORY));
1648 #else
1649 int res;
1650 if (!PyArg_ParseTuple(args, "eti:access",
1651 Py_FileSystemDefaultEncoding, &path, &mode))
1652 return NULL;
1653 Py_BEGIN_ALLOW_THREADS
1654 res = access(path, mode);
1655 Py_END_ALLOW_THREADS
1656 PyMem_Free(path);
1657 return PyBool_FromLong(res == 0);
1658 #endif
1661 #ifndef F_OK
1662 #define F_OK 0
1663 #endif
1664 #ifndef R_OK
1665 #define R_OK 4
1666 #endif
1667 #ifndef W_OK
1668 #define W_OK 2
1669 #endif
1670 #ifndef X_OK
1671 #define X_OK 1
1672 #endif
1674 #ifdef HAVE_TTYNAME
1675 PyDoc_STRVAR(posix_ttyname__doc__,
1676 "ttyname(fd) -> string\n\n\
1677 Return the name of the terminal device connected to 'fd'.");
1679 static PyObject *
1680 posix_ttyname(PyObject *self, PyObject *args)
1682 int id;
1683 char *ret;
1685 if (!PyArg_ParseTuple(args, "i:ttyname", &id))
1686 return NULL;
1688 #if defined(__VMS)
1689 /* file descriptor 0 only, the default input device (stdin) */
1690 if (id == 0) {
1691 ret = ttyname();
1693 else {
1694 ret = NULL;
1696 #else
1697 ret = ttyname(id);
1698 #endif
1699 if (ret == NULL)
1700 return posix_error();
1701 return PyString_FromString(ret);
1703 #endif
1705 #ifdef HAVE_CTERMID
1706 PyDoc_STRVAR(posix_ctermid__doc__,
1707 "ctermid() -> string\n\n\
1708 Return the name of the controlling terminal for this process.");
1710 static PyObject *
1711 posix_ctermid(PyObject *self, PyObject *noargs)
1713 char *ret;
1714 char buffer[L_ctermid];
1716 #ifdef USE_CTERMID_R
1717 ret = ctermid_r(buffer);
1718 #else
1719 ret = ctermid(buffer);
1720 #endif
1721 if (ret == NULL)
1722 return posix_error();
1723 return PyString_FromString(buffer);
1725 #endif
1727 PyDoc_STRVAR(posix_chdir__doc__,
1728 "chdir(path)\n\n\
1729 Change the current working directory to the specified path.");
1731 static PyObject *
1732 posix_chdir(PyObject *self, PyObject *args)
1734 #ifdef MS_WINDOWS
1735 return win32_1str(args, "chdir", "s:chdir", win32_chdir, "U:chdir", win32_wchdir);
1736 #elif defined(PYOS_OS2) && defined(PYCC_GCC)
1737 return posix_1str(args, "et:chdir", _chdir2);
1738 #elif defined(__VMS)
1739 return posix_1str(args, "et:chdir", (int (*)(const char *))chdir);
1740 #else
1741 return posix_1str(args, "et:chdir", chdir);
1742 #endif
1745 #ifdef HAVE_FCHDIR
1746 PyDoc_STRVAR(posix_fchdir__doc__,
1747 "fchdir(fildes)\n\n\
1748 Change to the directory of the given file descriptor. fildes must be\n\
1749 opened on a directory, not a file.");
1751 static PyObject *
1752 posix_fchdir(PyObject *self, PyObject *fdobj)
1754 return posix_fildes(fdobj, fchdir);
1756 #endif /* HAVE_FCHDIR */
1759 PyDoc_STRVAR(posix_chmod__doc__,
1760 "chmod(path, mode)\n\n\
1761 Change the access permissions of a file.");
1763 static PyObject *
1764 posix_chmod(PyObject *self, PyObject *args)
1766 char *path = NULL;
1767 int i;
1768 int res;
1769 #ifdef Py_WIN_WIDE_FILENAMES
1770 DWORD attr;
1771 if (unicode_file_names()) {
1772 PyUnicodeObject *po;
1773 if (PyArg_ParseTuple(args, "Ui|:chmod", &po, &i)) {
1774 Py_BEGIN_ALLOW_THREADS
1775 attr = GetFileAttributesW(PyUnicode_AS_UNICODE(po));
1776 if (attr != 0xFFFFFFFF) {
1777 if (i & _S_IWRITE)
1778 attr &= ~FILE_ATTRIBUTE_READONLY;
1779 else
1780 attr |= FILE_ATTRIBUTE_READONLY;
1781 res = SetFileAttributesW(PyUnicode_AS_UNICODE(po), attr);
1783 else
1784 res = 0;
1785 Py_END_ALLOW_THREADS
1786 if (!res)
1787 return win32_error_unicode("chmod",
1788 PyUnicode_AS_UNICODE(po));
1789 Py_INCREF(Py_None);
1790 return Py_None;
1792 /* Drop the argument parsing error as narrow strings
1793 are also valid. */
1794 PyErr_Clear();
1796 if (!PyArg_ParseTuple(args, "eti:chmod", Py_FileSystemDefaultEncoding,
1797 &path, &i))
1798 return NULL;
1799 Py_BEGIN_ALLOW_THREADS
1800 attr = GetFileAttributesA(path);
1801 if (attr != 0xFFFFFFFF) {
1802 if (i & _S_IWRITE)
1803 attr &= ~FILE_ATTRIBUTE_READONLY;
1804 else
1805 attr |= FILE_ATTRIBUTE_READONLY;
1806 res = SetFileAttributesA(path, attr);
1808 else
1809 res = 0;
1810 Py_END_ALLOW_THREADS
1811 if (!res) {
1812 win32_error("chmod", path);
1813 PyMem_Free(path);
1814 return NULL;
1816 PyMem_Free(path);
1817 Py_INCREF(Py_None);
1818 return Py_None;
1819 #else /* Py_WIN_WIDE_FILENAMES */
1820 if (!PyArg_ParseTuple(args, "eti:chmod", Py_FileSystemDefaultEncoding,
1821 &path, &i))
1822 return NULL;
1823 Py_BEGIN_ALLOW_THREADS
1824 res = chmod(path, i);
1825 Py_END_ALLOW_THREADS
1826 if (res < 0)
1827 return posix_error_with_allocated_filename(path);
1828 PyMem_Free(path);
1829 Py_INCREF(Py_None);
1830 return Py_None;
1831 #endif
1834 #ifdef HAVE_FCHMOD
1835 PyDoc_STRVAR(posix_fchmod__doc__,
1836 "fchmod(fd, mode)\n\n\
1837 Change the access permissions of the file given by file\n\
1838 descriptor fd.");
1840 static PyObject *
1841 posix_fchmod(PyObject *self, PyObject *args)
1843 int fd, mode, res;
1844 if (!PyArg_ParseTuple(args, "ii:fchmod", &fd, &mode))
1845 return NULL;
1846 Py_BEGIN_ALLOW_THREADS
1847 res = fchmod(fd, mode);
1848 Py_END_ALLOW_THREADS
1849 if (res < 0)
1850 return posix_error();
1851 Py_RETURN_NONE;
1853 #endif /* HAVE_FCHMOD */
1855 #ifdef HAVE_LCHMOD
1856 PyDoc_STRVAR(posix_lchmod__doc__,
1857 "lchmod(path, mode)\n\n\
1858 Change the access permissions of a file. If path is a symlink, this\n\
1859 affects the link itself rather than the target.");
1861 static PyObject *
1862 posix_lchmod(PyObject *self, PyObject *args)
1864 char *path = NULL;
1865 int i;
1866 int res;
1867 if (!PyArg_ParseTuple(args, "eti:lchmod", Py_FileSystemDefaultEncoding,
1868 &path, &i))
1869 return NULL;
1870 Py_BEGIN_ALLOW_THREADS
1871 res = lchmod(path, i);
1872 Py_END_ALLOW_THREADS
1873 if (res < 0)
1874 return posix_error_with_allocated_filename(path);
1875 PyMem_Free(path);
1876 Py_RETURN_NONE;
1878 #endif /* HAVE_LCHMOD */
1881 #ifdef HAVE_CHFLAGS
1882 PyDoc_STRVAR(posix_chflags__doc__,
1883 "chflags(path, flags)\n\n\
1884 Set file flags.");
1886 static PyObject *
1887 posix_chflags(PyObject *self, PyObject *args)
1889 char *path;
1890 unsigned long flags;
1891 int res;
1892 if (!PyArg_ParseTuple(args, "etk:chflags",
1893 Py_FileSystemDefaultEncoding, &path, &flags))
1894 return NULL;
1895 Py_BEGIN_ALLOW_THREADS
1896 res = chflags(path, flags);
1897 Py_END_ALLOW_THREADS
1898 if (res < 0)
1899 return posix_error_with_allocated_filename(path);
1900 PyMem_Free(path);
1901 Py_INCREF(Py_None);
1902 return Py_None;
1904 #endif /* HAVE_CHFLAGS */
1906 #ifdef HAVE_LCHFLAGS
1907 PyDoc_STRVAR(posix_lchflags__doc__,
1908 "lchflags(path, flags)\n\n\
1909 Set file flags.\n\
1910 This function will not follow symbolic links.");
1912 static PyObject *
1913 posix_lchflags(PyObject *self, PyObject *args)
1915 char *path;
1916 unsigned long flags;
1917 int res;
1918 if (!PyArg_ParseTuple(args, "etk:lchflags",
1919 Py_FileSystemDefaultEncoding, &path, &flags))
1920 return NULL;
1921 Py_BEGIN_ALLOW_THREADS
1922 res = lchflags(path, flags);
1923 Py_END_ALLOW_THREADS
1924 if (res < 0)
1925 return posix_error_with_allocated_filename(path);
1926 PyMem_Free(path);
1927 Py_INCREF(Py_None);
1928 return Py_None;
1930 #endif /* HAVE_LCHFLAGS */
1932 #ifdef HAVE_CHROOT
1933 PyDoc_STRVAR(posix_chroot__doc__,
1934 "chroot(path)\n\n\
1935 Change root directory to path.");
1937 static PyObject *
1938 posix_chroot(PyObject *self, PyObject *args)
1940 return posix_1str(args, "et:chroot", chroot);
1942 #endif
1944 #ifdef HAVE_FSYNC
1945 PyDoc_STRVAR(posix_fsync__doc__,
1946 "fsync(fildes)\n\n\
1947 force write of file with filedescriptor to disk.");
1949 static PyObject *
1950 posix_fsync(PyObject *self, PyObject *fdobj)
1952 return posix_fildes(fdobj, fsync);
1954 #endif /* HAVE_FSYNC */
1956 #ifdef HAVE_FDATASYNC
1958 #ifdef __hpux
1959 extern int fdatasync(int); /* On HP-UX, in libc but not in unistd.h */
1960 #endif
1962 PyDoc_STRVAR(posix_fdatasync__doc__,
1963 "fdatasync(fildes)\n\n\
1964 force write of file with filedescriptor to disk.\n\
1965 does not force update of metadata.");
1967 static PyObject *
1968 posix_fdatasync(PyObject *self, PyObject *fdobj)
1970 return posix_fildes(fdobj, fdatasync);
1972 #endif /* HAVE_FDATASYNC */
1975 #ifdef HAVE_CHOWN
1976 PyDoc_STRVAR(posix_chown__doc__,
1977 "chown(path, uid, gid)\n\n\
1978 Change the owner and group id of path to the numeric uid and gid.");
1980 static PyObject *
1981 posix_chown(PyObject *self, PyObject *args)
1983 char *path = NULL;
1984 long uid, gid;
1985 int res;
1986 if (!PyArg_ParseTuple(args, "etll:chown",
1987 Py_FileSystemDefaultEncoding, &path,
1988 &uid, &gid))
1989 return NULL;
1990 Py_BEGIN_ALLOW_THREADS
1991 res = chown(path, (uid_t) uid, (gid_t) gid);
1992 Py_END_ALLOW_THREADS
1993 if (res < 0)
1994 return posix_error_with_allocated_filename(path);
1995 PyMem_Free(path);
1996 Py_INCREF(Py_None);
1997 return Py_None;
1999 #endif /* HAVE_CHOWN */
2001 #ifdef HAVE_FCHOWN
2002 PyDoc_STRVAR(posix_fchown__doc__,
2003 "fchown(fd, uid, gid)\n\n\
2004 Change the owner and group id of the file given by file descriptor\n\
2005 fd to the numeric uid and gid.");
2007 static PyObject *
2008 posix_fchown(PyObject *self, PyObject *args)
2010 int fd, uid, gid;
2011 int res;
2012 if (!PyArg_ParseTuple(args, "iii:chown", &fd, &uid, &gid))
2013 return NULL;
2014 Py_BEGIN_ALLOW_THREADS
2015 res = fchown(fd, (uid_t) uid, (gid_t) gid);
2016 Py_END_ALLOW_THREADS
2017 if (res < 0)
2018 return posix_error();
2019 Py_RETURN_NONE;
2021 #endif /* HAVE_FCHOWN */
2023 #ifdef HAVE_LCHOWN
2024 PyDoc_STRVAR(posix_lchown__doc__,
2025 "lchown(path, uid, gid)\n\n\
2026 Change the owner and group id of path to the numeric uid and gid.\n\
2027 This function will not follow symbolic links.");
2029 static PyObject *
2030 posix_lchown(PyObject *self, PyObject *args)
2032 char *path = NULL;
2033 int uid, gid;
2034 int res;
2035 if (!PyArg_ParseTuple(args, "etii:lchown",
2036 Py_FileSystemDefaultEncoding, &path,
2037 &uid, &gid))
2038 return NULL;
2039 Py_BEGIN_ALLOW_THREADS
2040 res = lchown(path, (uid_t) uid, (gid_t) gid);
2041 Py_END_ALLOW_THREADS
2042 if (res < 0)
2043 return posix_error_with_allocated_filename(path);
2044 PyMem_Free(path);
2045 Py_INCREF(Py_None);
2046 return Py_None;
2048 #endif /* HAVE_LCHOWN */
2051 #ifdef HAVE_GETCWD
2052 PyDoc_STRVAR(posix_getcwd__doc__,
2053 "getcwd() -> path\n\n\
2054 Return a string representing the current working directory.");
2056 static PyObject *
2057 posix_getcwd(PyObject *self, PyObject *noargs)
2059 int bufsize_incr = 1024;
2060 int bufsize = 0;
2061 char *tmpbuf = NULL;
2062 char *res = NULL;
2063 PyObject *dynamic_return;
2065 Py_BEGIN_ALLOW_THREADS
2066 do {
2067 bufsize = bufsize + bufsize_incr;
2068 tmpbuf = malloc(bufsize);
2069 if (tmpbuf == NULL) {
2070 break;
2072 #if defined(PYOS_OS2) && defined(PYCC_GCC)
2073 res = _getcwd2(tmpbuf, bufsize);
2074 #else
2075 res = getcwd(tmpbuf, bufsize);
2076 #endif
2078 if (res == NULL) {
2079 free(tmpbuf);
2081 } while ((res == NULL) && (errno == ERANGE));
2082 Py_END_ALLOW_THREADS
2084 if (res == NULL)
2085 return posix_error();
2087 dynamic_return = PyString_FromString(tmpbuf);
2088 free(tmpbuf);
2090 return dynamic_return;
2093 #ifdef Py_USING_UNICODE
2094 PyDoc_STRVAR(posix_getcwdu__doc__,
2095 "getcwdu() -> path\n\n\
2096 Return a unicode string representing the current working directory.");
2098 static PyObject *
2099 posix_getcwdu(PyObject *self, PyObject *noargs)
2101 char buf[1026];
2102 char *res;
2104 #ifdef Py_WIN_WIDE_FILENAMES
2105 DWORD len;
2106 if (unicode_file_names()) {
2107 wchar_t wbuf[1026];
2108 wchar_t *wbuf2 = wbuf;
2109 PyObject *resobj;
2110 Py_BEGIN_ALLOW_THREADS
2111 len = GetCurrentDirectoryW(sizeof wbuf/ sizeof wbuf[0], wbuf);
2112 /* If the buffer is large enough, len does not include the
2113 terminating \0. If the buffer is too small, len includes
2114 the space needed for the terminator. */
2115 if (len >= sizeof wbuf/ sizeof wbuf[0]) {
2116 wbuf2 = malloc(len * sizeof(wchar_t));
2117 if (wbuf2)
2118 len = GetCurrentDirectoryW(len, wbuf2);
2120 Py_END_ALLOW_THREADS
2121 if (!wbuf2) {
2122 PyErr_NoMemory();
2123 return NULL;
2125 if (!len) {
2126 if (wbuf2 != wbuf) free(wbuf2);
2127 return win32_error("getcwdu", NULL);
2129 resobj = PyUnicode_FromWideChar(wbuf2, len);
2130 if (wbuf2 != wbuf) free(wbuf2);
2131 return resobj;
2133 #endif
2135 Py_BEGIN_ALLOW_THREADS
2136 #if defined(PYOS_OS2) && defined(PYCC_GCC)
2137 res = _getcwd2(buf, sizeof buf);
2138 #else
2139 res = getcwd(buf, sizeof buf);
2140 #endif
2141 Py_END_ALLOW_THREADS
2142 if (res == NULL)
2143 return posix_error();
2144 return PyUnicode_Decode(buf, strlen(buf), Py_FileSystemDefaultEncoding,"strict");
2146 #endif
2147 #endif
2150 #ifdef HAVE_LINK
2151 PyDoc_STRVAR(posix_link__doc__,
2152 "link(src, dst)\n\n\
2153 Create a hard link to a file.");
2155 static PyObject *
2156 posix_link(PyObject *self, PyObject *args)
2158 return posix_2str(args, "etet:link", link);
2160 #endif /* HAVE_LINK */
2163 PyDoc_STRVAR(posix_listdir__doc__,
2164 "listdir(path) -> list_of_strings\n\n\
2165 Return a list containing the names of the entries in the directory.\n\
2167 path: path of directory to list\n\
2169 The list is in arbitrary order. It does not include the special\n\
2170 entries '.' and '..' even if they are present in the directory.");
2172 static PyObject *
2173 posix_listdir(PyObject *self, PyObject *args)
2175 /* XXX Should redo this putting the (now four) versions of opendir
2176 in separate files instead of having them all here... */
2177 #if defined(MS_WINDOWS) && !defined(HAVE_OPENDIR)
2179 PyObject *d, *v;
2180 HANDLE hFindFile;
2181 BOOL result;
2182 WIN32_FIND_DATA FileData;
2183 char namebuf[MAX_PATH+5]; /* Overallocate for \\*.*\0 */
2184 char *bufptr = namebuf;
2185 Py_ssize_t len = sizeof(namebuf)-5; /* only claim to have space for MAX_PATH */
2187 #ifdef Py_WIN_WIDE_FILENAMES
2188 /* If on wide-character-capable OS see if argument
2189 is Unicode and if so use wide API. */
2190 if (unicode_file_names()) {
2191 PyObject *po;
2192 if (PyArg_ParseTuple(args, "U:listdir", &po)) {
2193 WIN32_FIND_DATAW wFileData;
2194 Py_UNICODE *wnamebuf;
2195 Py_UNICODE wch;
2196 /* Overallocate for \\*.*\0 */
2197 len = PyUnicode_GET_SIZE(po);
2198 wnamebuf = malloc((len + 5) * sizeof(wchar_t));
2199 if (!wnamebuf) {
2200 PyErr_NoMemory();
2201 return NULL;
2203 wcscpy(wnamebuf, PyUnicode_AS_UNICODE(po));
2204 wch = len > 0 ? wnamebuf[len-1] : '\0';
2205 if (wch != L'/' && wch != L'\\' && wch != L':')
2206 wnamebuf[len++] = L'\\';
2207 wcscpy(wnamebuf + len, L"*.*");
2208 if ((d = PyList_New(0)) == NULL) {
2209 free(wnamebuf);
2210 return NULL;
2212 hFindFile = FindFirstFileW(wnamebuf, &wFileData);
2213 if (hFindFile == INVALID_HANDLE_VALUE) {
2214 int error = GetLastError();
2215 if (error == ERROR_FILE_NOT_FOUND) {
2216 free(wnamebuf);
2217 return d;
2219 Py_DECREF(d);
2220 win32_error_unicode("FindFirstFileW", wnamebuf);
2221 free(wnamebuf);
2222 return NULL;
2224 do {
2225 /* Skip over . and .. */
2226 if (wcscmp(wFileData.cFileName, L".") != 0 &&
2227 wcscmp(wFileData.cFileName, L"..") != 0) {
2228 v = PyUnicode_FromUnicode(wFileData.cFileName, wcslen(wFileData.cFileName));
2229 if (v == NULL) {
2230 Py_DECREF(d);
2231 d = NULL;
2232 break;
2234 if (PyList_Append(d, v) != 0) {
2235 Py_DECREF(v);
2236 Py_DECREF(d);
2237 d = NULL;
2238 break;
2240 Py_DECREF(v);
2242 Py_BEGIN_ALLOW_THREADS
2243 result = FindNextFileW(hFindFile, &wFileData);
2244 Py_END_ALLOW_THREADS
2245 /* FindNextFile sets error to ERROR_NO_MORE_FILES if
2246 it got to the end of the directory. */
2247 if (!result && GetLastError() != ERROR_NO_MORE_FILES) {
2248 Py_DECREF(d);
2249 win32_error_unicode("FindNextFileW", wnamebuf);
2250 FindClose(hFindFile);
2251 free(wnamebuf);
2252 return NULL;
2254 } while (result == TRUE);
2256 if (FindClose(hFindFile) == FALSE) {
2257 Py_DECREF(d);
2258 win32_error_unicode("FindClose", wnamebuf);
2259 free(wnamebuf);
2260 return NULL;
2262 free(wnamebuf);
2263 return d;
2265 /* Drop the argument parsing error as narrow strings
2266 are also valid. */
2267 PyErr_Clear();
2269 #endif
2271 if (!PyArg_ParseTuple(args, "et#:listdir",
2272 Py_FileSystemDefaultEncoding, &bufptr, &len))
2273 return NULL;
2274 if (len > 0) {
2275 char ch = namebuf[len-1];
2276 if (ch != SEP && ch != ALTSEP && ch != ':')
2277 namebuf[len++] = '/';
2279 strcpy(namebuf + len, "*.*");
2281 if ((d = PyList_New(0)) == NULL)
2282 return NULL;
2284 hFindFile = FindFirstFile(namebuf, &FileData);
2285 if (hFindFile == INVALID_HANDLE_VALUE) {
2286 int error = GetLastError();
2287 if (error == ERROR_FILE_NOT_FOUND)
2288 return d;
2289 Py_DECREF(d);
2290 return win32_error("FindFirstFile", namebuf);
2292 do {
2293 /* Skip over . and .. */
2294 if (strcmp(FileData.cFileName, ".") != 0 &&
2295 strcmp(FileData.cFileName, "..") != 0) {
2296 v = PyString_FromString(FileData.cFileName);
2297 if (v == NULL) {
2298 Py_DECREF(d);
2299 d = NULL;
2300 break;
2302 if (PyList_Append(d, v) != 0) {
2303 Py_DECREF(v);
2304 Py_DECREF(d);
2305 d = NULL;
2306 break;
2308 Py_DECREF(v);
2310 Py_BEGIN_ALLOW_THREADS
2311 result = FindNextFile(hFindFile, &FileData);
2312 Py_END_ALLOW_THREADS
2313 /* FindNextFile sets error to ERROR_NO_MORE_FILES if
2314 it got to the end of the directory. */
2315 if (!result && GetLastError() != ERROR_NO_MORE_FILES) {
2316 Py_DECREF(d);
2317 win32_error("FindNextFile", namebuf);
2318 FindClose(hFindFile);
2319 return NULL;
2321 } while (result == TRUE);
2323 if (FindClose(hFindFile) == FALSE) {
2324 Py_DECREF(d);
2325 return win32_error("FindClose", namebuf);
2328 return d;
2330 #elif defined(PYOS_OS2)
2332 #ifndef MAX_PATH
2333 #define MAX_PATH CCHMAXPATH
2334 #endif
2335 char *name, *pt;
2336 Py_ssize_t len;
2337 PyObject *d, *v;
2338 char namebuf[MAX_PATH+5];
2339 HDIR hdir = 1;
2340 ULONG srchcnt = 1;
2341 FILEFINDBUF3 ep;
2342 APIRET rc;
2344 if (!PyArg_ParseTuple(args, "t#:listdir", &name, &len))
2345 return NULL;
2346 if (len >= MAX_PATH) {
2347 PyErr_SetString(PyExc_ValueError, "path too long");
2348 return NULL;
2350 strcpy(namebuf, name);
2351 for (pt = namebuf; *pt; pt++)
2352 if (*pt == ALTSEP)
2353 *pt = SEP;
2354 if (namebuf[len-1] != SEP)
2355 namebuf[len++] = SEP;
2356 strcpy(namebuf + len, "*.*");
2358 if ((d = PyList_New(0)) == NULL)
2359 return NULL;
2361 rc = DosFindFirst(namebuf, /* Wildcard Pattern to Match */
2362 &hdir, /* Handle to Use While Search Directory */
2363 FILE_READONLY | FILE_HIDDEN | FILE_SYSTEM | FILE_DIRECTORY,
2364 &ep, sizeof(ep), /* Structure to Receive Directory Entry */
2365 &srchcnt, /* Max and Actual Count of Entries Per Iteration */
2366 FIL_STANDARD); /* Format of Entry (EAs or Not) */
2368 if (rc != NO_ERROR) {
2369 errno = ENOENT;
2370 return posix_error_with_filename(name);
2373 if (srchcnt > 0) { /* If Directory is NOT Totally Empty, */
2374 do {
2375 if (ep.achName[0] == '.'
2376 && (ep.achName[1] == '\0' || (ep.achName[1] == '.' && ep.achName[2] == '\0')))
2377 continue; /* Skip Over "." and ".." Names */
2379 strcpy(namebuf, ep.achName);
2381 /* Leave Case of Name Alone -- In Native Form */
2382 /* (Removed Forced Lowercasing Code) */
2384 v = PyString_FromString(namebuf);
2385 if (v == NULL) {
2386 Py_DECREF(d);
2387 d = NULL;
2388 break;
2390 if (PyList_Append(d, v) != 0) {
2391 Py_DECREF(v);
2392 Py_DECREF(d);
2393 d = NULL;
2394 break;
2396 Py_DECREF(v);
2397 } while (DosFindNext(hdir, &ep, sizeof(ep), &srchcnt) == NO_ERROR && srchcnt > 0);
2400 return d;
2401 #else
2403 char *name = NULL;
2404 PyObject *d, *v;
2405 DIR *dirp;
2406 struct dirent *ep;
2407 int arg_is_unicode = 1;
2409 errno = 0;
2410 if (!PyArg_ParseTuple(args, "U:listdir", &v)) {
2411 arg_is_unicode = 0;
2412 PyErr_Clear();
2414 if (!PyArg_ParseTuple(args, "et:listdir", Py_FileSystemDefaultEncoding, &name))
2415 return NULL;
2416 if ((dirp = opendir(name)) == NULL) {
2417 return posix_error_with_allocated_filename(name);
2419 if ((d = PyList_New(0)) == NULL) {
2420 closedir(dirp);
2421 PyMem_Free(name);
2422 return NULL;
2424 for (;;) {
2425 errno = 0;
2426 Py_BEGIN_ALLOW_THREADS
2427 ep = readdir(dirp);
2428 Py_END_ALLOW_THREADS
2429 if (ep == NULL) {
2430 if (errno == 0) {
2431 break;
2432 } else {
2433 closedir(dirp);
2434 Py_DECREF(d);
2435 return posix_error_with_allocated_filename(name);
2438 if (ep->d_name[0] == '.' &&
2439 (NAMLEN(ep) == 1 ||
2440 (ep->d_name[1] == '.' && NAMLEN(ep) == 2)))
2441 continue;
2442 v = PyString_FromStringAndSize(ep->d_name, NAMLEN(ep));
2443 if (v == NULL) {
2444 Py_DECREF(d);
2445 d = NULL;
2446 break;
2448 #ifdef Py_USING_UNICODE
2449 if (arg_is_unicode) {
2450 PyObject *w;
2452 w = PyUnicode_FromEncodedObject(v,
2453 Py_FileSystemDefaultEncoding,
2454 "strict");
2455 if (w != NULL) {
2456 Py_DECREF(v);
2457 v = w;
2459 else {
2460 /* fall back to the original byte string, as
2461 discussed in patch #683592 */
2462 PyErr_Clear();
2465 #endif
2466 if (PyList_Append(d, v) != 0) {
2467 Py_DECREF(v);
2468 Py_DECREF(d);
2469 d = NULL;
2470 break;
2472 Py_DECREF(v);
2474 closedir(dirp);
2475 PyMem_Free(name);
2477 return d;
2479 #endif /* which OS */
2480 } /* end of posix_listdir */
2482 #ifdef MS_WINDOWS
2483 /* A helper function for abspath on win32 */
2484 static PyObject *
2485 posix__getfullpathname(PyObject *self, PyObject *args)
2487 /* assume encoded strings won't more than double no of chars */
2488 char inbuf[MAX_PATH*2];
2489 char *inbufp = inbuf;
2490 Py_ssize_t insize = sizeof(inbuf);
2491 char outbuf[MAX_PATH*2];
2492 char *temp;
2493 #ifdef Py_WIN_WIDE_FILENAMES
2494 if (unicode_file_names()) {
2495 PyUnicodeObject *po;
2496 if (PyArg_ParseTuple(args, "U|:_getfullpathname", &po)) {
2497 Py_UNICODE *wpath = PyUnicode_AS_UNICODE(po);
2498 Py_UNICODE woutbuf[MAX_PATH*2], *woutbufp = woutbuf;
2499 Py_UNICODE *wtemp;
2500 DWORD result;
2501 PyObject *v;
2502 result = GetFullPathNameW(wpath,
2503 sizeof(woutbuf)/sizeof(woutbuf[0]),
2504 woutbuf, &wtemp);
2505 if (result > sizeof(woutbuf)/sizeof(woutbuf[0])) {
2506 woutbufp = malloc(result * sizeof(Py_UNICODE));
2507 if (!woutbufp)
2508 return PyErr_NoMemory();
2509 result = GetFullPathNameW(wpath, result, woutbufp, &wtemp);
2511 if (result)
2512 v = PyUnicode_FromUnicode(woutbufp, wcslen(woutbufp));
2513 else
2514 v = win32_error_unicode("GetFullPathNameW", wpath);
2515 if (woutbufp != woutbuf)
2516 free(woutbufp);
2517 return v;
2519 /* Drop the argument parsing error as narrow strings
2520 are also valid. */
2521 PyErr_Clear();
2523 #endif
2524 if (!PyArg_ParseTuple (args, "et#:_getfullpathname",
2525 Py_FileSystemDefaultEncoding, &inbufp,
2526 &insize))
2527 return NULL;
2528 if (!GetFullPathName(inbuf, sizeof(outbuf)/sizeof(outbuf[0]),
2529 outbuf, &temp))
2530 return win32_error("GetFullPathName", inbuf);
2531 if (PyUnicode_Check(PyTuple_GetItem(args, 0))) {
2532 return PyUnicode_Decode(outbuf, strlen(outbuf),
2533 Py_FileSystemDefaultEncoding, NULL);
2535 return PyString_FromString(outbuf);
2536 } /* end of posix__getfullpathname */
2537 #endif /* MS_WINDOWS */
2539 PyDoc_STRVAR(posix_mkdir__doc__,
2540 "mkdir(path [, mode=0777])\n\n\
2541 Create a directory.");
2543 static PyObject *
2544 posix_mkdir(PyObject *self, PyObject *args)
2546 int res;
2547 char *path = NULL;
2548 int mode = 0777;
2550 #ifdef Py_WIN_WIDE_FILENAMES
2551 if (unicode_file_names()) {
2552 PyUnicodeObject *po;
2553 if (PyArg_ParseTuple(args, "U|i:mkdir", &po, &mode)) {
2554 Py_BEGIN_ALLOW_THREADS
2555 /* PyUnicode_AS_UNICODE OK without thread lock as
2556 it is a simple dereference. */
2557 res = CreateDirectoryW(PyUnicode_AS_UNICODE(po), NULL);
2558 Py_END_ALLOW_THREADS
2559 if (!res)
2560 return win32_error_unicode("mkdir", PyUnicode_AS_UNICODE(po));
2561 Py_INCREF(Py_None);
2562 return Py_None;
2564 /* Drop the argument parsing error as narrow strings
2565 are also valid. */
2566 PyErr_Clear();
2568 if (!PyArg_ParseTuple(args, "et|i:mkdir",
2569 Py_FileSystemDefaultEncoding, &path, &mode))
2570 return NULL;
2571 Py_BEGIN_ALLOW_THREADS
2572 /* PyUnicode_AS_UNICODE OK without thread lock as
2573 it is a simple dereference. */
2574 res = CreateDirectoryA(path, NULL);
2575 Py_END_ALLOW_THREADS
2576 if (!res) {
2577 win32_error("mkdir", path);
2578 PyMem_Free(path);
2579 return NULL;
2581 PyMem_Free(path);
2582 Py_INCREF(Py_None);
2583 return Py_None;
2584 #else
2586 if (!PyArg_ParseTuple(args, "et|i:mkdir",
2587 Py_FileSystemDefaultEncoding, &path, &mode))
2588 return NULL;
2589 Py_BEGIN_ALLOW_THREADS
2590 #if ( defined(__WATCOMC__) || defined(PYCC_VACPP) ) && !defined(__QNX__)
2591 res = mkdir(path);
2592 #else
2593 res = mkdir(path, mode);
2594 #endif
2595 Py_END_ALLOW_THREADS
2596 if (res < 0)
2597 return posix_error_with_allocated_filename(path);
2598 PyMem_Free(path);
2599 Py_INCREF(Py_None);
2600 return Py_None;
2601 #endif
2605 /* sys/resource.h is needed for at least: wait3(), wait4(), broken nice. */
2606 #if defined(HAVE_SYS_RESOURCE_H)
2607 #include <sys/resource.h>
2608 #endif
2611 #ifdef HAVE_NICE
2612 PyDoc_STRVAR(posix_nice__doc__,
2613 "nice(inc) -> new_priority\n\n\
2614 Decrease the priority of process by inc and return the new priority.");
2616 static PyObject *
2617 posix_nice(PyObject *self, PyObject *args)
2619 int increment, value;
2621 if (!PyArg_ParseTuple(args, "i:nice", &increment))
2622 return NULL;
2624 /* There are two flavours of 'nice': one that returns the new
2625 priority (as required by almost all standards out there) and the
2626 Linux/FreeBSD/BSDI one, which returns '0' on success and advices
2627 the use of getpriority() to get the new priority.
2629 If we are of the nice family that returns the new priority, we
2630 need to clear errno before the call, and check if errno is filled
2631 before calling posix_error() on a returnvalue of -1, because the
2632 -1 may be the actual new priority! */
2634 errno = 0;
2635 value = nice(increment);
2636 #if defined(HAVE_BROKEN_NICE) && defined(HAVE_GETPRIORITY)
2637 if (value == 0)
2638 value = getpriority(PRIO_PROCESS, 0);
2639 #endif
2640 if (value == -1 && errno != 0)
2641 /* either nice() or getpriority() returned an error */
2642 return posix_error();
2643 return PyInt_FromLong((long) value);
2645 #endif /* HAVE_NICE */
2647 PyDoc_STRVAR(posix_rename__doc__,
2648 "rename(old, new)\n\n\
2649 Rename a file or directory.");
2651 static PyObject *
2652 posix_rename(PyObject *self, PyObject *args)
2654 #ifdef MS_WINDOWS
2655 PyObject *o1, *o2;
2656 char *p1, *p2;
2657 BOOL result;
2658 if (unicode_file_names()) {
2659 if (!PyArg_ParseTuple(args, "OO:rename", &o1, &o2))
2660 goto error;
2661 if (!convert_to_unicode(&o1))
2662 goto error;
2663 if (!convert_to_unicode(&o2)) {
2664 Py_DECREF(o1);
2665 goto error;
2667 Py_BEGIN_ALLOW_THREADS
2668 result = MoveFileW(PyUnicode_AsUnicode(o1),
2669 PyUnicode_AsUnicode(o2));
2670 Py_END_ALLOW_THREADS
2671 Py_DECREF(o1);
2672 Py_DECREF(o2);
2673 if (!result)
2674 return win32_error("rename", NULL);
2675 Py_INCREF(Py_None);
2676 return Py_None;
2677 error:
2678 PyErr_Clear();
2680 if (!PyArg_ParseTuple(args, "ss:rename", &p1, &p2))
2681 return NULL;
2682 Py_BEGIN_ALLOW_THREADS
2683 result = MoveFileA(p1, p2);
2684 Py_END_ALLOW_THREADS
2685 if (!result)
2686 return win32_error("rename", NULL);
2687 Py_INCREF(Py_None);
2688 return Py_None;
2689 #else
2690 return posix_2str(args, "etet:rename", rename);
2691 #endif
2695 PyDoc_STRVAR(posix_rmdir__doc__,
2696 "rmdir(path)\n\n\
2697 Remove a directory.");
2699 static PyObject *
2700 posix_rmdir(PyObject *self, PyObject *args)
2702 #ifdef MS_WINDOWS
2703 return win32_1str(args, "rmdir", "s:rmdir", RemoveDirectoryA, "U:rmdir", RemoveDirectoryW);
2704 #else
2705 return posix_1str(args, "et:rmdir", rmdir);
2706 #endif
2710 PyDoc_STRVAR(posix_stat__doc__,
2711 "stat(path) -> stat result\n\n\
2712 Perform a stat system call on the given path.");
2714 static PyObject *
2715 posix_stat(PyObject *self, PyObject *args)
2717 #ifdef MS_WINDOWS
2718 return posix_do_stat(self, args, "et:stat", STAT, "U:stat", win32_wstat);
2719 #else
2720 return posix_do_stat(self, args, "et:stat", STAT, NULL, NULL);
2721 #endif
2725 #ifdef HAVE_SYSTEM
2726 PyDoc_STRVAR(posix_system__doc__,
2727 "system(command) -> exit_status\n\n\
2728 Execute the command (a string) in a subshell.");
2730 static PyObject *
2731 posix_system(PyObject *self, PyObject *args)
2733 char *command;
2734 long sts;
2735 if (!PyArg_ParseTuple(args, "s:system", &command))
2736 return NULL;
2737 Py_BEGIN_ALLOW_THREADS
2738 sts = system(command);
2739 Py_END_ALLOW_THREADS
2740 return PyInt_FromLong(sts);
2742 #endif
2745 PyDoc_STRVAR(posix_umask__doc__,
2746 "umask(new_mask) -> old_mask\n\n\
2747 Set the current numeric umask and return the previous umask.");
2749 static PyObject *
2750 posix_umask(PyObject *self, PyObject *args)
2752 int i;
2753 if (!PyArg_ParseTuple(args, "i:umask", &i))
2754 return NULL;
2755 i = (int)umask(i);
2756 if (i < 0)
2757 return posix_error();
2758 return PyInt_FromLong((long)i);
2762 PyDoc_STRVAR(posix_unlink__doc__,
2763 "unlink(path)\n\n\
2764 Remove a file (same as remove(path)).");
2766 PyDoc_STRVAR(posix_remove__doc__,
2767 "remove(path)\n\n\
2768 Remove a file (same as unlink(path)).");
2770 static PyObject *
2771 posix_unlink(PyObject *self, PyObject *args)
2773 #ifdef MS_WINDOWS
2774 return win32_1str(args, "remove", "s:remove", DeleteFileA, "U:remove", DeleteFileW);
2775 #else
2776 return posix_1str(args, "et:remove", unlink);
2777 #endif
2781 #ifdef HAVE_UNAME
2782 PyDoc_STRVAR(posix_uname__doc__,
2783 "uname() -> (sysname, nodename, release, version, machine)\n\n\
2784 Return a tuple identifying the current operating system.");
2786 static PyObject *
2787 posix_uname(PyObject *self, PyObject *noargs)
2789 struct utsname u;
2790 int res;
2792 Py_BEGIN_ALLOW_THREADS
2793 res = uname(&u);
2794 Py_END_ALLOW_THREADS
2795 if (res < 0)
2796 return posix_error();
2797 return Py_BuildValue("(sssss)",
2798 u.sysname,
2799 u.nodename,
2800 u.release,
2801 u.version,
2802 u.machine);
2804 #endif /* HAVE_UNAME */
2806 static int
2807 extract_time(PyObject *t, long* sec, long* usec)
2809 long intval;
2810 if (PyFloat_Check(t)) {
2811 double tval = PyFloat_AsDouble(t);
2812 PyObject *intobj = Py_TYPE(t)->tp_as_number->nb_int(t);
2813 if (!intobj)
2814 return -1;
2815 intval = PyInt_AsLong(intobj);
2816 Py_DECREF(intobj);
2817 if (intval == -1 && PyErr_Occurred())
2818 return -1;
2819 *sec = intval;
2820 *usec = (long)((tval - intval) * 1e6); /* can't exceed 1000000 */
2821 if (*usec < 0)
2822 /* If rounding gave us a negative number,
2823 truncate. */
2824 *usec = 0;
2825 return 0;
2827 intval = PyInt_AsLong(t);
2828 if (intval == -1 && PyErr_Occurred())
2829 return -1;
2830 *sec = intval;
2831 *usec = 0;
2832 return 0;
2835 PyDoc_STRVAR(posix_utime__doc__,
2836 "utime(path, (atime, mtime))\n\
2837 utime(path, None)\n\n\
2838 Set the access and modified time of the file to the given values. If the\n\
2839 second form is used, set the access and modified times to the current time.");
2841 static PyObject *
2842 posix_utime(PyObject *self, PyObject *args)
2844 #ifdef Py_WIN_WIDE_FILENAMES
2845 PyObject *arg;
2846 PyUnicodeObject *obwpath;
2847 wchar_t *wpath = NULL;
2848 char *apath = NULL;
2849 HANDLE hFile;
2850 long atimesec, mtimesec, ausec, musec;
2851 FILETIME atime, mtime;
2852 PyObject *result = NULL;
2854 if (unicode_file_names()) {
2855 if (PyArg_ParseTuple(args, "UO|:utime", &obwpath, &arg)) {
2856 wpath = PyUnicode_AS_UNICODE(obwpath);
2857 Py_BEGIN_ALLOW_THREADS
2858 hFile = CreateFileW(wpath, FILE_WRITE_ATTRIBUTES, 0,
2859 NULL, OPEN_EXISTING,
2860 FILE_FLAG_BACKUP_SEMANTICS, NULL);
2861 Py_END_ALLOW_THREADS
2862 if (hFile == INVALID_HANDLE_VALUE)
2863 return win32_error_unicode("utime", wpath);
2864 } else
2865 /* Drop the argument parsing error as narrow strings
2866 are also valid. */
2867 PyErr_Clear();
2869 if (!wpath) {
2870 if (!PyArg_ParseTuple(args, "etO:utime",
2871 Py_FileSystemDefaultEncoding, &apath, &arg))
2872 return NULL;
2873 Py_BEGIN_ALLOW_THREADS
2874 hFile = CreateFileA(apath, FILE_WRITE_ATTRIBUTES, 0,
2875 NULL, OPEN_EXISTING,
2876 FILE_FLAG_BACKUP_SEMANTICS, NULL);
2877 Py_END_ALLOW_THREADS
2878 if (hFile == INVALID_HANDLE_VALUE) {
2879 win32_error("utime", apath);
2880 PyMem_Free(apath);
2881 return NULL;
2883 PyMem_Free(apath);
2886 if (arg == Py_None) {
2887 SYSTEMTIME now;
2888 GetSystemTime(&now);
2889 if (!SystemTimeToFileTime(&now, &mtime) ||
2890 !SystemTimeToFileTime(&now, &atime)) {
2891 win32_error("utime", NULL);
2892 goto done;
2895 else if (!PyTuple_Check(arg) || PyTuple_Size(arg) != 2) {
2896 PyErr_SetString(PyExc_TypeError,
2897 "utime() arg 2 must be a tuple (atime, mtime)");
2898 goto done;
2900 else {
2901 if (extract_time(PyTuple_GET_ITEM(arg, 0),
2902 &atimesec, &ausec) == -1)
2903 goto done;
2904 time_t_to_FILE_TIME(atimesec, 1000*ausec, &atime);
2905 if (extract_time(PyTuple_GET_ITEM(arg, 1),
2906 &mtimesec, &musec) == -1)
2907 goto done;
2908 time_t_to_FILE_TIME(mtimesec, 1000*musec, &mtime);
2910 if (!SetFileTime(hFile, NULL, &atime, &mtime)) {
2911 /* Avoid putting the file name into the error here,
2912 as that may confuse the user into believing that
2913 something is wrong with the file, when it also
2914 could be the time stamp that gives a problem. */
2915 win32_error("utime", NULL);
2917 Py_INCREF(Py_None);
2918 result = Py_None;
2919 done:
2920 CloseHandle(hFile);
2921 return result;
2922 #else /* Py_WIN_WIDE_FILENAMES */
2924 char *path = NULL;
2925 long atime, mtime, ausec, musec;
2926 int res;
2927 PyObject* arg;
2929 #if defined(HAVE_UTIMES)
2930 struct timeval buf[2];
2931 #define ATIME buf[0].tv_sec
2932 #define MTIME buf[1].tv_sec
2933 #elif defined(HAVE_UTIME_H)
2934 /* XXX should define struct utimbuf instead, above */
2935 struct utimbuf buf;
2936 #define ATIME buf.actime
2937 #define MTIME buf.modtime
2938 #define UTIME_ARG &buf
2939 #else /* HAVE_UTIMES */
2940 time_t buf[2];
2941 #define ATIME buf[0]
2942 #define MTIME buf[1]
2943 #define UTIME_ARG buf
2944 #endif /* HAVE_UTIMES */
2947 if (!PyArg_ParseTuple(args, "etO:utime",
2948 Py_FileSystemDefaultEncoding, &path, &arg))
2949 return NULL;
2950 if (arg == Py_None) {
2951 /* optional time values not given */
2952 Py_BEGIN_ALLOW_THREADS
2953 res = utime(path, NULL);
2954 Py_END_ALLOW_THREADS
2956 else if (!PyTuple_Check(arg) || PyTuple_Size(arg) != 2) {
2957 PyErr_SetString(PyExc_TypeError,
2958 "utime() arg 2 must be a tuple (atime, mtime)");
2959 PyMem_Free(path);
2960 return NULL;
2962 else {
2963 if (extract_time(PyTuple_GET_ITEM(arg, 0),
2964 &atime, &ausec) == -1) {
2965 PyMem_Free(path);
2966 return NULL;
2968 if (extract_time(PyTuple_GET_ITEM(arg, 1),
2969 &mtime, &musec) == -1) {
2970 PyMem_Free(path);
2971 return NULL;
2973 ATIME = atime;
2974 MTIME = mtime;
2975 #ifdef HAVE_UTIMES
2976 buf[0].tv_usec = ausec;
2977 buf[1].tv_usec = musec;
2978 Py_BEGIN_ALLOW_THREADS
2979 res = utimes(path, buf);
2980 Py_END_ALLOW_THREADS
2981 #else
2982 Py_BEGIN_ALLOW_THREADS
2983 res = utime(path, UTIME_ARG);
2984 Py_END_ALLOW_THREADS
2985 #endif /* HAVE_UTIMES */
2987 if (res < 0) {
2988 return posix_error_with_allocated_filename(path);
2990 PyMem_Free(path);
2991 Py_INCREF(Py_None);
2992 return Py_None;
2993 #undef UTIME_ARG
2994 #undef ATIME
2995 #undef MTIME
2996 #endif /* Py_WIN_WIDE_FILENAMES */
3000 /* Process operations */
3002 PyDoc_STRVAR(posix__exit__doc__,
3003 "_exit(status)\n\n\
3004 Exit to the system with specified status, without normal exit processing.");
3006 static PyObject *
3007 posix__exit(PyObject *self, PyObject *args)
3009 int sts;
3010 if (!PyArg_ParseTuple(args, "i:_exit", &sts))
3011 return NULL;
3012 _exit(sts);
3013 return NULL; /* Make gcc -Wall happy */
3016 #if defined(HAVE_EXECV) || defined(HAVE_SPAWNV)
3017 static void
3018 free_string_array(char **array, Py_ssize_t count)
3020 Py_ssize_t i;
3021 for (i = 0; i < count; i++)
3022 PyMem_Free(array[i]);
3023 PyMem_DEL(array);
3025 #endif
3028 #ifdef HAVE_EXECV
3029 PyDoc_STRVAR(posix_execv__doc__,
3030 "execv(path, args)\n\n\
3031 Execute an executable path with arguments, replacing current process.\n\
3033 path: path of executable file\n\
3034 args: tuple or list of strings");
3036 static PyObject *
3037 posix_execv(PyObject *self, PyObject *args)
3039 char *path;
3040 PyObject *argv;
3041 char **argvlist;
3042 Py_ssize_t i, argc;
3043 PyObject *(*getitem)(PyObject *, Py_ssize_t);
3045 /* execv has two arguments: (path, argv), where
3046 argv is a list or tuple of strings. */
3048 if (!PyArg_ParseTuple(args, "etO:execv",
3049 Py_FileSystemDefaultEncoding,
3050 &path, &argv))
3051 return NULL;
3052 if (PyList_Check(argv)) {
3053 argc = PyList_Size(argv);
3054 getitem = PyList_GetItem;
3056 else if (PyTuple_Check(argv)) {
3057 argc = PyTuple_Size(argv);
3058 getitem = PyTuple_GetItem;
3060 else {
3061 PyErr_SetString(PyExc_TypeError, "execv() arg 2 must be a tuple or list");
3062 PyMem_Free(path);
3063 return NULL;
3066 argvlist = PyMem_NEW(char *, argc+1);
3067 if (argvlist == NULL) {
3068 PyMem_Free(path);
3069 return PyErr_NoMemory();
3071 for (i = 0; i < argc; i++) {
3072 if (!PyArg_Parse((*getitem)(argv, i), "et",
3073 Py_FileSystemDefaultEncoding,
3074 &argvlist[i])) {
3075 free_string_array(argvlist, i);
3076 PyErr_SetString(PyExc_TypeError,
3077 "execv() arg 2 must contain only strings");
3078 PyMem_Free(path);
3079 return NULL;
3083 argvlist[argc] = NULL;
3085 execv(path, argvlist);
3087 /* If we get here it's definitely an error */
3089 free_string_array(argvlist, argc);
3090 PyMem_Free(path);
3091 return posix_error();
3095 PyDoc_STRVAR(posix_execve__doc__,
3096 "execve(path, args, env)\n\n\
3097 Execute a path with arguments and environment, replacing current process.\n\
3099 path: path of executable file\n\
3100 args: tuple or list of arguments\n\
3101 env: dictionary of strings mapping to strings");
3103 static PyObject *
3104 posix_execve(PyObject *self, PyObject *args)
3106 char *path;
3107 PyObject *argv, *env;
3108 char **argvlist;
3109 char **envlist;
3110 PyObject *key, *val, *keys=NULL, *vals=NULL;
3111 Py_ssize_t i, pos, argc, envc;
3112 PyObject *(*getitem)(PyObject *, Py_ssize_t);
3113 Py_ssize_t lastarg = 0;
3115 /* execve has three arguments: (path, argv, env), where
3116 argv is a list or tuple of strings and env is a dictionary
3117 like posix.environ. */
3119 if (!PyArg_ParseTuple(args, "etOO:execve",
3120 Py_FileSystemDefaultEncoding,
3121 &path, &argv, &env))
3122 return NULL;
3123 if (PyList_Check(argv)) {
3124 argc = PyList_Size(argv);
3125 getitem = PyList_GetItem;
3127 else if (PyTuple_Check(argv)) {
3128 argc = PyTuple_Size(argv);
3129 getitem = PyTuple_GetItem;
3131 else {
3132 PyErr_SetString(PyExc_TypeError,
3133 "execve() arg 2 must be a tuple or list");
3134 goto fail_0;
3136 if (!PyMapping_Check(env)) {
3137 PyErr_SetString(PyExc_TypeError,
3138 "execve() arg 3 must be a mapping object");
3139 goto fail_0;
3142 argvlist = PyMem_NEW(char *, argc+1);
3143 if (argvlist == NULL) {
3144 PyErr_NoMemory();
3145 goto fail_0;
3147 for (i = 0; i < argc; i++) {
3148 if (!PyArg_Parse((*getitem)(argv, i),
3149 "et;execve() arg 2 must contain only strings",
3150 Py_FileSystemDefaultEncoding,
3151 &argvlist[i]))
3153 lastarg = i;
3154 goto fail_1;
3157 lastarg = argc;
3158 argvlist[argc] = NULL;
3160 i = PyMapping_Size(env);
3161 if (i < 0)
3162 goto fail_1;
3163 envlist = PyMem_NEW(char *, i + 1);
3164 if (envlist == NULL) {
3165 PyErr_NoMemory();
3166 goto fail_1;
3168 envc = 0;
3169 keys = PyMapping_Keys(env);
3170 vals = PyMapping_Values(env);
3171 if (!keys || !vals)
3172 goto fail_2;
3173 if (!PyList_Check(keys) || !PyList_Check(vals)) {
3174 PyErr_SetString(PyExc_TypeError,
3175 "execve(): env.keys() or env.values() is not a list");
3176 goto fail_2;
3179 for (pos = 0; pos < i; pos++) {
3180 char *p, *k, *v;
3181 size_t len;
3183 key = PyList_GetItem(keys, pos);
3184 val = PyList_GetItem(vals, pos);
3185 if (!key || !val)
3186 goto fail_2;
3188 if (!PyArg_Parse(
3189 key,
3190 "s;execve() arg 3 contains a non-string key",
3191 &k) ||
3192 !PyArg_Parse(
3193 val,
3194 "s;execve() arg 3 contains a non-string value",
3195 &v))
3197 goto fail_2;
3200 #if defined(PYOS_OS2)
3201 /* Omit Pseudo-Env Vars that Would Confuse Programs if Passed On */
3202 if (stricmp(k, "BEGINLIBPATH") != 0 && stricmp(k, "ENDLIBPATH") != 0) {
3203 #endif
3204 len = PyString_Size(key) + PyString_Size(val) + 2;
3205 p = PyMem_NEW(char, len);
3206 if (p == NULL) {
3207 PyErr_NoMemory();
3208 goto fail_2;
3210 PyOS_snprintf(p, len, "%s=%s", k, v);
3211 envlist[envc++] = p;
3212 #if defined(PYOS_OS2)
3214 #endif
3216 envlist[envc] = 0;
3218 execve(path, argvlist, envlist);
3220 /* If we get here it's definitely an error */
3222 (void) posix_error();
3224 fail_2:
3225 while (--envc >= 0)
3226 PyMem_DEL(envlist[envc]);
3227 PyMem_DEL(envlist);
3228 fail_1:
3229 free_string_array(argvlist, lastarg);
3230 Py_XDECREF(vals);
3231 Py_XDECREF(keys);
3232 fail_0:
3233 PyMem_Free(path);
3234 return NULL;
3236 #endif /* HAVE_EXECV */
3239 #ifdef HAVE_SPAWNV
3240 PyDoc_STRVAR(posix_spawnv__doc__,
3241 "spawnv(mode, path, args)\n\n\
3242 Execute the program 'path' in a new process.\n\
3244 mode: mode of process creation\n\
3245 path: path of executable file\n\
3246 args: tuple or list of strings");
3248 static PyObject *
3249 posix_spawnv(PyObject *self, PyObject *args)
3251 char *path;
3252 PyObject *argv;
3253 char **argvlist;
3254 int mode, i;
3255 Py_ssize_t argc;
3256 Py_intptr_t spawnval;
3257 PyObject *(*getitem)(PyObject *, Py_ssize_t);
3259 /* spawnv has three arguments: (mode, path, argv), where
3260 argv is a list or tuple of strings. */
3262 if (!PyArg_ParseTuple(args, "ietO:spawnv", &mode,
3263 Py_FileSystemDefaultEncoding,
3264 &path, &argv))
3265 return NULL;
3266 if (PyList_Check(argv)) {
3267 argc = PyList_Size(argv);
3268 getitem = PyList_GetItem;
3270 else if (PyTuple_Check(argv)) {
3271 argc = PyTuple_Size(argv);
3272 getitem = PyTuple_GetItem;
3274 else {
3275 PyErr_SetString(PyExc_TypeError,
3276 "spawnv() arg 2 must be a tuple or list");
3277 PyMem_Free(path);
3278 return NULL;
3281 argvlist = PyMem_NEW(char *, argc+1);
3282 if (argvlist == NULL) {
3283 PyMem_Free(path);
3284 return PyErr_NoMemory();
3286 for (i = 0; i < argc; i++) {
3287 if (!PyArg_Parse((*getitem)(argv, i), "et",
3288 Py_FileSystemDefaultEncoding,
3289 &argvlist[i])) {
3290 free_string_array(argvlist, i);
3291 PyErr_SetString(
3292 PyExc_TypeError,
3293 "spawnv() arg 2 must contain only strings");
3294 PyMem_Free(path);
3295 return NULL;
3298 argvlist[argc] = NULL;
3300 #if defined(PYOS_OS2) && defined(PYCC_GCC)
3301 Py_BEGIN_ALLOW_THREADS
3302 spawnval = spawnv(mode, path, argvlist);
3303 Py_END_ALLOW_THREADS
3304 #else
3305 if (mode == _OLD_P_OVERLAY)
3306 mode = _P_OVERLAY;
3308 Py_BEGIN_ALLOW_THREADS
3309 spawnval = _spawnv(mode, path, argvlist);
3310 Py_END_ALLOW_THREADS
3311 #endif
3313 free_string_array(argvlist, argc);
3314 PyMem_Free(path);
3316 if (spawnval == -1)
3317 return posix_error();
3318 else
3319 #if SIZEOF_LONG == SIZEOF_VOID_P
3320 return Py_BuildValue("l", (long) spawnval);
3321 #else
3322 return Py_BuildValue("L", (PY_LONG_LONG) spawnval);
3323 #endif
3327 PyDoc_STRVAR(posix_spawnve__doc__,
3328 "spawnve(mode, path, args, env)\n\n\
3329 Execute the program 'path' in a new process.\n\
3331 mode: mode of process creation\n\
3332 path: path of executable file\n\
3333 args: tuple or list of arguments\n\
3334 env: dictionary of strings mapping to strings");
3336 static PyObject *
3337 posix_spawnve(PyObject *self, PyObject *args)
3339 char *path;
3340 PyObject *argv, *env;
3341 char **argvlist;
3342 char **envlist;
3343 PyObject *key, *val, *keys=NULL, *vals=NULL, *res=NULL;
3344 int mode, pos, envc;
3345 Py_ssize_t argc, i;
3346 Py_intptr_t spawnval;
3347 PyObject *(*getitem)(PyObject *, Py_ssize_t);
3348 Py_ssize_t lastarg = 0;
3350 /* spawnve has four arguments: (mode, path, argv, env), where
3351 argv is a list or tuple of strings and env is a dictionary
3352 like posix.environ. */
3354 if (!PyArg_ParseTuple(args, "ietOO:spawnve", &mode,
3355 Py_FileSystemDefaultEncoding,
3356 &path, &argv, &env))
3357 return NULL;
3358 if (PyList_Check(argv)) {
3359 argc = PyList_Size(argv);
3360 getitem = PyList_GetItem;
3362 else if (PyTuple_Check(argv)) {
3363 argc = PyTuple_Size(argv);
3364 getitem = PyTuple_GetItem;
3366 else {
3367 PyErr_SetString(PyExc_TypeError,
3368 "spawnve() arg 2 must be a tuple or list");
3369 goto fail_0;
3371 if (!PyMapping_Check(env)) {
3372 PyErr_SetString(PyExc_TypeError,
3373 "spawnve() arg 3 must be a mapping object");
3374 goto fail_0;
3377 argvlist = PyMem_NEW(char *, argc+1);
3378 if (argvlist == NULL) {
3379 PyErr_NoMemory();
3380 goto fail_0;
3382 for (i = 0; i < argc; i++) {
3383 if (!PyArg_Parse((*getitem)(argv, i),
3384 "et;spawnve() arg 2 must contain only strings",
3385 Py_FileSystemDefaultEncoding,
3386 &argvlist[i]))
3388 lastarg = i;
3389 goto fail_1;
3392 lastarg = argc;
3393 argvlist[argc] = NULL;
3395 i = PyMapping_Size(env);
3396 if (i < 0)
3397 goto fail_1;
3398 envlist = PyMem_NEW(char *, i + 1);
3399 if (envlist == NULL) {
3400 PyErr_NoMemory();
3401 goto fail_1;
3403 envc = 0;
3404 keys = PyMapping_Keys(env);
3405 vals = PyMapping_Values(env);
3406 if (!keys || !vals)
3407 goto fail_2;
3408 if (!PyList_Check(keys) || !PyList_Check(vals)) {
3409 PyErr_SetString(PyExc_TypeError,
3410 "spawnve(): env.keys() or env.values() is not a list");
3411 goto fail_2;
3414 for (pos = 0; pos < i; pos++) {
3415 char *p, *k, *v;
3416 size_t len;
3418 key = PyList_GetItem(keys, pos);
3419 val = PyList_GetItem(vals, pos);
3420 if (!key || !val)
3421 goto fail_2;
3423 if (!PyArg_Parse(
3424 key,
3425 "s;spawnve() arg 3 contains a non-string key",
3426 &k) ||
3427 !PyArg_Parse(
3428 val,
3429 "s;spawnve() arg 3 contains a non-string value",
3430 &v))
3432 goto fail_2;
3434 len = PyString_Size(key) + PyString_Size(val) + 2;
3435 p = PyMem_NEW(char, len);
3436 if (p == NULL) {
3437 PyErr_NoMemory();
3438 goto fail_2;
3440 PyOS_snprintf(p, len, "%s=%s", k, v);
3441 envlist[envc++] = p;
3443 envlist[envc] = 0;
3445 #if defined(PYOS_OS2) && defined(PYCC_GCC)
3446 Py_BEGIN_ALLOW_THREADS
3447 spawnval = spawnve(mode, path, argvlist, envlist);
3448 Py_END_ALLOW_THREADS
3449 #else
3450 if (mode == _OLD_P_OVERLAY)
3451 mode = _P_OVERLAY;
3453 Py_BEGIN_ALLOW_THREADS
3454 spawnval = _spawnve(mode, path, argvlist, envlist);
3455 Py_END_ALLOW_THREADS
3456 #endif
3458 if (spawnval == -1)
3459 (void) posix_error();
3460 else
3461 #if SIZEOF_LONG == SIZEOF_VOID_P
3462 res = Py_BuildValue("l", (long) spawnval);
3463 #else
3464 res = Py_BuildValue("L", (PY_LONG_LONG) spawnval);
3465 #endif
3467 fail_2:
3468 while (--envc >= 0)
3469 PyMem_DEL(envlist[envc]);
3470 PyMem_DEL(envlist);
3471 fail_1:
3472 free_string_array(argvlist, lastarg);
3473 Py_XDECREF(vals);
3474 Py_XDECREF(keys);
3475 fail_0:
3476 PyMem_Free(path);
3477 return res;
3480 /* OS/2 supports spawnvp & spawnvpe natively */
3481 #if defined(PYOS_OS2)
3482 PyDoc_STRVAR(posix_spawnvp__doc__,
3483 "spawnvp(mode, file, args)\n\n\
3484 Execute the program 'file' in a new process, using the environment\n\
3485 search path to find the file.\n\
3487 mode: mode of process creation\n\
3488 file: executable file name\n\
3489 args: tuple or list of strings");
3491 static PyObject *
3492 posix_spawnvp(PyObject *self, PyObject *args)
3494 char *path;
3495 PyObject *argv;
3496 char **argvlist;
3497 int mode, i, argc;
3498 Py_intptr_t spawnval;
3499 PyObject *(*getitem)(PyObject *, Py_ssize_t);
3501 /* spawnvp has three arguments: (mode, path, argv), where
3502 argv is a list or tuple of strings. */
3504 if (!PyArg_ParseTuple(args, "ietO:spawnvp", &mode,
3505 Py_FileSystemDefaultEncoding,
3506 &path, &argv))
3507 return NULL;
3508 if (PyList_Check(argv)) {
3509 argc = PyList_Size(argv);
3510 getitem = PyList_GetItem;
3512 else if (PyTuple_Check(argv)) {
3513 argc = PyTuple_Size(argv);
3514 getitem = PyTuple_GetItem;
3516 else {
3517 PyErr_SetString(PyExc_TypeError,
3518 "spawnvp() arg 2 must be a tuple or list");
3519 PyMem_Free(path);
3520 return NULL;
3523 argvlist = PyMem_NEW(char *, argc+1);
3524 if (argvlist == NULL) {
3525 PyMem_Free(path);
3526 return PyErr_NoMemory();
3528 for (i = 0; i < argc; i++) {
3529 if (!PyArg_Parse((*getitem)(argv, i), "et",
3530 Py_FileSystemDefaultEncoding,
3531 &argvlist[i])) {
3532 free_string_array(argvlist, i);
3533 PyErr_SetString(
3534 PyExc_TypeError,
3535 "spawnvp() arg 2 must contain only strings");
3536 PyMem_Free(path);
3537 return NULL;
3540 argvlist[argc] = NULL;
3542 Py_BEGIN_ALLOW_THREADS
3543 #if defined(PYCC_GCC)
3544 spawnval = spawnvp(mode, path, argvlist);
3545 #else
3546 spawnval = _spawnvp(mode, path, argvlist);
3547 #endif
3548 Py_END_ALLOW_THREADS
3550 free_string_array(argvlist, argc);
3551 PyMem_Free(path);
3553 if (spawnval == -1)
3554 return posix_error();
3555 else
3556 return Py_BuildValue("l", (long) spawnval);
3560 PyDoc_STRVAR(posix_spawnvpe__doc__,
3561 "spawnvpe(mode, file, args, env)\n\n\
3562 Execute the program 'file' in a new process, using the environment\n\
3563 search path to find the file.\n\
3565 mode: mode of process creation\n\
3566 file: executable file name\n\
3567 args: tuple or list of arguments\n\
3568 env: dictionary of strings mapping to strings");
3570 static PyObject *
3571 posix_spawnvpe(PyObject *self, PyObject *args)
3573 char *path;
3574 PyObject *argv, *env;
3575 char **argvlist;
3576 char **envlist;
3577 PyObject *key, *val, *keys=NULL, *vals=NULL, *res=NULL;
3578 int mode, i, pos, argc, envc;
3579 Py_intptr_t spawnval;
3580 PyObject *(*getitem)(PyObject *, Py_ssize_t);
3581 int lastarg = 0;
3583 /* spawnvpe has four arguments: (mode, path, argv, env), where
3584 argv is a list or tuple of strings and env is a dictionary
3585 like posix.environ. */
3587 if (!PyArg_ParseTuple(args, "ietOO:spawnvpe", &mode,
3588 Py_FileSystemDefaultEncoding,
3589 &path, &argv, &env))
3590 return NULL;
3591 if (PyList_Check(argv)) {
3592 argc = PyList_Size(argv);
3593 getitem = PyList_GetItem;
3595 else if (PyTuple_Check(argv)) {
3596 argc = PyTuple_Size(argv);
3597 getitem = PyTuple_GetItem;
3599 else {
3600 PyErr_SetString(PyExc_TypeError,
3601 "spawnvpe() arg 2 must be a tuple or list");
3602 goto fail_0;
3604 if (!PyMapping_Check(env)) {
3605 PyErr_SetString(PyExc_TypeError,
3606 "spawnvpe() arg 3 must be a mapping object");
3607 goto fail_0;
3610 argvlist = PyMem_NEW(char *, argc+1);
3611 if (argvlist == NULL) {
3612 PyErr_NoMemory();
3613 goto fail_0;
3615 for (i = 0; i < argc; i++) {
3616 if (!PyArg_Parse((*getitem)(argv, i),
3617 "et;spawnvpe() arg 2 must contain only strings",
3618 Py_FileSystemDefaultEncoding,
3619 &argvlist[i]))
3621 lastarg = i;
3622 goto fail_1;
3625 lastarg = argc;
3626 argvlist[argc] = NULL;
3628 i = PyMapping_Size(env);
3629 if (i < 0)
3630 goto fail_1;
3631 envlist = PyMem_NEW(char *, i + 1);
3632 if (envlist == NULL) {
3633 PyErr_NoMemory();
3634 goto fail_1;
3636 envc = 0;
3637 keys = PyMapping_Keys(env);
3638 vals = PyMapping_Values(env);
3639 if (!keys || !vals)
3640 goto fail_2;
3641 if (!PyList_Check(keys) || !PyList_Check(vals)) {
3642 PyErr_SetString(PyExc_TypeError,
3643 "spawnvpe(): env.keys() or env.values() is not a list");
3644 goto fail_2;
3647 for (pos = 0; pos < i; pos++) {
3648 char *p, *k, *v;
3649 size_t len;
3651 key = PyList_GetItem(keys, pos);
3652 val = PyList_GetItem(vals, pos);
3653 if (!key || !val)
3654 goto fail_2;
3656 if (!PyArg_Parse(
3657 key,
3658 "s;spawnvpe() arg 3 contains a non-string key",
3659 &k) ||
3660 !PyArg_Parse(
3661 val,
3662 "s;spawnvpe() arg 3 contains a non-string value",
3663 &v))
3665 goto fail_2;
3667 len = PyString_Size(key) + PyString_Size(val) + 2;
3668 p = PyMem_NEW(char, len);
3669 if (p == NULL) {
3670 PyErr_NoMemory();
3671 goto fail_2;
3673 PyOS_snprintf(p, len, "%s=%s", k, v);
3674 envlist[envc++] = p;
3676 envlist[envc] = 0;
3678 Py_BEGIN_ALLOW_THREADS
3679 #if defined(PYCC_GCC)
3680 spawnval = spawnvpe(mode, path, argvlist, envlist);
3681 #else
3682 spawnval = _spawnvpe(mode, path, argvlist, envlist);
3683 #endif
3684 Py_END_ALLOW_THREADS
3686 if (spawnval == -1)
3687 (void) posix_error();
3688 else
3689 res = Py_BuildValue("l", (long) spawnval);
3691 fail_2:
3692 while (--envc >= 0)
3693 PyMem_DEL(envlist[envc]);
3694 PyMem_DEL(envlist);
3695 fail_1:
3696 free_string_array(argvlist, lastarg);
3697 Py_XDECREF(vals);
3698 Py_XDECREF(keys);
3699 fail_0:
3700 PyMem_Free(path);
3701 return res;
3703 #endif /* PYOS_OS2 */
3704 #endif /* HAVE_SPAWNV */
3707 #ifdef HAVE_FORK1
3708 PyDoc_STRVAR(posix_fork1__doc__,
3709 "fork1() -> pid\n\n\
3710 Fork a child process with a single multiplexed (i.e., not bound) thread.\n\
3712 Return 0 to child process and PID of child to parent process.");
3714 static PyObject *
3715 posix_fork1(PyObject *self, PyObject *noargs)
3717 pid_t pid = fork1();
3718 if (pid == -1)
3719 return posix_error();
3720 if (pid == 0)
3721 PyOS_AfterFork();
3722 return PyInt_FromLong(pid);
3724 #endif
3727 #ifdef HAVE_FORK
3728 PyDoc_STRVAR(posix_fork__doc__,
3729 "fork() -> pid\n\n\
3730 Fork a child process.\n\
3731 Return 0 to child process and PID of child to parent process.");
3733 static PyObject *
3734 posix_fork(PyObject *self, PyObject *noargs)
3736 pid_t pid = fork();
3737 if (pid == -1)
3738 return posix_error();
3739 if (pid == 0)
3740 PyOS_AfterFork();
3741 return PyInt_FromLong(pid);
3743 #endif
3745 /* AIX uses /dev/ptc but is otherwise the same as /dev/ptmx */
3746 /* IRIX has both /dev/ptc and /dev/ptmx, use ptmx */
3747 #if defined(HAVE_DEV_PTC) && !defined(HAVE_DEV_PTMX)
3748 #define DEV_PTY_FILE "/dev/ptc"
3749 #define HAVE_DEV_PTMX
3750 #else
3751 #define DEV_PTY_FILE "/dev/ptmx"
3752 #endif
3754 #if defined(HAVE_OPENPTY) || defined(HAVE_FORKPTY) || defined(HAVE_DEV_PTMX)
3755 #ifdef HAVE_PTY_H
3756 #include <pty.h>
3757 #else
3758 #ifdef HAVE_LIBUTIL_H
3759 #include <libutil.h>
3760 #endif /* HAVE_LIBUTIL_H */
3761 #endif /* HAVE_PTY_H */
3762 #ifdef HAVE_STROPTS_H
3763 #include <stropts.h>
3764 #endif
3765 #endif /* defined(HAVE_OPENPTY) || defined(HAVE_FORKPTY) || defined(HAVE_DEV_PTMX */
3767 #if defined(HAVE_OPENPTY) || defined(HAVE__GETPTY) || defined(HAVE_DEV_PTMX)
3768 PyDoc_STRVAR(posix_openpty__doc__,
3769 "openpty() -> (master_fd, slave_fd)\n\n\
3770 Open a pseudo-terminal, returning open fd's for both master and slave end.\n");
3772 static PyObject *
3773 posix_openpty(PyObject *self, PyObject *noargs)
3775 int master_fd, slave_fd;
3776 #ifndef HAVE_OPENPTY
3777 char * slave_name;
3778 #endif
3779 #if defined(HAVE_DEV_PTMX) && !defined(HAVE_OPENPTY) && !defined(HAVE__GETPTY)
3780 PyOS_sighandler_t sig_saved;
3781 #ifdef sun
3782 extern char *ptsname(int fildes);
3783 #endif
3784 #endif
3786 #ifdef HAVE_OPENPTY
3787 if (openpty(&master_fd, &slave_fd, NULL, NULL, NULL) != 0)
3788 return posix_error();
3789 #elif defined(HAVE__GETPTY)
3790 slave_name = _getpty(&master_fd, O_RDWR, 0666, 0);
3791 if (slave_name == NULL)
3792 return posix_error();
3794 slave_fd = open(slave_name, O_RDWR);
3795 if (slave_fd < 0)
3796 return posix_error();
3797 #else
3798 master_fd = open(DEV_PTY_FILE, O_RDWR | O_NOCTTY); /* open master */
3799 if (master_fd < 0)
3800 return posix_error();
3801 sig_saved = PyOS_setsig(SIGCHLD, SIG_DFL);
3802 /* change permission of slave */
3803 if (grantpt(master_fd) < 0) {
3804 PyOS_setsig(SIGCHLD, sig_saved);
3805 return posix_error();
3807 /* unlock slave */
3808 if (unlockpt(master_fd) < 0) {
3809 PyOS_setsig(SIGCHLD, sig_saved);
3810 return posix_error();
3812 PyOS_setsig(SIGCHLD, sig_saved);
3813 slave_name = ptsname(master_fd); /* get name of slave */
3814 if (slave_name == NULL)
3815 return posix_error();
3816 slave_fd = open(slave_name, O_RDWR | O_NOCTTY); /* open slave */
3817 if (slave_fd < 0)
3818 return posix_error();
3819 #if !defined(__CYGWIN__) && !defined(HAVE_DEV_PTC)
3820 ioctl(slave_fd, I_PUSH, "ptem"); /* push ptem */
3821 ioctl(slave_fd, I_PUSH, "ldterm"); /* push ldterm */
3822 #ifndef __hpux
3823 ioctl(slave_fd, I_PUSH, "ttcompat"); /* push ttcompat */
3824 #endif /* __hpux */
3825 #endif /* HAVE_CYGWIN */
3826 #endif /* HAVE_OPENPTY */
3828 return Py_BuildValue("(ii)", master_fd, slave_fd);
3831 #endif /* defined(HAVE_OPENPTY) || defined(HAVE__GETPTY) || defined(HAVE_DEV_PTMX) */
3833 #ifdef HAVE_FORKPTY
3834 PyDoc_STRVAR(posix_forkpty__doc__,
3835 "forkpty() -> (pid, master_fd)\n\n\
3836 Fork a new process with a new pseudo-terminal as controlling tty.\n\n\
3837 Like fork(), return 0 as pid to child process, and PID of child to parent.\n\
3838 To both, return fd of newly opened pseudo-terminal.\n");
3840 static PyObject *
3841 posix_forkpty(PyObject *self, PyObject *noargs)
3843 int master_fd = -1;
3844 pid_t pid;
3846 pid = forkpty(&master_fd, NULL, NULL, NULL);
3847 if (pid == -1)
3848 return posix_error();
3849 if (pid == 0)
3850 PyOS_AfterFork();
3851 return Py_BuildValue("(li)", pid, master_fd);
3853 #endif
3855 #ifdef HAVE_GETEGID
3856 PyDoc_STRVAR(posix_getegid__doc__,
3857 "getegid() -> egid\n\n\
3858 Return the current process's effective group id.");
3860 static PyObject *
3861 posix_getegid(PyObject *self, PyObject *noargs)
3863 return PyInt_FromLong((long)getegid());
3865 #endif
3868 #ifdef HAVE_GETEUID
3869 PyDoc_STRVAR(posix_geteuid__doc__,
3870 "geteuid() -> euid\n\n\
3871 Return the current process's effective user id.");
3873 static PyObject *
3874 posix_geteuid(PyObject *self, PyObject *noargs)
3876 return PyInt_FromLong((long)geteuid());
3878 #endif
3881 #ifdef HAVE_GETGID
3882 PyDoc_STRVAR(posix_getgid__doc__,
3883 "getgid() -> gid\n\n\
3884 Return the current process's group id.");
3886 static PyObject *
3887 posix_getgid(PyObject *self, PyObject *noargs)
3889 return PyInt_FromLong((long)getgid());
3891 #endif
3894 PyDoc_STRVAR(posix_getpid__doc__,
3895 "getpid() -> pid\n\n\
3896 Return the current process id");
3898 static PyObject *
3899 posix_getpid(PyObject *self, PyObject *noargs)
3901 return PyInt_FromLong((long)getpid());
3905 #ifdef HAVE_GETGROUPS
3906 PyDoc_STRVAR(posix_getgroups__doc__,
3907 "getgroups() -> list of group IDs\n\n\
3908 Return list of supplemental group IDs for the process.");
3910 static PyObject *
3911 posix_getgroups(PyObject *self, PyObject *noargs)
3913 PyObject *result = NULL;
3915 #ifdef NGROUPS_MAX
3916 #define MAX_GROUPS NGROUPS_MAX
3917 #else
3918 /* defined to be 16 on Solaris7, so this should be a small number */
3919 #define MAX_GROUPS 64
3920 #endif
3921 gid_t grouplist[MAX_GROUPS];
3922 int n;
3924 n = getgroups(MAX_GROUPS, grouplist);
3925 if (n < 0)
3926 posix_error();
3927 else {
3928 result = PyList_New(n);
3929 if (result != NULL) {
3930 int i;
3931 for (i = 0; i < n; ++i) {
3932 PyObject *o = PyInt_FromLong((long)grouplist[i]);
3933 if (o == NULL) {
3934 Py_DECREF(result);
3935 result = NULL;
3936 break;
3938 PyList_SET_ITEM(result, i, o);
3943 return result;
3945 #endif
3947 #ifdef HAVE_GETPGID
3948 PyDoc_STRVAR(posix_getpgid__doc__,
3949 "getpgid(pid) -> pgid\n\n\
3950 Call the system call getpgid().");
3952 static PyObject *
3953 posix_getpgid(PyObject *self, PyObject *args)
3955 int pid, pgid;
3956 if (!PyArg_ParseTuple(args, "i:getpgid", &pid))
3957 return NULL;
3958 pgid = getpgid(pid);
3959 if (pgid < 0)
3960 return posix_error();
3961 return PyInt_FromLong((long)pgid);
3963 #endif /* HAVE_GETPGID */
3966 #ifdef HAVE_GETPGRP
3967 PyDoc_STRVAR(posix_getpgrp__doc__,
3968 "getpgrp() -> pgrp\n\n\
3969 Return the current process group id.");
3971 static PyObject *
3972 posix_getpgrp(PyObject *self, PyObject *noargs)
3974 #ifdef GETPGRP_HAVE_ARG
3975 return PyInt_FromLong((long)getpgrp(0));
3976 #else /* GETPGRP_HAVE_ARG */
3977 return PyInt_FromLong((long)getpgrp());
3978 #endif /* GETPGRP_HAVE_ARG */
3980 #endif /* HAVE_GETPGRP */
3983 #ifdef HAVE_SETPGRP
3984 PyDoc_STRVAR(posix_setpgrp__doc__,
3985 "setpgrp()\n\n\
3986 Make this process a session leader.");
3988 static PyObject *
3989 posix_setpgrp(PyObject *self, PyObject *noargs)
3991 #ifdef SETPGRP_HAVE_ARG
3992 if (setpgrp(0, 0) < 0)
3993 #else /* SETPGRP_HAVE_ARG */
3994 if (setpgrp() < 0)
3995 #endif /* SETPGRP_HAVE_ARG */
3996 return posix_error();
3997 Py_INCREF(Py_None);
3998 return Py_None;
4001 #endif /* HAVE_SETPGRP */
4003 #ifdef HAVE_GETPPID
4004 PyDoc_STRVAR(posix_getppid__doc__,
4005 "getppid() -> ppid\n\n\
4006 Return the parent's process id.");
4008 static PyObject *
4009 posix_getppid(PyObject *self, PyObject *noargs)
4011 return PyInt_FromLong(getppid());
4013 #endif
4016 #ifdef HAVE_GETLOGIN
4017 PyDoc_STRVAR(posix_getlogin__doc__,
4018 "getlogin() -> string\n\n\
4019 Return the actual login name.");
4021 static PyObject *
4022 posix_getlogin(PyObject *self, PyObject *noargs)
4024 PyObject *result = NULL;
4025 char *name;
4026 int old_errno = errno;
4028 errno = 0;
4029 name = getlogin();
4030 if (name == NULL) {
4031 if (errno)
4032 posix_error();
4033 else
4034 PyErr_SetString(PyExc_OSError,
4035 "unable to determine login name");
4037 else
4038 result = PyString_FromString(name);
4039 errno = old_errno;
4041 return result;
4043 #endif
4045 #ifdef HAVE_GETUID
4046 PyDoc_STRVAR(posix_getuid__doc__,
4047 "getuid() -> uid\n\n\
4048 Return the current process's user id.");
4050 static PyObject *
4051 posix_getuid(PyObject *self, PyObject *noargs)
4053 return PyInt_FromLong((long)getuid());
4055 #endif
4058 #ifdef HAVE_KILL
4059 PyDoc_STRVAR(posix_kill__doc__,
4060 "kill(pid, sig)\n\n\
4061 Kill a process with a signal.");
4063 static PyObject *
4064 posix_kill(PyObject *self, PyObject *args)
4066 pid_t pid;
4067 int sig;
4068 if (!PyArg_ParseTuple(args, "ii:kill", &pid, &sig))
4069 return NULL;
4070 #if defined(PYOS_OS2) && !defined(PYCC_GCC)
4071 if (sig == XCPT_SIGNAL_INTR || sig == XCPT_SIGNAL_BREAK) {
4072 APIRET rc;
4073 if ((rc = DosSendSignalException(pid, sig)) != NO_ERROR)
4074 return os2_error(rc);
4076 } else if (sig == XCPT_SIGNAL_KILLPROC) {
4077 APIRET rc;
4078 if ((rc = DosKillProcess(DKP_PROCESS, pid)) != NO_ERROR)
4079 return os2_error(rc);
4081 } else
4082 return NULL; /* Unrecognized Signal Requested */
4083 #else
4084 if (kill(pid, sig) == -1)
4085 return posix_error();
4086 #endif
4087 Py_INCREF(Py_None);
4088 return Py_None;
4090 #endif
4092 #ifdef HAVE_KILLPG
4093 PyDoc_STRVAR(posix_killpg__doc__,
4094 "killpg(pgid, sig)\n\n\
4095 Kill a process group with a signal.");
4097 static PyObject *
4098 posix_killpg(PyObject *self, PyObject *args)
4100 int pgid, sig;
4101 if (!PyArg_ParseTuple(args, "ii:killpg", &pgid, &sig))
4102 return NULL;
4103 if (killpg(pgid, sig) == -1)
4104 return posix_error();
4105 Py_INCREF(Py_None);
4106 return Py_None;
4108 #endif
4110 #ifdef HAVE_PLOCK
4112 #ifdef HAVE_SYS_LOCK_H
4113 #include <sys/lock.h>
4114 #endif
4116 PyDoc_STRVAR(posix_plock__doc__,
4117 "plock(op)\n\n\
4118 Lock program segments into memory.");
4120 static PyObject *
4121 posix_plock(PyObject *self, PyObject *args)
4123 int op;
4124 if (!PyArg_ParseTuple(args, "i:plock", &op))
4125 return NULL;
4126 if (plock(op) == -1)
4127 return posix_error();
4128 Py_INCREF(Py_None);
4129 return Py_None;
4131 #endif
4134 #ifdef HAVE_POPEN
4135 PyDoc_STRVAR(posix_popen__doc__,
4136 "popen(command [, mode='r' [, bufsize]]) -> pipe\n\n\
4137 Open a pipe to/from a command returning a file object.");
4139 #if defined(PYOS_OS2)
4140 #if defined(PYCC_VACPP)
4141 static int
4142 async_system(const char *command)
4144 char errormsg[256], args[1024];
4145 RESULTCODES rcodes;
4146 APIRET rc;
4148 char *shell = getenv("COMSPEC");
4149 if (!shell)
4150 shell = "cmd";
4152 /* avoid overflowing the argument buffer */
4153 if (strlen(shell) + 3 + strlen(command) >= 1024)
4154 return ERROR_NOT_ENOUGH_MEMORY
4156 args[0] = '\0';
4157 strcat(args, shell);
4158 strcat(args, "/c ");
4159 strcat(args, command);
4161 /* execute asynchronously, inheriting the environment */
4162 rc = DosExecPgm(errormsg,
4163 sizeof(errormsg),
4164 EXEC_ASYNC,
4165 args,
4166 NULL,
4167 &rcodes,
4168 shell);
4169 return rc;
4172 static FILE *
4173 popen(const char *command, const char *mode, int pipesize, int *err)
4175 int oldfd, tgtfd;
4176 HFILE pipeh[2];
4177 APIRET rc;
4179 /* mode determines which of stdin or stdout is reconnected to
4180 * the pipe to the child
4182 if (strchr(mode, 'r') != NULL) {
4183 tgt_fd = 1; /* stdout */
4184 } else if (strchr(mode, 'w')) {
4185 tgt_fd = 0; /* stdin */
4186 } else {
4187 *err = ERROR_INVALID_ACCESS;
4188 return NULL;
4191 /* setup the pipe */
4192 if ((rc = DosCreatePipe(&pipeh[0], &pipeh[1], pipesize)) != NO_ERROR) {
4193 *err = rc;
4194 return NULL;
4197 /* prevent other threads accessing stdio */
4198 DosEnterCritSec();
4200 /* reconnect stdio and execute child */
4201 oldfd = dup(tgtfd);
4202 close(tgtfd);
4203 if (dup2(pipeh[tgtfd], tgtfd) == 0) {
4204 DosClose(pipeh[tgtfd]);
4205 rc = async_system(command);
4208 /* restore stdio */
4209 dup2(oldfd, tgtfd);
4210 close(oldfd);
4212 /* allow other threads access to stdio */
4213 DosExitCritSec();
4215 /* if execution of child was successful return file stream */
4216 if (rc == NO_ERROR)
4217 return fdopen(pipeh[1 - tgtfd], mode);
4218 else {
4219 DosClose(pipeh[1 - tgtfd]);
4220 *err = rc;
4221 return NULL;
4225 static PyObject *
4226 posix_popen(PyObject *self, PyObject *args)
4228 char *name;
4229 char *mode = "r";
4230 int err, bufsize = -1;
4231 FILE *fp;
4232 PyObject *f;
4233 if (!PyArg_ParseTuple(args, "s|si:popen", &name, &mode, &bufsize))
4234 return NULL;
4235 Py_BEGIN_ALLOW_THREADS
4236 fp = popen(name, mode, (bufsize > 0) ? bufsize : 4096, &err);
4237 Py_END_ALLOW_THREADS
4238 if (fp == NULL)
4239 return os2_error(err);
4241 f = PyFile_FromFile(fp, name, mode, fclose);
4242 if (f != NULL)
4243 PyFile_SetBufSize(f, bufsize);
4244 return f;
4247 #elif defined(PYCC_GCC)
4249 /* standard posix version of popen() support */
4250 static PyObject *
4251 posix_popen(PyObject *self, PyObject *args)
4253 char *name;
4254 char *mode = "r";
4255 int bufsize = -1;
4256 FILE *fp;
4257 PyObject *f;
4258 if (!PyArg_ParseTuple(args, "s|si:popen", &name, &mode, &bufsize))
4259 return NULL;
4260 Py_BEGIN_ALLOW_THREADS
4261 fp = popen(name, mode);
4262 Py_END_ALLOW_THREADS
4263 if (fp == NULL)
4264 return posix_error();
4265 f = PyFile_FromFile(fp, name, mode, pclose);
4266 if (f != NULL)
4267 PyFile_SetBufSize(f, bufsize);
4268 return f;
4271 /* fork() under OS/2 has lots'o'warts
4272 * EMX supports pipe() and spawn*() so we can synthesize popen[234]()
4273 * most of this code is a ripoff of the win32 code, but using the
4274 * capabilities of EMX's C library routines
4277 /* These tell _PyPopen() whether to return 1, 2, or 3 file objects. */
4278 #define POPEN_1 1
4279 #define POPEN_2 2
4280 #define POPEN_3 3
4281 #define POPEN_4 4
4283 static PyObject *_PyPopen(char *, int, int, int);
4284 static int _PyPclose(FILE *file);
4287 * Internal dictionary mapping popen* file pointers to process handles,
4288 * for use when retrieving the process exit code. See _PyPclose() below
4289 * for more information on this dictionary's use.
4291 static PyObject *_PyPopenProcs = NULL;
4293 /* os2emx version of popen2()
4295 * The result of this function is a pipe (file) connected to the
4296 * process's stdin, and a pipe connected to the process's stdout.
4299 static PyObject *
4300 os2emx_popen2(PyObject *self, PyObject *args)
4302 PyObject *f;
4303 int tm=0;
4305 char *cmdstring;
4306 char *mode = "t";
4307 int bufsize = -1;
4308 if (!PyArg_ParseTuple(args, "s|si:popen2", &cmdstring, &mode, &bufsize))
4309 return NULL;
4311 if (*mode == 't')
4312 tm = O_TEXT;
4313 else if (*mode != 'b') {
4314 PyErr_SetString(PyExc_ValueError, "mode must be 't' or 'b'");
4315 return NULL;
4316 } else
4317 tm = O_BINARY;
4319 f = _PyPopen(cmdstring, tm, POPEN_2, bufsize);
4321 return f;
4325 * Variation on os2emx.popen2
4327 * The result of this function is 3 pipes - the process's stdin,
4328 * stdout and stderr
4331 static PyObject *
4332 os2emx_popen3(PyObject *self, PyObject *args)
4334 PyObject *f;
4335 int tm = 0;
4337 char *cmdstring;
4338 char *mode = "t";
4339 int bufsize = -1;
4340 if (!PyArg_ParseTuple(args, "s|si:popen3", &cmdstring, &mode, &bufsize))
4341 return NULL;
4343 if (*mode == 't')
4344 tm = O_TEXT;
4345 else if (*mode != 'b') {
4346 PyErr_SetString(PyExc_ValueError, "mode must be 't' or 'b'");
4347 return NULL;
4348 } else
4349 tm = O_BINARY;
4351 f = _PyPopen(cmdstring, tm, POPEN_3, bufsize);
4353 return f;
4357 * Variation on os2emx.popen2
4359 * The result of this function is 2 pipes - the processes stdin,
4360 * and stdout+stderr combined as a single pipe.
4363 static PyObject *
4364 os2emx_popen4(PyObject *self, PyObject *args)
4366 PyObject *f;
4367 int tm = 0;
4369 char *cmdstring;
4370 char *mode = "t";
4371 int bufsize = -1;
4372 if (!PyArg_ParseTuple(args, "s|si:popen4", &cmdstring, &mode, &bufsize))
4373 return NULL;
4375 if (*mode == 't')
4376 tm = O_TEXT;
4377 else if (*mode != 'b') {
4378 PyErr_SetString(PyExc_ValueError, "mode must be 't' or 'b'");
4379 return NULL;
4380 } else
4381 tm = O_BINARY;
4383 f = _PyPopen(cmdstring, tm, POPEN_4, bufsize);
4385 return f;
4388 /* a couple of structures for convenient handling of multiple
4389 * file handles and pipes
4391 struct file_ref
4393 int handle;
4394 int flags;
4397 struct pipe_ref
4399 int rd;
4400 int wr;
4403 /* The following code is derived from the win32 code */
4405 static PyObject *
4406 _PyPopen(char *cmdstring, int mode, int n, int bufsize)
4408 struct file_ref stdio[3];
4409 struct pipe_ref p_fd[3];
4410 FILE *p_s[3];
4411 int file_count, i, pipe_err;
4412 pid_t pipe_pid;
4413 char *shell, *sh_name, *opt, *rd_mode, *wr_mode;
4414 PyObject *f, *p_f[3];
4416 /* file modes for subsequent fdopen's on pipe handles */
4417 if (mode == O_TEXT)
4419 rd_mode = "rt";
4420 wr_mode = "wt";
4422 else
4424 rd_mode = "rb";
4425 wr_mode = "wb";
4428 /* prepare shell references */
4429 if ((shell = getenv("EMXSHELL")) == NULL)
4430 if ((shell = getenv("COMSPEC")) == NULL)
4432 errno = ENOENT;
4433 return posix_error();
4436 sh_name = _getname(shell);
4437 if (stricmp(sh_name, "cmd.exe") == 0 || stricmp(sh_name, "4os2.exe") == 0)
4438 opt = "/c";
4439 else
4440 opt = "-c";
4442 /* save current stdio fds + their flags, and set not inheritable */
4443 i = pipe_err = 0;
4444 while (pipe_err >= 0 && i < 3)
4446 pipe_err = stdio[i].handle = dup(i);
4447 stdio[i].flags = fcntl(i, F_GETFD, 0);
4448 fcntl(stdio[i].handle, F_SETFD, stdio[i].flags | FD_CLOEXEC);
4449 i++;
4451 if (pipe_err < 0)
4453 /* didn't get them all saved - clean up and bail out */
4454 int saved_err = errno;
4455 while (i-- > 0)
4457 close(stdio[i].handle);
4459 errno = saved_err;
4460 return posix_error();
4463 /* create pipe ends */
4464 file_count = 2;
4465 if (n == POPEN_3)
4466 file_count = 3;
4467 i = pipe_err = 0;
4468 while ((pipe_err == 0) && (i < file_count))
4469 pipe_err = pipe((int *)&p_fd[i++]);
4470 if (pipe_err < 0)
4472 /* didn't get them all made - clean up and bail out */
4473 while (i-- > 0)
4475 close(p_fd[i].wr);
4476 close(p_fd[i].rd);
4478 errno = EPIPE;
4479 return posix_error();
4482 /* change the actual standard IO streams over temporarily,
4483 * making the retained pipe ends non-inheritable
4485 pipe_err = 0;
4487 /* - stdin */
4488 if (dup2(p_fd[0].rd, 0) == 0)
4490 close(p_fd[0].rd);
4491 i = fcntl(p_fd[0].wr, F_GETFD, 0);
4492 fcntl(p_fd[0].wr, F_SETFD, i | FD_CLOEXEC);
4493 if ((p_s[0] = fdopen(p_fd[0].wr, wr_mode)) == NULL)
4495 close(p_fd[0].wr);
4496 pipe_err = -1;
4499 else
4501 pipe_err = -1;
4504 /* - stdout */
4505 if (pipe_err == 0)
4507 if (dup2(p_fd[1].wr, 1) == 1)
4509 close(p_fd[1].wr);
4510 i = fcntl(p_fd[1].rd, F_GETFD, 0);
4511 fcntl(p_fd[1].rd, F_SETFD, i | FD_CLOEXEC);
4512 if ((p_s[1] = fdopen(p_fd[1].rd, rd_mode)) == NULL)
4514 close(p_fd[1].rd);
4515 pipe_err = -1;
4518 else
4520 pipe_err = -1;
4524 /* - stderr, as required */
4525 if (pipe_err == 0)
4526 switch (n)
4528 case POPEN_3:
4530 if (dup2(p_fd[2].wr, 2) == 2)
4532 close(p_fd[2].wr);
4533 i = fcntl(p_fd[2].rd, F_GETFD, 0);
4534 fcntl(p_fd[2].rd, F_SETFD, i | FD_CLOEXEC);
4535 if ((p_s[2] = fdopen(p_fd[2].rd, rd_mode)) == NULL)
4537 close(p_fd[2].rd);
4538 pipe_err = -1;
4541 else
4543 pipe_err = -1;
4545 break;
4548 case POPEN_4:
4550 if (dup2(1, 2) != 2)
4552 pipe_err = -1;
4554 break;
4558 /* spawn the child process */
4559 if (pipe_err == 0)
4561 pipe_pid = spawnlp(P_NOWAIT, shell, shell, opt, cmdstring, (char *)0);
4562 if (pipe_pid == -1)
4564 pipe_err = -1;
4566 else
4568 /* save the PID into the FILE structure
4569 * NOTE: this implementation doesn't actually
4570 * take advantage of this, but do it for
4571 * completeness - AIM Apr01
4573 for (i = 0; i < file_count; i++)
4574 p_s[i]->_pid = pipe_pid;
4578 /* reset standard IO to normal */
4579 for (i = 0; i < 3; i++)
4581 dup2(stdio[i].handle, i);
4582 fcntl(i, F_SETFD, stdio[i].flags);
4583 close(stdio[i].handle);
4586 /* if any remnant problems, clean up and bail out */
4587 if (pipe_err < 0)
4589 for (i = 0; i < 3; i++)
4591 close(p_fd[i].rd);
4592 close(p_fd[i].wr);
4594 errno = EPIPE;
4595 return posix_error_with_filename(cmdstring);
4598 /* build tuple of file objects to return */
4599 if ((p_f[0] = PyFile_FromFile(p_s[0], cmdstring, wr_mode, _PyPclose)) != NULL)
4600 PyFile_SetBufSize(p_f[0], bufsize);
4601 if ((p_f[1] = PyFile_FromFile(p_s[1], cmdstring, rd_mode, _PyPclose)) != NULL)
4602 PyFile_SetBufSize(p_f[1], bufsize);
4603 if (n == POPEN_3)
4605 if ((p_f[2] = PyFile_FromFile(p_s[2], cmdstring, rd_mode, _PyPclose)) != NULL)
4606 PyFile_SetBufSize(p_f[0], bufsize);
4607 f = PyTuple_Pack(3, p_f[0], p_f[1], p_f[2]);
4609 else
4610 f = PyTuple_Pack(2, p_f[0], p_f[1]);
4613 * Insert the files we've created into the process dictionary
4614 * all referencing the list with the process handle and the
4615 * initial number of files (see description below in _PyPclose).
4616 * Since if _PyPclose later tried to wait on a process when all
4617 * handles weren't closed, it could create a deadlock with the
4618 * child, we spend some energy here to try to ensure that we
4619 * either insert all file handles into the dictionary or none
4620 * at all. It's a little clumsy with the various popen modes
4621 * and variable number of files involved.
4623 if (!_PyPopenProcs)
4625 _PyPopenProcs = PyDict_New();
4628 if (_PyPopenProcs)
4630 PyObject *procObj, *pidObj, *intObj, *fileObj[3];
4631 int ins_rc[3];
4633 fileObj[0] = fileObj[1] = fileObj[2] = NULL;
4634 ins_rc[0] = ins_rc[1] = ins_rc[2] = 0;
4636 procObj = PyList_New(2);
4637 pidObj = PyInt_FromLong((long) pipe_pid);
4638 intObj = PyInt_FromLong((long) file_count);
4640 if (procObj && pidObj && intObj)
4642 PyList_SetItem(procObj, 0, pidObj);
4643 PyList_SetItem(procObj, 1, intObj);
4645 fileObj[0] = PyLong_FromVoidPtr(p_s[0]);
4646 if (fileObj[0])
4648 ins_rc[0] = PyDict_SetItem(_PyPopenProcs,
4649 fileObj[0],
4650 procObj);
4652 fileObj[1] = PyLong_FromVoidPtr(p_s[1]);
4653 if (fileObj[1])
4655 ins_rc[1] = PyDict_SetItem(_PyPopenProcs,
4656 fileObj[1],
4657 procObj);
4659 if (file_count >= 3)
4661 fileObj[2] = PyLong_FromVoidPtr(p_s[2]);
4662 if (fileObj[2])
4664 ins_rc[2] = PyDict_SetItem(_PyPopenProcs,
4665 fileObj[2],
4666 procObj);
4670 if (ins_rc[0] < 0 || !fileObj[0] ||
4671 ins_rc[1] < 0 || (file_count > 1 && !fileObj[1]) ||
4672 ins_rc[2] < 0 || (file_count > 2 && !fileObj[2]))
4674 /* Something failed - remove any dictionary
4675 * entries that did make it.
4677 if (!ins_rc[0] && fileObj[0])
4679 PyDict_DelItem(_PyPopenProcs,
4680 fileObj[0]);
4682 if (!ins_rc[1] && fileObj[1])
4684 PyDict_DelItem(_PyPopenProcs,
4685 fileObj[1]);
4687 if (!ins_rc[2] && fileObj[2])
4689 PyDict_DelItem(_PyPopenProcs,
4690 fileObj[2]);
4696 * Clean up our localized references for the dictionary keys
4697 * and value since PyDict_SetItem will Py_INCREF any copies
4698 * that got placed in the dictionary.
4700 Py_XDECREF(procObj);
4701 Py_XDECREF(fileObj[0]);
4702 Py_XDECREF(fileObj[1]);
4703 Py_XDECREF(fileObj[2]);
4706 /* Child is launched. */
4707 return f;
4711 * Wrapper for fclose() to use for popen* files, so we can retrieve the
4712 * exit code for the child process and return as a result of the close.
4714 * This function uses the _PyPopenProcs dictionary in order to map the
4715 * input file pointer to information about the process that was
4716 * originally created by the popen* call that created the file pointer.
4717 * The dictionary uses the file pointer as a key (with one entry
4718 * inserted for each file returned by the original popen* call) and a
4719 * single list object as the value for all files from a single call.
4720 * The list object contains the Win32 process handle at [0], and a file
4721 * count at [1], which is initialized to the total number of file
4722 * handles using that list.
4724 * This function closes whichever handle it is passed, and decrements
4725 * the file count in the dictionary for the process handle pointed to
4726 * by this file. On the last close (when the file count reaches zero),
4727 * this function will wait for the child process and then return its
4728 * exit code as the result of the close() operation. This permits the
4729 * files to be closed in any order - it is always the close() of the
4730 * final handle that will return the exit code.
4732 * NOTE: This function is currently called with the GIL released.
4733 * hence we use the GILState API to manage our state.
4736 static int _PyPclose(FILE *file)
4738 int result;
4739 int exit_code;
4740 pid_t pipe_pid;
4741 PyObject *procObj, *pidObj, *intObj, *fileObj;
4742 int file_count;
4743 #ifdef WITH_THREAD
4744 PyGILState_STATE state;
4745 #endif
4747 /* Close the file handle first, to ensure it can't block the
4748 * child from exiting if it's the last handle.
4750 result = fclose(file);
4752 #ifdef WITH_THREAD
4753 state = PyGILState_Ensure();
4754 #endif
4755 if (_PyPopenProcs)
4757 if ((fileObj = PyLong_FromVoidPtr(file)) != NULL &&
4758 (procObj = PyDict_GetItem(_PyPopenProcs,
4759 fileObj)) != NULL &&
4760 (pidObj = PyList_GetItem(procObj,0)) != NULL &&
4761 (intObj = PyList_GetItem(procObj,1)) != NULL)
4763 pipe_pid = (int) PyInt_AsLong(pidObj);
4764 file_count = (int) PyInt_AsLong(intObj);
4766 if (file_count > 1)
4768 /* Still other files referencing process */
4769 file_count--;
4770 PyList_SetItem(procObj,1,
4771 PyInt_FromLong((long) file_count));
4773 else
4775 /* Last file for this process */
4776 if (result != EOF &&
4777 waitpid(pipe_pid, &exit_code, 0) == pipe_pid)
4779 /* extract exit status */
4780 if (WIFEXITED(exit_code))
4782 result = WEXITSTATUS(exit_code);
4784 else
4786 errno = EPIPE;
4787 result = -1;
4790 else
4792 /* Indicate failure - this will cause the file object
4793 * to raise an I/O error and translate the last
4794 * error code from errno. We do have a problem with
4795 * last errors that overlap the normal errno table,
4796 * but that's a consistent problem with the file object.
4798 result = -1;
4802 /* Remove this file pointer from dictionary */
4803 PyDict_DelItem(_PyPopenProcs, fileObj);
4805 if (PyDict_Size(_PyPopenProcs) == 0)
4807 Py_DECREF(_PyPopenProcs);
4808 _PyPopenProcs = NULL;
4811 } /* if object retrieval ok */
4813 Py_XDECREF(fileObj);
4814 } /* if _PyPopenProcs */
4816 #ifdef WITH_THREAD
4817 PyGILState_Release(state);
4818 #endif
4819 return result;
4822 #endif /* PYCC_??? */
4824 #elif defined(MS_WINDOWS)
4827 * Portable 'popen' replacement for Win32.
4829 * Written by Bill Tutt <billtut@microsoft.com>. Minor tweaks
4830 * and 2.0 integration by Fredrik Lundh <fredrik@pythonware.com>
4831 * Return code handling by David Bolen <db3l@fitlinxx.com>.
4834 #include <malloc.h>
4835 #include <io.h>
4836 #include <fcntl.h>
4838 /* These tell _PyPopen() wether to return 1, 2, or 3 file objects. */
4839 #define POPEN_1 1
4840 #define POPEN_2 2
4841 #define POPEN_3 3
4842 #define POPEN_4 4
4844 static PyObject *_PyPopen(char *, int, int);
4845 static int _PyPclose(FILE *file);
4848 * Internal dictionary mapping popen* file pointers to process handles,
4849 * for use when retrieving the process exit code. See _PyPclose() below
4850 * for more information on this dictionary's use.
4852 static PyObject *_PyPopenProcs = NULL;
4855 /* popen that works from a GUI.
4857 * The result of this function is a pipe (file) connected to the
4858 * processes stdin or stdout, depending on the requested mode.
4861 static PyObject *
4862 posix_popen(PyObject *self, PyObject *args)
4864 PyObject *f;
4865 int tm = 0;
4867 char *cmdstring;
4868 char *mode = "r";
4869 int bufsize = -1;
4870 if (!PyArg_ParseTuple(args, "s|si:popen", &cmdstring, &mode, &bufsize))
4871 return NULL;
4873 if (*mode == 'r')
4874 tm = _O_RDONLY;
4875 else if (*mode != 'w') {
4876 PyErr_SetString(PyExc_ValueError, "popen() arg 2 must be 'r' or 'w'");
4877 return NULL;
4878 } else
4879 tm = _O_WRONLY;
4881 if (bufsize != -1) {
4882 PyErr_SetString(PyExc_ValueError, "popen() arg 3 must be -1");
4883 return NULL;
4886 if (*(mode+1) == 't')
4887 f = _PyPopen(cmdstring, tm | _O_TEXT, POPEN_1);
4888 else if (*(mode+1) == 'b')
4889 f = _PyPopen(cmdstring, tm | _O_BINARY, POPEN_1);
4890 else
4891 f = _PyPopen(cmdstring, tm | _O_TEXT, POPEN_1);
4893 return f;
4896 /* Variation on win32pipe.popen
4898 * The result of this function is a pipe (file) connected to the
4899 * process's stdin, and a pipe connected to the process's stdout.
4902 static PyObject *
4903 win32_popen2(PyObject *self, PyObject *args)
4905 PyObject *f;
4906 int tm=0;
4908 char *cmdstring;
4909 char *mode = "t";
4910 int bufsize = -1;
4911 if (!PyArg_ParseTuple(args, "s|si:popen2", &cmdstring, &mode, &bufsize))
4912 return NULL;
4914 if (*mode == 't')
4915 tm = _O_TEXT;
4916 else if (*mode != 'b') {
4917 PyErr_SetString(PyExc_ValueError, "popen2() arg 2 must be 't' or 'b'");
4918 return NULL;
4919 } else
4920 tm = _O_BINARY;
4922 if (bufsize != -1) {
4923 PyErr_SetString(PyExc_ValueError, "popen2() arg 3 must be -1");
4924 return NULL;
4927 f = _PyPopen(cmdstring, tm, POPEN_2);
4929 return f;
4933 * Variation on <om win32pipe.popen>
4935 * The result of this function is 3 pipes - the process's stdin,
4936 * stdout and stderr
4939 static PyObject *
4940 win32_popen3(PyObject *self, PyObject *args)
4942 PyObject *f;
4943 int tm = 0;
4945 char *cmdstring;
4946 char *mode = "t";
4947 int bufsize = -1;
4948 if (!PyArg_ParseTuple(args, "s|si:popen3", &cmdstring, &mode, &bufsize))
4949 return NULL;
4951 if (*mode == 't')
4952 tm = _O_TEXT;
4953 else if (*mode != 'b') {
4954 PyErr_SetString(PyExc_ValueError, "popen3() arg 2 must be 't' or 'b'");
4955 return NULL;
4956 } else
4957 tm = _O_BINARY;
4959 if (bufsize != -1) {
4960 PyErr_SetString(PyExc_ValueError, "popen3() arg 3 must be -1");
4961 return NULL;
4964 f = _PyPopen(cmdstring, tm, POPEN_3);
4966 return f;
4970 * Variation on win32pipe.popen
4972 * The result of this function is 2 pipes - the processes stdin,
4973 * and stdout+stderr combined as a single pipe.
4976 static PyObject *
4977 win32_popen4(PyObject *self, PyObject *args)
4979 PyObject *f;
4980 int tm = 0;
4982 char *cmdstring;
4983 char *mode = "t";
4984 int bufsize = -1;
4985 if (!PyArg_ParseTuple(args, "s|si:popen4", &cmdstring, &mode, &bufsize))
4986 return NULL;
4988 if (*mode == 't')
4989 tm = _O_TEXT;
4990 else if (*mode != 'b') {
4991 PyErr_SetString(PyExc_ValueError, "popen4() arg 2 must be 't' or 'b'");
4992 return NULL;
4993 } else
4994 tm = _O_BINARY;
4996 if (bufsize != -1) {
4997 PyErr_SetString(PyExc_ValueError, "popen4() arg 3 must be -1");
4998 return NULL;
5001 f = _PyPopen(cmdstring, tm, POPEN_4);
5003 return f;
5006 static BOOL
5007 _PyPopenCreateProcess(char *cmdstring,
5008 HANDLE hStdin,
5009 HANDLE hStdout,
5010 HANDLE hStderr,
5011 HANDLE *hProcess)
5013 PROCESS_INFORMATION piProcInfo;
5014 STARTUPINFO siStartInfo;
5015 DWORD dwProcessFlags = 0; /* no NEW_CONSOLE by default for Ctrl+C handling */
5016 char *s1,*s2, *s3 = " /c ";
5017 const char *szConsoleSpawn = "w9xpopen.exe";
5018 int i;
5019 Py_ssize_t x;
5021 if (i = GetEnvironmentVariable("COMSPEC",NULL,0)) {
5022 char *comshell;
5024 s1 = (char *)alloca(i);
5025 if (!(x = GetEnvironmentVariable("COMSPEC", s1, i)))
5026 /* x < i, so x fits into an integer */
5027 return (int)x;
5029 /* Explicitly check if we are using COMMAND.COM. If we are
5030 * then use the w9xpopen hack.
5032 comshell = s1 + x;
5033 while (comshell >= s1 && *comshell != '\\')
5034 --comshell;
5035 ++comshell;
5037 if (GetVersion() < 0x80000000 &&
5038 _stricmp(comshell, "command.com") != 0) {
5039 /* NT/2000 and not using command.com. */
5040 x = i + strlen(s3) + strlen(cmdstring) + 1;
5041 s2 = (char *)alloca(x);
5042 ZeroMemory(s2, x);
5043 PyOS_snprintf(s2, x, "%s%s%s", s1, s3, cmdstring);
5045 else {
5047 * Oh gag, we're on Win9x or using COMMAND.COM. Use
5048 * the workaround listed in KB: Q150956
5050 char modulepath[_MAX_PATH];
5051 struct stat statinfo;
5052 GetModuleFileName(NULL, modulepath, sizeof(modulepath));
5053 for (x = i = 0; modulepath[i]; i++)
5054 if (modulepath[i] == SEP)
5055 x = i+1;
5056 modulepath[x] = '\0';
5057 /* Create the full-name to w9xpopen, so we can test it exists */
5058 strncat(modulepath,
5059 szConsoleSpawn,
5060 (sizeof(modulepath)/sizeof(modulepath[0]))
5061 -strlen(modulepath));
5062 if (stat(modulepath, &statinfo) != 0) {
5063 size_t mplen = sizeof(modulepath)/sizeof(modulepath[0]);
5064 /* Eeek - file-not-found - possibly an embedding
5065 situation - see if we can locate it in sys.prefix
5067 strncpy(modulepath,
5068 Py_GetExecPrefix(),
5069 mplen);
5070 modulepath[mplen-1] = '\0';
5071 if (modulepath[strlen(modulepath)-1] != '\\')
5072 strcat(modulepath, "\\");
5073 strncat(modulepath,
5074 szConsoleSpawn,
5075 mplen-strlen(modulepath));
5076 /* No where else to look - raise an easily identifiable
5077 error, rather than leaving Windows to report
5078 "file not found" - as the user is probably blissfully
5079 unaware this shim EXE is used, and it will confuse them.
5080 (well, it confused me for a while ;-)
5082 if (stat(modulepath, &statinfo) != 0) {
5083 PyErr_Format(PyExc_RuntimeError,
5084 "Can not locate '%s' which is needed "
5085 "for popen to work with your shell "
5086 "or platform.",
5087 szConsoleSpawn);
5088 return FALSE;
5091 x = i + strlen(s3) + strlen(cmdstring) + 1 +
5092 strlen(modulepath) +
5093 strlen(szConsoleSpawn) + 1;
5095 s2 = (char *)alloca(x);
5096 ZeroMemory(s2, x);
5097 /* To maintain correct argument passing semantics,
5098 we pass the command-line as it stands, and allow
5099 quoting to be applied. w9xpopen.exe will then
5100 use its argv vector, and re-quote the necessary
5101 args for the ultimate child process.
5103 PyOS_snprintf(
5104 s2, x,
5105 "\"%s\" %s%s%s",
5106 modulepath,
5109 cmdstring);
5110 /* Not passing CREATE_NEW_CONSOLE has been known to
5111 cause random failures on win9x. Specifically a
5112 dialog:
5113 "Your program accessed mem currently in use at xxx"
5114 and a hopeful warning about the stability of your
5115 system.
5116 Cost is Ctrl+C won't kill children, but anyone
5117 who cares can have a go!
5119 dwProcessFlags |= CREATE_NEW_CONSOLE;
5123 /* Could be an else here to try cmd.exe / command.com in the path
5124 Now we'll just error out.. */
5125 else {
5126 PyErr_SetString(PyExc_RuntimeError,
5127 "Cannot locate a COMSPEC environment variable to "
5128 "use as the shell");
5129 return FALSE;
5132 ZeroMemory(&siStartInfo, sizeof(STARTUPINFO));
5133 siStartInfo.cb = sizeof(STARTUPINFO);
5134 siStartInfo.dwFlags = STARTF_USESTDHANDLES | STARTF_USESHOWWINDOW;
5135 siStartInfo.hStdInput = hStdin;
5136 siStartInfo.hStdOutput = hStdout;
5137 siStartInfo.hStdError = hStderr;
5138 siStartInfo.wShowWindow = SW_HIDE;
5140 if (CreateProcess(NULL,
5142 NULL,
5143 NULL,
5144 TRUE,
5145 dwProcessFlags,
5146 NULL,
5147 NULL,
5148 &siStartInfo,
5149 &piProcInfo) ) {
5150 /* Close the handles now so anyone waiting is woken. */
5151 CloseHandle(piProcInfo.hThread);
5153 /* Return process handle */
5154 *hProcess = piProcInfo.hProcess;
5155 return TRUE;
5157 win32_error("CreateProcess", s2);
5158 return FALSE;
5161 /* The following code is based off of KB: Q190351 */
5163 static PyObject *
5164 _PyPopen(char *cmdstring, int mode, int n)
5166 HANDLE hChildStdinRd, hChildStdinWr, hChildStdoutRd, hChildStdoutWr,
5167 hChildStderrRd, hChildStderrWr, hChildStdinWrDup, hChildStdoutRdDup,
5168 hChildStderrRdDup, hProcess; /* hChildStdoutWrDup; */
5170 SECURITY_ATTRIBUTES saAttr;
5171 BOOL fSuccess;
5172 int fd1, fd2, fd3;
5173 FILE *f1, *f2, *f3;
5174 long file_count;
5175 PyObject *f;
5177 saAttr.nLength = sizeof(SECURITY_ATTRIBUTES);
5178 saAttr.bInheritHandle = TRUE;
5179 saAttr.lpSecurityDescriptor = NULL;
5181 if (!CreatePipe(&hChildStdinRd, &hChildStdinWr, &saAttr, 0))
5182 return win32_error("CreatePipe", NULL);
5184 /* Create new output read handle and the input write handle. Set
5185 * the inheritance properties to FALSE. Otherwise, the child inherits
5186 * these handles; resulting in non-closeable handles to the pipes
5187 * being created. */
5188 fSuccess = DuplicateHandle(GetCurrentProcess(), hChildStdinWr,
5189 GetCurrentProcess(), &hChildStdinWrDup, 0,
5190 FALSE,
5191 DUPLICATE_SAME_ACCESS);
5192 if (!fSuccess)
5193 return win32_error("DuplicateHandle", NULL);
5195 /* Close the inheritable version of ChildStdin
5196 that we're using. */
5197 CloseHandle(hChildStdinWr);
5199 if (!CreatePipe(&hChildStdoutRd, &hChildStdoutWr, &saAttr, 0))
5200 return win32_error("CreatePipe", NULL);
5202 fSuccess = DuplicateHandle(GetCurrentProcess(), hChildStdoutRd,
5203 GetCurrentProcess(), &hChildStdoutRdDup, 0,
5204 FALSE, DUPLICATE_SAME_ACCESS);
5205 if (!fSuccess)
5206 return win32_error("DuplicateHandle", NULL);
5208 /* Close the inheritable version of ChildStdout
5209 that we're using. */
5210 CloseHandle(hChildStdoutRd);
5212 if (n != POPEN_4) {
5213 if (!CreatePipe(&hChildStderrRd, &hChildStderrWr, &saAttr, 0))
5214 return win32_error("CreatePipe", NULL);
5215 fSuccess = DuplicateHandle(GetCurrentProcess(),
5216 hChildStderrRd,
5217 GetCurrentProcess(),
5218 &hChildStderrRdDup, 0,
5219 FALSE, DUPLICATE_SAME_ACCESS);
5220 if (!fSuccess)
5221 return win32_error("DuplicateHandle", NULL);
5222 /* Close the inheritable version of ChildStdErr that we're using. */
5223 CloseHandle(hChildStderrRd);
5226 switch (n) {
5227 case POPEN_1:
5228 switch (mode & (_O_RDONLY | _O_TEXT | _O_BINARY | _O_WRONLY)) {
5229 case _O_WRONLY | _O_TEXT:
5230 /* Case for writing to child Stdin in text mode. */
5231 fd1 = _open_osfhandle((Py_intptr_t)hChildStdinWrDup, mode);
5232 f1 = _fdopen(fd1, "w");
5233 f = PyFile_FromFile(f1, cmdstring, "w", _PyPclose);
5234 PyFile_SetBufSize(f, 0);
5235 /* We don't care about these pipes anymore, so close them. */
5236 CloseHandle(hChildStdoutRdDup);
5237 CloseHandle(hChildStderrRdDup);
5238 break;
5240 case _O_RDONLY | _O_TEXT:
5241 /* Case for reading from child Stdout in text mode. */
5242 fd1 = _open_osfhandle((Py_intptr_t)hChildStdoutRdDup, mode);
5243 f1 = _fdopen(fd1, "r");
5244 f = PyFile_FromFile(f1, cmdstring, "r", _PyPclose);
5245 PyFile_SetBufSize(f, 0);
5246 /* We don't care about these pipes anymore, so close them. */
5247 CloseHandle(hChildStdinWrDup);
5248 CloseHandle(hChildStderrRdDup);
5249 break;
5251 case _O_RDONLY | _O_BINARY:
5252 /* Case for readinig from child Stdout in binary mode. */
5253 fd1 = _open_osfhandle((Py_intptr_t)hChildStdoutRdDup, mode);
5254 f1 = _fdopen(fd1, "rb");
5255 f = PyFile_FromFile(f1, cmdstring, "rb", _PyPclose);
5256 PyFile_SetBufSize(f, 0);
5257 /* We don't care about these pipes anymore, so close them. */
5258 CloseHandle(hChildStdinWrDup);
5259 CloseHandle(hChildStderrRdDup);
5260 break;
5262 case _O_WRONLY | _O_BINARY:
5263 /* Case for writing to child Stdin in binary mode. */
5264 fd1 = _open_osfhandle((Py_intptr_t)hChildStdinWrDup, mode);
5265 f1 = _fdopen(fd1, "wb");
5266 f = PyFile_FromFile(f1, cmdstring, "wb", _PyPclose);
5267 PyFile_SetBufSize(f, 0);
5268 /* We don't care about these pipes anymore, so close them. */
5269 CloseHandle(hChildStdoutRdDup);
5270 CloseHandle(hChildStderrRdDup);
5271 break;
5273 file_count = 1;
5274 break;
5276 case POPEN_2:
5277 case POPEN_4:
5279 char *m1, *m2;
5280 PyObject *p1, *p2;
5282 if (mode & _O_TEXT) {
5283 m1 = "r";
5284 m2 = "w";
5285 } else {
5286 m1 = "rb";
5287 m2 = "wb";
5290 fd1 = _open_osfhandle((Py_intptr_t)hChildStdinWrDup, mode);
5291 f1 = _fdopen(fd1, m2);
5292 fd2 = _open_osfhandle((Py_intptr_t)hChildStdoutRdDup, mode);
5293 f2 = _fdopen(fd2, m1);
5294 p1 = PyFile_FromFile(f1, cmdstring, m2, _PyPclose);
5295 PyFile_SetBufSize(p1, 0);
5296 p2 = PyFile_FromFile(f2, cmdstring, m1, _PyPclose);
5297 PyFile_SetBufSize(p2, 0);
5299 if (n != 4)
5300 CloseHandle(hChildStderrRdDup);
5302 f = PyTuple_Pack(2,p1,p2);
5303 Py_XDECREF(p1);
5304 Py_XDECREF(p2);
5305 file_count = 2;
5306 break;
5309 case POPEN_3:
5311 char *m1, *m2;
5312 PyObject *p1, *p2, *p3;
5314 if (mode & _O_TEXT) {
5315 m1 = "r";
5316 m2 = "w";
5317 } else {
5318 m1 = "rb";
5319 m2 = "wb";
5322 fd1 = _open_osfhandle((Py_intptr_t)hChildStdinWrDup, mode);
5323 f1 = _fdopen(fd1, m2);
5324 fd2 = _open_osfhandle((Py_intptr_t)hChildStdoutRdDup, mode);
5325 f2 = _fdopen(fd2, m1);
5326 fd3 = _open_osfhandle((Py_intptr_t)hChildStderrRdDup, mode);
5327 f3 = _fdopen(fd3, m1);
5328 p1 = PyFile_FromFile(f1, cmdstring, m2, _PyPclose);
5329 p2 = PyFile_FromFile(f2, cmdstring, m1, _PyPclose);
5330 p3 = PyFile_FromFile(f3, cmdstring, m1, _PyPclose);
5331 PyFile_SetBufSize(p1, 0);
5332 PyFile_SetBufSize(p2, 0);
5333 PyFile_SetBufSize(p3, 0);
5334 f = PyTuple_Pack(3,p1,p2,p3);
5335 Py_XDECREF(p1);
5336 Py_XDECREF(p2);
5337 Py_XDECREF(p3);
5338 file_count = 3;
5339 break;
5343 if (n == POPEN_4) {
5344 if (!_PyPopenCreateProcess(cmdstring,
5345 hChildStdinRd,
5346 hChildStdoutWr,
5347 hChildStdoutWr,
5348 &hProcess))
5349 return NULL;
5351 else {
5352 if (!_PyPopenCreateProcess(cmdstring,
5353 hChildStdinRd,
5354 hChildStdoutWr,
5355 hChildStderrWr,
5356 &hProcess))
5357 return NULL;
5361 * Insert the files we've created into the process dictionary
5362 * all referencing the list with the process handle and the
5363 * initial number of files (see description below in _PyPclose).
5364 * Since if _PyPclose later tried to wait on a process when all
5365 * handles weren't closed, it could create a deadlock with the
5366 * child, we spend some energy here to try to ensure that we
5367 * either insert all file handles into the dictionary or none
5368 * at all. It's a little clumsy with the various popen modes
5369 * and variable number of files involved.
5371 if (!_PyPopenProcs) {
5372 _PyPopenProcs = PyDict_New();
5375 if (_PyPopenProcs) {
5376 PyObject *procObj, *hProcessObj, *intObj, *fileObj[3];
5377 int ins_rc[3];
5379 fileObj[0] = fileObj[1] = fileObj[2] = NULL;
5380 ins_rc[0] = ins_rc[1] = ins_rc[2] = 0;
5382 procObj = PyList_New(2);
5383 hProcessObj = PyLong_FromVoidPtr(hProcess);
5384 intObj = PyInt_FromLong(file_count);
5386 if (procObj && hProcessObj && intObj) {
5387 PyList_SetItem(procObj,0,hProcessObj);
5388 PyList_SetItem(procObj,1,intObj);
5390 fileObj[0] = PyLong_FromVoidPtr(f1);
5391 if (fileObj[0]) {
5392 ins_rc[0] = PyDict_SetItem(_PyPopenProcs,
5393 fileObj[0],
5394 procObj);
5396 if (file_count >= 2) {
5397 fileObj[1] = PyLong_FromVoidPtr(f2);
5398 if (fileObj[1]) {
5399 ins_rc[1] = PyDict_SetItem(_PyPopenProcs,
5400 fileObj[1],
5401 procObj);
5404 if (file_count >= 3) {
5405 fileObj[2] = PyLong_FromVoidPtr(f3);
5406 if (fileObj[2]) {
5407 ins_rc[2] = PyDict_SetItem(_PyPopenProcs,
5408 fileObj[2],
5409 procObj);
5413 if (ins_rc[0] < 0 || !fileObj[0] ||
5414 ins_rc[1] < 0 || (file_count > 1 && !fileObj[1]) ||
5415 ins_rc[2] < 0 || (file_count > 2 && !fileObj[2])) {
5416 /* Something failed - remove any dictionary
5417 * entries that did make it.
5419 if (!ins_rc[0] && fileObj[0]) {
5420 PyDict_DelItem(_PyPopenProcs,
5421 fileObj[0]);
5423 if (!ins_rc[1] && fileObj[1]) {
5424 PyDict_DelItem(_PyPopenProcs,
5425 fileObj[1]);
5427 if (!ins_rc[2] && fileObj[2]) {
5428 PyDict_DelItem(_PyPopenProcs,
5429 fileObj[2]);
5435 * Clean up our localized references for the dictionary keys
5436 * and value since PyDict_SetItem will Py_INCREF any copies
5437 * that got placed in the dictionary.
5439 Py_XDECREF(procObj);
5440 Py_XDECREF(fileObj[0]);
5441 Py_XDECREF(fileObj[1]);
5442 Py_XDECREF(fileObj[2]);
5445 /* Child is launched. Close the parents copy of those pipe
5446 * handles that only the child should have open. You need to
5447 * make sure that no handles to the write end of the output pipe
5448 * are maintained in this process or else the pipe will not close
5449 * when the child process exits and the ReadFile will hang. */
5451 if (!CloseHandle(hChildStdinRd))
5452 return win32_error("CloseHandle", NULL);
5454 if (!CloseHandle(hChildStdoutWr))
5455 return win32_error("CloseHandle", NULL);
5457 if ((n != 4) && (!CloseHandle(hChildStderrWr)))
5458 return win32_error("CloseHandle", NULL);
5460 return f;
5464 * Wrapper for fclose() to use for popen* files, so we can retrieve the
5465 * exit code for the child process and return as a result of the close.
5467 * This function uses the _PyPopenProcs dictionary in order to map the
5468 * input file pointer to information about the process that was
5469 * originally created by the popen* call that created the file pointer.
5470 * The dictionary uses the file pointer as a key (with one entry
5471 * inserted for each file returned by the original popen* call) and a
5472 * single list object as the value for all files from a single call.
5473 * The list object contains the Win32 process handle at [0], and a file
5474 * count at [1], which is initialized to the total number of file
5475 * handles using that list.
5477 * This function closes whichever handle it is passed, and decrements
5478 * the file count in the dictionary for the process handle pointed to
5479 * by this file. On the last close (when the file count reaches zero),
5480 * this function will wait for the child process and then return its
5481 * exit code as the result of the close() operation. This permits the
5482 * files to be closed in any order - it is always the close() of the
5483 * final handle that will return the exit code.
5485 * NOTE: This function is currently called with the GIL released.
5486 * hence we use the GILState API to manage our state.
5489 static int _PyPclose(FILE *file)
5491 int result;
5492 DWORD exit_code;
5493 HANDLE hProcess;
5494 PyObject *procObj, *hProcessObj, *intObj, *fileObj;
5495 long file_count;
5496 #ifdef WITH_THREAD
5497 PyGILState_STATE state;
5498 #endif
5500 /* Close the file handle first, to ensure it can't block the
5501 * child from exiting if it's the last handle.
5503 result = fclose(file);
5504 #ifdef WITH_THREAD
5505 state = PyGILState_Ensure();
5506 #endif
5507 if (_PyPopenProcs) {
5508 if ((fileObj = PyLong_FromVoidPtr(file)) != NULL &&
5509 (procObj = PyDict_GetItem(_PyPopenProcs,
5510 fileObj)) != NULL &&
5511 (hProcessObj = PyList_GetItem(procObj,0)) != NULL &&
5512 (intObj = PyList_GetItem(procObj,1)) != NULL) {
5514 hProcess = PyLong_AsVoidPtr(hProcessObj);
5515 file_count = PyInt_AsLong(intObj);
5517 if (file_count > 1) {
5518 /* Still other files referencing process */
5519 file_count--;
5520 PyList_SetItem(procObj,1,
5521 PyInt_FromLong(file_count));
5522 } else {
5523 /* Last file for this process */
5524 if (result != EOF &&
5525 WaitForSingleObject(hProcess, INFINITE) != WAIT_FAILED &&
5526 GetExitCodeProcess(hProcess, &exit_code)) {
5527 /* Possible truncation here in 16-bit environments, but
5528 * real exit codes are just the lower byte in any event.
5530 result = exit_code;
5531 } else {
5532 /* Indicate failure - this will cause the file object
5533 * to raise an I/O error and translate the last Win32
5534 * error code from errno. We do have a problem with
5535 * last errors that overlap the normal errno table,
5536 * but that's a consistent problem with the file object.
5538 if (result != EOF) {
5539 /* If the error wasn't from the fclose(), then
5540 * set errno for the file object error handling.
5542 errno = GetLastError();
5544 result = -1;
5547 /* Free up the native handle at this point */
5548 CloseHandle(hProcess);
5551 /* Remove this file pointer from dictionary */
5552 PyDict_DelItem(_PyPopenProcs, fileObj);
5554 if (PyDict_Size(_PyPopenProcs) == 0) {
5555 Py_DECREF(_PyPopenProcs);
5556 _PyPopenProcs = NULL;
5559 } /* if object retrieval ok */
5561 Py_XDECREF(fileObj);
5562 } /* if _PyPopenProcs */
5564 #ifdef WITH_THREAD
5565 PyGILState_Release(state);
5566 #endif
5567 return result;
5570 #else /* which OS? */
5571 static PyObject *
5572 posix_popen(PyObject *self, PyObject *args)
5574 char *name;
5575 char *mode = "r";
5576 int bufsize = -1;
5577 FILE *fp;
5578 PyObject *f;
5579 if (!PyArg_ParseTuple(args, "s|si:popen", &name, &mode, &bufsize))
5580 return NULL;
5581 /* Strip mode of binary or text modifiers */
5582 if (strcmp(mode, "rb") == 0 || strcmp(mode, "rt") == 0)
5583 mode = "r";
5584 else if (strcmp(mode, "wb") == 0 || strcmp(mode, "wt") == 0)
5585 mode = "w";
5586 Py_BEGIN_ALLOW_THREADS
5587 fp = popen(name, mode);
5588 Py_END_ALLOW_THREADS
5589 if (fp == NULL)
5590 return posix_error();
5591 f = PyFile_FromFile(fp, name, mode, pclose);
5592 if (f != NULL)
5593 PyFile_SetBufSize(f, bufsize);
5594 return f;
5597 #endif /* PYOS_??? */
5598 #endif /* HAVE_POPEN */
5601 #ifdef HAVE_SETUID
5602 PyDoc_STRVAR(posix_setuid__doc__,
5603 "setuid(uid)\n\n\
5604 Set the current process's user id.");
5606 static PyObject *
5607 posix_setuid(PyObject *self, PyObject *args)
5609 int uid;
5610 if (!PyArg_ParseTuple(args, "i:setuid", &uid))
5611 return NULL;
5612 if (setuid(uid) < 0)
5613 return posix_error();
5614 Py_INCREF(Py_None);
5615 return Py_None;
5617 #endif /* HAVE_SETUID */
5620 #ifdef HAVE_SETEUID
5621 PyDoc_STRVAR(posix_seteuid__doc__,
5622 "seteuid(uid)\n\n\
5623 Set the current process's effective user id.");
5625 static PyObject *
5626 posix_seteuid (PyObject *self, PyObject *args)
5628 int euid;
5629 if (!PyArg_ParseTuple(args, "i", &euid)) {
5630 return NULL;
5631 } else if (seteuid(euid) < 0) {
5632 return posix_error();
5633 } else {
5634 Py_INCREF(Py_None);
5635 return Py_None;
5638 #endif /* HAVE_SETEUID */
5640 #ifdef HAVE_SETEGID
5641 PyDoc_STRVAR(posix_setegid__doc__,
5642 "setegid(gid)\n\n\
5643 Set the current process's effective group id.");
5645 static PyObject *
5646 posix_setegid (PyObject *self, PyObject *args)
5648 int egid;
5649 if (!PyArg_ParseTuple(args, "i", &egid)) {
5650 return NULL;
5651 } else if (setegid(egid) < 0) {
5652 return posix_error();
5653 } else {
5654 Py_INCREF(Py_None);
5655 return Py_None;
5658 #endif /* HAVE_SETEGID */
5660 #ifdef HAVE_SETREUID
5661 PyDoc_STRVAR(posix_setreuid__doc__,
5662 "setreuid(ruid, euid)\n\n\
5663 Set the current process's real and effective user ids.");
5665 static PyObject *
5666 posix_setreuid (PyObject *self, PyObject *args)
5668 int ruid, euid;
5669 if (!PyArg_ParseTuple(args, "ii", &ruid, &euid)) {
5670 return NULL;
5671 } else if (setreuid(ruid, euid) < 0) {
5672 return posix_error();
5673 } else {
5674 Py_INCREF(Py_None);
5675 return Py_None;
5678 #endif /* HAVE_SETREUID */
5680 #ifdef HAVE_SETREGID
5681 PyDoc_STRVAR(posix_setregid__doc__,
5682 "setregid(rgid, egid)\n\n\
5683 Set the current process's real and effective group ids.");
5685 static PyObject *
5686 posix_setregid (PyObject *self, PyObject *args)
5688 int rgid, egid;
5689 if (!PyArg_ParseTuple(args, "ii", &rgid, &egid)) {
5690 return NULL;
5691 } else if (setregid(rgid, egid) < 0) {
5692 return posix_error();
5693 } else {
5694 Py_INCREF(Py_None);
5695 return Py_None;
5698 #endif /* HAVE_SETREGID */
5700 #ifdef HAVE_SETGID
5701 PyDoc_STRVAR(posix_setgid__doc__,
5702 "setgid(gid)\n\n\
5703 Set the current process's group id.");
5705 static PyObject *
5706 posix_setgid(PyObject *self, PyObject *args)
5708 int gid;
5709 if (!PyArg_ParseTuple(args, "i:setgid", &gid))
5710 return NULL;
5711 if (setgid(gid) < 0)
5712 return posix_error();
5713 Py_INCREF(Py_None);
5714 return Py_None;
5716 #endif /* HAVE_SETGID */
5718 #ifdef HAVE_SETGROUPS
5719 PyDoc_STRVAR(posix_setgroups__doc__,
5720 "setgroups(list)\n\n\
5721 Set the groups of the current process to list.");
5723 static PyObject *
5724 posix_setgroups(PyObject *self, PyObject *groups)
5726 int i, len;
5727 gid_t grouplist[MAX_GROUPS];
5729 if (!PySequence_Check(groups)) {
5730 PyErr_SetString(PyExc_TypeError, "setgroups argument must be a sequence");
5731 return NULL;
5733 len = PySequence_Size(groups);
5734 if (len > MAX_GROUPS) {
5735 PyErr_SetString(PyExc_ValueError, "too many groups");
5736 return NULL;
5738 for(i = 0; i < len; i++) {
5739 PyObject *elem;
5740 elem = PySequence_GetItem(groups, i);
5741 if (!elem)
5742 return NULL;
5743 if (!PyInt_Check(elem)) {
5744 if (!PyLong_Check(elem)) {
5745 PyErr_SetString(PyExc_TypeError,
5746 "groups must be integers");
5747 Py_DECREF(elem);
5748 return NULL;
5749 } else {
5750 unsigned long x = PyLong_AsUnsignedLong(elem);
5751 if (PyErr_Occurred()) {
5752 PyErr_SetString(PyExc_TypeError,
5753 "group id too big");
5754 Py_DECREF(elem);
5755 return NULL;
5757 grouplist[i] = x;
5758 /* read back the value to see if it fitted in gid_t */
5759 if (grouplist[i] != x) {
5760 PyErr_SetString(PyExc_TypeError,
5761 "group id too big");
5762 Py_DECREF(elem);
5763 return NULL;
5766 } else {
5767 long x = PyInt_AsLong(elem);
5768 grouplist[i] = x;
5769 if (grouplist[i] != x) {
5770 PyErr_SetString(PyExc_TypeError,
5771 "group id too big");
5772 Py_DECREF(elem);
5773 return NULL;
5776 Py_DECREF(elem);
5779 if (setgroups(len, grouplist) < 0)
5780 return posix_error();
5781 Py_INCREF(Py_None);
5782 return Py_None;
5784 #endif /* HAVE_SETGROUPS */
5786 #if defined(HAVE_WAIT3) || defined(HAVE_WAIT4)
5787 static PyObject *
5788 wait_helper(pid_t pid, int status, struct rusage *ru)
5790 PyObject *result;
5791 static PyObject *struct_rusage;
5793 if (pid == -1)
5794 return posix_error();
5796 if (struct_rusage == NULL) {
5797 PyObject *m = PyImport_ImportModuleNoBlock("resource");
5798 if (m == NULL)
5799 return NULL;
5800 struct_rusage = PyObject_GetAttrString(m, "struct_rusage");
5801 Py_DECREF(m);
5802 if (struct_rusage == NULL)
5803 return NULL;
5806 /* XXX(nnorwitz): Copied (w/mods) from resource.c, there should be only one. */
5807 result = PyStructSequence_New((PyTypeObject*) struct_rusage);
5808 if (!result)
5809 return NULL;
5811 #ifndef doubletime
5812 #define doubletime(TV) ((double)(TV).tv_sec + (TV).tv_usec * 0.000001)
5813 #endif
5815 PyStructSequence_SET_ITEM(result, 0,
5816 PyFloat_FromDouble(doubletime(ru->ru_utime)));
5817 PyStructSequence_SET_ITEM(result, 1,
5818 PyFloat_FromDouble(doubletime(ru->ru_stime)));
5819 #define SET_INT(result, index, value)\
5820 PyStructSequence_SET_ITEM(result, index, PyInt_FromLong(value))
5821 SET_INT(result, 2, ru->ru_maxrss);
5822 SET_INT(result, 3, ru->ru_ixrss);
5823 SET_INT(result, 4, ru->ru_idrss);
5824 SET_INT(result, 5, ru->ru_isrss);
5825 SET_INT(result, 6, ru->ru_minflt);
5826 SET_INT(result, 7, ru->ru_majflt);
5827 SET_INT(result, 8, ru->ru_nswap);
5828 SET_INT(result, 9, ru->ru_inblock);
5829 SET_INT(result, 10, ru->ru_oublock);
5830 SET_INT(result, 11, ru->ru_msgsnd);
5831 SET_INT(result, 12, ru->ru_msgrcv);
5832 SET_INT(result, 13, ru->ru_nsignals);
5833 SET_INT(result, 14, ru->ru_nvcsw);
5834 SET_INT(result, 15, ru->ru_nivcsw);
5835 #undef SET_INT
5837 if (PyErr_Occurred()) {
5838 Py_DECREF(result);
5839 return NULL;
5842 return Py_BuildValue("iiN", pid, status, result);
5844 #endif /* HAVE_WAIT3 || HAVE_WAIT4 */
5846 #ifdef HAVE_WAIT3
5847 PyDoc_STRVAR(posix_wait3__doc__,
5848 "wait3(options) -> (pid, status, rusage)\n\n\
5849 Wait for completion of a child process.");
5851 static PyObject *
5852 posix_wait3(PyObject *self, PyObject *args)
5854 pid_t pid;
5855 int options;
5856 struct rusage ru;
5857 WAIT_TYPE status;
5858 WAIT_STATUS_INT(status) = 0;
5860 if (!PyArg_ParseTuple(args, "i:wait3", &options))
5861 return NULL;
5863 Py_BEGIN_ALLOW_THREADS
5864 pid = wait3(&status, options, &ru);
5865 Py_END_ALLOW_THREADS
5867 return wait_helper(pid, WAIT_STATUS_INT(status), &ru);
5869 #endif /* HAVE_WAIT3 */
5871 #ifdef HAVE_WAIT4
5872 PyDoc_STRVAR(posix_wait4__doc__,
5873 "wait4(pid, options) -> (pid, status, rusage)\n\n\
5874 Wait for completion of a given child process.");
5876 static PyObject *
5877 posix_wait4(PyObject *self, PyObject *args)
5879 pid_t pid;
5880 int options;
5881 struct rusage ru;
5882 WAIT_TYPE status;
5883 WAIT_STATUS_INT(status) = 0;
5885 if (!PyArg_ParseTuple(args, "ii:wait4", &pid, &options))
5886 return NULL;
5888 Py_BEGIN_ALLOW_THREADS
5889 pid = wait4(pid, &status, options, &ru);
5890 Py_END_ALLOW_THREADS
5892 return wait_helper(pid, WAIT_STATUS_INT(status), &ru);
5894 #endif /* HAVE_WAIT4 */
5896 #ifdef HAVE_WAITPID
5897 PyDoc_STRVAR(posix_waitpid__doc__,
5898 "waitpid(pid, options) -> (pid, status)\n\n\
5899 Wait for completion of a given child process.");
5901 static PyObject *
5902 posix_waitpid(PyObject *self, PyObject *args)
5904 pid_t pid;
5905 int options;
5906 WAIT_TYPE status;
5907 WAIT_STATUS_INT(status) = 0;
5909 if (!PyArg_ParseTuple(args, "ii:waitpid", &pid, &options))
5910 return NULL;
5911 Py_BEGIN_ALLOW_THREADS
5912 pid = waitpid(pid, &status, options);
5913 Py_END_ALLOW_THREADS
5914 if (pid == -1)
5915 return posix_error();
5917 return Py_BuildValue("ii", pid, WAIT_STATUS_INT(status));
5920 #elif defined(HAVE_CWAIT)
5922 /* MS C has a variant of waitpid() that's usable for most purposes. */
5923 PyDoc_STRVAR(posix_waitpid__doc__,
5924 "waitpid(pid, options) -> (pid, status << 8)\n\n"
5925 "Wait for completion of a given process. options is ignored on Windows.");
5927 static PyObject *
5928 posix_waitpid(PyObject *self, PyObject *args)
5930 Py_intptr_t pid;
5931 int status, options;
5933 if (!PyArg_ParseTuple(args, "ii:waitpid", &pid, &options))
5934 return NULL;
5935 Py_BEGIN_ALLOW_THREADS
5936 pid = _cwait(&status, pid, options);
5937 Py_END_ALLOW_THREADS
5938 if (pid == -1)
5939 return posix_error();
5941 /* shift the status left a byte so this is more like the POSIX waitpid */
5942 return Py_BuildValue("ii", pid, status << 8);
5944 #endif /* HAVE_WAITPID || HAVE_CWAIT */
5946 #ifdef HAVE_WAIT
5947 PyDoc_STRVAR(posix_wait__doc__,
5948 "wait() -> (pid, status)\n\n\
5949 Wait for completion of a child process.");
5951 static PyObject *
5952 posix_wait(PyObject *self, PyObject *noargs)
5954 pid_t pid;
5955 WAIT_TYPE status;
5956 WAIT_STATUS_INT(status) = 0;
5958 Py_BEGIN_ALLOW_THREADS
5959 pid = wait(&status);
5960 Py_END_ALLOW_THREADS
5961 if (pid == -1)
5962 return posix_error();
5964 return Py_BuildValue("ii", pid, WAIT_STATUS_INT(status));
5966 #endif
5969 PyDoc_STRVAR(posix_lstat__doc__,
5970 "lstat(path) -> stat result\n\n\
5971 Like stat(path), but do not follow symbolic links.");
5973 static PyObject *
5974 posix_lstat(PyObject *self, PyObject *args)
5976 #ifdef HAVE_LSTAT
5977 return posix_do_stat(self, args, "et:lstat", lstat, NULL, NULL);
5978 #else /* !HAVE_LSTAT */
5979 #ifdef MS_WINDOWS
5980 return posix_do_stat(self, args, "et:lstat", STAT, "U:lstat", win32_wstat);
5981 #else
5982 return posix_do_stat(self, args, "et:lstat", STAT, NULL, NULL);
5983 #endif
5984 #endif /* !HAVE_LSTAT */
5988 #ifdef HAVE_READLINK
5989 PyDoc_STRVAR(posix_readlink__doc__,
5990 "readlink(path) -> path\n\n\
5991 Return a string representing the path to which the symbolic link points.");
5993 static PyObject *
5994 posix_readlink(PyObject *self, PyObject *args)
5996 PyObject* v;
5997 char buf[MAXPATHLEN];
5998 char *path;
5999 int n;
6000 #ifdef Py_USING_UNICODE
6001 int arg_is_unicode = 0;
6002 #endif
6004 if (!PyArg_ParseTuple(args, "et:readlink",
6005 Py_FileSystemDefaultEncoding, &path))
6006 return NULL;
6007 #ifdef Py_USING_UNICODE
6008 v = PySequence_GetItem(args, 0);
6009 if (v == NULL) {
6010 PyMem_Free(path);
6011 return NULL;
6014 if (PyUnicode_Check(v)) {
6015 arg_is_unicode = 1;
6017 Py_DECREF(v);
6018 #endif
6020 Py_BEGIN_ALLOW_THREADS
6021 n = readlink(path, buf, (int) sizeof buf);
6022 Py_END_ALLOW_THREADS
6023 if (n < 0)
6024 return posix_error_with_allocated_filename(path);
6026 PyMem_Free(path);
6027 v = PyString_FromStringAndSize(buf, n);
6028 #ifdef Py_USING_UNICODE
6029 if (arg_is_unicode) {
6030 PyObject *w;
6032 w = PyUnicode_FromEncodedObject(v,
6033 Py_FileSystemDefaultEncoding,
6034 "strict");
6035 if (w != NULL) {
6036 Py_DECREF(v);
6037 v = w;
6039 else {
6040 /* fall back to the original byte string, as
6041 discussed in patch #683592 */
6042 PyErr_Clear();
6045 #endif
6046 return v;
6048 #endif /* HAVE_READLINK */
6051 #ifdef HAVE_SYMLINK
6052 PyDoc_STRVAR(posix_symlink__doc__,
6053 "symlink(src, dst)\n\n\
6054 Create a symbolic link pointing to src named dst.");
6056 static PyObject *
6057 posix_symlink(PyObject *self, PyObject *args)
6059 return posix_2str(args, "etet:symlink", symlink);
6061 #endif /* HAVE_SYMLINK */
6064 #ifdef HAVE_TIMES
6065 #if defined(PYCC_VACPP) && defined(PYOS_OS2)
6066 static long
6067 system_uptime(void)
6069 ULONG value = 0;
6071 Py_BEGIN_ALLOW_THREADS
6072 DosQuerySysInfo(QSV_MS_COUNT, QSV_MS_COUNT, &value, sizeof(value));
6073 Py_END_ALLOW_THREADS
6075 return value;
6078 static PyObject *
6079 posix_times(PyObject *self, PyObject *noargs)
6081 /* Currently Only Uptime is Provided -- Others Later */
6082 return Py_BuildValue("ddddd",
6083 (double)0 /* t.tms_utime / HZ */,
6084 (double)0 /* t.tms_stime / HZ */,
6085 (double)0 /* t.tms_cutime / HZ */,
6086 (double)0 /* t.tms_cstime / HZ */,
6087 (double)system_uptime() / 1000);
6089 #else /* not OS2 */
6090 #define NEED_TICKS_PER_SECOND
6091 static long ticks_per_second = -1;
6092 static PyObject *
6093 posix_times(PyObject *self, PyObject *noargs)
6095 struct tms t;
6096 clock_t c;
6097 errno = 0;
6098 c = times(&t);
6099 if (c == (clock_t) -1)
6100 return posix_error();
6101 return Py_BuildValue("ddddd",
6102 (double)t.tms_utime / ticks_per_second,
6103 (double)t.tms_stime / ticks_per_second,
6104 (double)t.tms_cutime / ticks_per_second,
6105 (double)t.tms_cstime / ticks_per_second,
6106 (double)c / ticks_per_second);
6108 #endif /* not OS2 */
6109 #endif /* HAVE_TIMES */
6112 #ifdef MS_WINDOWS
6113 #define HAVE_TIMES /* so the method table will pick it up */
6114 static PyObject *
6115 posix_times(PyObject *self, PyObject *noargs)
6117 FILETIME create, exit, kernel, user;
6118 HANDLE hProc;
6119 hProc = GetCurrentProcess();
6120 GetProcessTimes(hProc, &create, &exit, &kernel, &user);
6121 /* The fields of a FILETIME structure are the hi and lo part
6122 of a 64-bit value expressed in 100 nanosecond units.
6123 1e7 is one second in such units; 1e-7 the inverse.
6124 429.4967296 is 2**32 / 1e7 or 2**32 * 1e-7.
6126 return Py_BuildValue(
6127 "ddddd",
6128 (double)(user.dwHighDateTime*429.4967296 +
6129 user.dwLowDateTime*1e-7),
6130 (double)(kernel.dwHighDateTime*429.4967296 +
6131 kernel.dwLowDateTime*1e-7),
6132 (double)0,
6133 (double)0,
6134 (double)0);
6136 #endif /* MS_WINDOWS */
6138 #ifdef HAVE_TIMES
6139 PyDoc_STRVAR(posix_times__doc__,
6140 "times() -> (utime, stime, cutime, cstime, elapsed_time)\n\n\
6141 Return a tuple of floating point numbers indicating process times.");
6142 #endif
6145 #ifdef HAVE_GETSID
6146 PyDoc_STRVAR(posix_getsid__doc__,
6147 "getsid(pid) -> sid\n\n\
6148 Call the system call getsid().");
6150 static PyObject *
6151 posix_getsid(PyObject *self, PyObject *args)
6153 pid_t pid;
6154 int sid;
6155 if (!PyArg_ParseTuple(args, "i:getsid", &pid))
6156 return NULL;
6157 sid = getsid(pid);
6158 if (sid < 0)
6159 return posix_error();
6160 return PyInt_FromLong((long)sid);
6162 #endif /* HAVE_GETSID */
6165 #ifdef HAVE_SETSID
6166 PyDoc_STRVAR(posix_setsid__doc__,
6167 "setsid()\n\n\
6168 Call the system call setsid().");
6170 static PyObject *
6171 posix_setsid(PyObject *self, PyObject *noargs)
6173 if (setsid() < 0)
6174 return posix_error();
6175 Py_INCREF(Py_None);
6176 return Py_None;
6178 #endif /* HAVE_SETSID */
6180 #ifdef HAVE_SETPGID
6181 PyDoc_STRVAR(posix_setpgid__doc__,
6182 "setpgid(pid, pgrp)\n\n\
6183 Call the system call setpgid().");
6185 static PyObject *
6186 posix_setpgid(PyObject *self, PyObject *args)
6188 pid_t pid;
6189 int pgrp;
6190 if (!PyArg_ParseTuple(args, "ii:setpgid", &pid, &pgrp))
6191 return NULL;
6192 if (setpgid(pid, pgrp) < 0)
6193 return posix_error();
6194 Py_INCREF(Py_None);
6195 return Py_None;
6197 #endif /* HAVE_SETPGID */
6200 #ifdef HAVE_TCGETPGRP
6201 PyDoc_STRVAR(posix_tcgetpgrp__doc__,
6202 "tcgetpgrp(fd) -> pgid\n\n\
6203 Return the process group associated with the terminal given by a fd.");
6205 static PyObject *
6206 posix_tcgetpgrp(PyObject *self, PyObject *args)
6208 int fd;
6209 pid_t pgid;
6210 if (!PyArg_ParseTuple(args, "i:tcgetpgrp", &fd))
6211 return NULL;
6212 pgid = tcgetpgrp(fd);
6213 if (pgid < 0)
6214 return posix_error();
6215 return PyInt_FromLong((long)pgid);
6217 #endif /* HAVE_TCGETPGRP */
6220 #ifdef HAVE_TCSETPGRP
6221 PyDoc_STRVAR(posix_tcsetpgrp__doc__,
6222 "tcsetpgrp(fd, pgid)\n\n\
6223 Set the process group associated with the terminal given by a fd.");
6225 static PyObject *
6226 posix_tcsetpgrp(PyObject *self, PyObject *args)
6228 int fd, pgid;
6229 if (!PyArg_ParseTuple(args, "ii:tcsetpgrp", &fd, &pgid))
6230 return NULL;
6231 if (tcsetpgrp(fd, pgid) < 0)
6232 return posix_error();
6233 Py_INCREF(Py_None);
6234 return Py_None;
6236 #endif /* HAVE_TCSETPGRP */
6238 /* Functions acting on file descriptors */
6240 PyDoc_STRVAR(posix_open__doc__,
6241 "open(filename, flag [, mode=0777]) -> fd\n\n\
6242 Open a file (for low level IO).");
6244 static PyObject *
6245 posix_open(PyObject *self, PyObject *args)
6247 char *file = NULL;
6248 int flag;
6249 int mode = 0777;
6250 int fd;
6252 #ifdef MS_WINDOWS
6253 if (unicode_file_names()) {
6254 PyUnicodeObject *po;
6255 if (PyArg_ParseTuple(args, "Ui|i:mkdir", &po, &flag, &mode)) {
6256 Py_BEGIN_ALLOW_THREADS
6257 /* PyUnicode_AS_UNICODE OK without thread
6258 lock as it is a simple dereference. */
6259 fd = _wopen(PyUnicode_AS_UNICODE(po), flag, mode);
6260 Py_END_ALLOW_THREADS
6261 if (fd < 0)
6262 return posix_error();
6263 return PyInt_FromLong((long)fd);
6265 /* Drop the argument parsing error as narrow strings
6266 are also valid. */
6267 PyErr_Clear();
6269 #endif
6271 if (!PyArg_ParseTuple(args, "eti|i",
6272 Py_FileSystemDefaultEncoding, &file,
6273 &flag, &mode))
6274 return NULL;
6276 Py_BEGIN_ALLOW_THREADS
6277 fd = open(file, flag, mode);
6278 Py_END_ALLOW_THREADS
6279 if (fd < 0)
6280 return posix_error_with_allocated_filename(file);
6281 PyMem_Free(file);
6282 return PyInt_FromLong((long)fd);
6286 PyDoc_STRVAR(posix_close__doc__,
6287 "close(fd)\n\n\
6288 Close a file descriptor (for low level IO).");
6290 static PyObject *
6291 posix_close(PyObject *self, PyObject *args)
6293 int fd, res;
6294 if (!PyArg_ParseTuple(args, "i:close", &fd))
6295 return NULL;
6296 if (!_PyVerify_fd(fd))
6297 return posix_error();
6298 Py_BEGIN_ALLOW_THREADS
6299 res = close(fd);
6300 Py_END_ALLOW_THREADS
6301 if (res < 0)
6302 return posix_error();
6303 Py_INCREF(Py_None);
6304 return Py_None;
6308 PyDoc_STRVAR(posix_closerange__doc__,
6309 "closerange(fd_low, fd_high)\n\n\
6310 Closes all file descriptors in [fd_low, fd_high), ignoring errors.");
6312 static PyObject *
6313 posix_closerange(PyObject *self, PyObject *args)
6315 int fd_from, fd_to, i;
6316 if (!PyArg_ParseTuple(args, "ii:closerange", &fd_from, &fd_to))
6317 return NULL;
6318 Py_BEGIN_ALLOW_THREADS
6319 for (i = fd_from; i < fd_to; i++)
6320 if (_PyVerify_fd(i))
6321 close(i);
6322 Py_END_ALLOW_THREADS
6323 Py_RETURN_NONE;
6327 PyDoc_STRVAR(posix_dup__doc__,
6328 "dup(fd) -> fd2\n\n\
6329 Return a duplicate of a file descriptor.");
6331 static PyObject *
6332 posix_dup(PyObject *self, PyObject *args)
6334 int fd;
6335 if (!PyArg_ParseTuple(args, "i:dup", &fd))
6336 return NULL;
6337 if (!_PyVerify_fd(fd))
6338 return posix_error();
6339 Py_BEGIN_ALLOW_THREADS
6340 fd = dup(fd);
6341 Py_END_ALLOW_THREADS
6342 if (fd < 0)
6343 return posix_error();
6344 return PyInt_FromLong((long)fd);
6348 PyDoc_STRVAR(posix_dup2__doc__,
6349 "dup2(old_fd, new_fd)\n\n\
6350 Duplicate file descriptor.");
6352 static PyObject *
6353 posix_dup2(PyObject *self, PyObject *args)
6355 int fd, fd2, res;
6356 if (!PyArg_ParseTuple(args, "ii:dup2", &fd, &fd2))
6357 return NULL;
6358 if (!_PyVerify_fd_dup2(fd, fd2))
6359 return posix_error();
6360 Py_BEGIN_ALLOW_THREADS
6361 res = dup2(fd, fd2);
6362 Py_END_ALLOW_THREADS
6363 if (res < 0)
6364 return posix_error();
6365 Py_INCREF(Py_None);
6366 return Py_None;
6370 PyDoc_STRVAR(posix_lseek__doc__,
6371 "lseek(fd, pos, how) -> newpos\n\n\
6372 Set the current position of a file descriptor.");
6374 static PyObject *
6375 posix_lseek(PyObject *self, PyObject *args)
6377 int fd, how;
6378 #if defined(MS_WIN64) || defined(MS_WINDOWS)
6379 PY_LONG_LONG pos, res;
6380 #else
6381 off_t pos, res;
6382 #endif
6383 PyObject *posobj;
6384 if (!PyArg_ParseTuple(args, "iOi:lseek", &fd, &posobj, &how))
6385 return NULL;
6386 #ifdef SEEK_SET
6387 /* Turn 0, 1, 2 into SEEK_{SET,CUR,END} */
6388 switch (how) {
6389 case 0: how = SEEK_SET; break;
6390 case 1: how = SEEK_CUR; break;
6391 case 2: how = SEEK_END; break;
6393 #endif /* SEEK_END */
6395 #if !defined(HAVE_LARGEFILE_SUPPORT)
6396 pos = PyInt_AsLong(posobj);
6397 #else
6398 pos = PyLong_Check(posobj) ?
6399 PyLong_AsLongLong(posobj) : PyInt_AsLong(posobj);
6400 #endif
6401 if (PyErr_Occurred())
6402 return NULL;
6404 if (!_PyVerify_fd(fd))
6405 return posix_error();
6406 Py_BEGIN_ALLOW_THREADS
6407 #if defined(MS_WIN64) || defined(MS_WINDOWS)
6408 res = _lseeki64(fd, pos, how);
6409 #else
6410 res = lseek(fd, pos, how);
6411 #endif
6412 Py_END_ALLOW_THREADS
6413 if (res < 0)
6414 return posix_error();
6416 #if !defined(HAVE_LARGEFILE_SUPPORT)
6417 return PyInt_FromLong(res);
6418 #else
6419 return PyLong_FromLongLong(res);
6420 #endif
6424 PyDoc_STRVAR(posix_read__doc__,
6425 "read(fd, buffersize) -> string\n\n\
6426 Read a file descriptor.");
6428 static PyObject *
6429 posix_read(PyObject *self, PyObject *args)
6431 int fd, size, n;
6432 PyObject *buffer;
6433 if (!PyArg_ParseTuple(args, "ii:read", &fd, &size))
6434 return NULL;
6435 if (size < 0) {
6436 errno = EINVAL;
6437 return posix_error();
6439 buffer = PyString_FromStringAndSize((char *)NULL, size);
6440 if (buffer == NULL)
6441 return NULL;
6442 if (!_PyVerify_fd(fd))
6443 return posix_error();
6444 Py_BEGIN_ALLOW_THREADS
6445 n = read(fd, PyString_AsString(buffer), size);
6446 Py_END_ALLOW_THREADS
6447 if (n < 0) {
6448 Py_DECREF(buffer);
6449 return posix_error();
6451 if (n != size)
6452 _PyString_Resize(&buffer, n);
6453 return buffer;
6457 PyDoc_STRVAR(posix_write__doc__,
6458 "write(fd, string) -> byteswritten\n\n\
6459 Write a string to a file descriptor.");
6461 static PyObject *
6462 posix_write(PyObject *self, PyObject *args)
6464 Py_buffer pbuf;
6465 int fd;
6466 Py_ssize_t size;
6468 if (!PyArg_ParseTuple(args, "is*:write", &fd, &pbuf))
6469 return NULL;
6470 if (!_PyVerify_fd(fd))
6471 return posix_error();
6472 Py_BEGIN_ALLOW_THREADS
6473 size = write(fd, pbuf.buf, (size_t)pbuf.len);
6474 Py_END_ALLOW_THREADS
6475 PyBuffer_Release(&pbuf);
6476 if (size < 0)
6477 return posix_error();
6478 return PyInt_FromSsize_t(size);
6482 PyDoc_STRVAR(posix_fstat__doc__,
6483 "fstat(fd) -> stat result\n\n\
6484 Like stat(), but for an open file descriptor.");
6486 static PyObject *
6487 posix_fstat(PyObject *self, PyObject *args)
6489 int fd;
6490 STRUCT_STAT st;
6491 int res;
6492 if (!PyArg_ParseTuple(args, "i:fstat", &fd))
6493 return NULL;
6494 #ifdef __VMS
6495 /* on OpenVMS we must ensure that all bytes are written to the file */
6496 fsync(fd);
6497 #endif
6498 if (!_PyVerify_fd(fd))
6499 return posix_error();
6500 Py_BEGIN_ALLOW_THREADS
6501 res = FSTAT(fd, &st);
6502 Py_END_ALLOW_THREADS
6503 if (res != 0) {
6504 #ifdef MS_WINDOWS
6505 return win32_error("fstat", NULL);
6506 #else
6507 return posix_error();
6508 #endif
6511 return _pystat_fromstructstat(&st);
6515 PyDoc_STRVAR(posix_fdopen__doc__,
6516 "fdopen(fd [, mode='r' [, bufsize]]) -> file_object\n\n\
6517 Return an open file object connected to a file descriptor.");
6519 static PyObject *
6520 posix_fdopen(PyObject *self, PyObject *args)
6522 int fd;
6523 char *orgmode = "r";
6524 int bufsize = -1;
6525 FILE *fp;
6526 PyObject *f;
6527 char *mode;
6528 if (!PyArg_ParseTuple(args, "i|si", &fd, &orgmode, &bufsize))
6529 return NULL;
6531 /* Sanitize mode. See fileobject.c */
6532 mode = PyMem_MALLOC(strlen(orgmode)+3);
6533 if (!mode) {
6534 PyErr_NoMemory();
6535 return NULL;
6537 strcpy(mode, orgmode);
6538 if (_PyFile_SanitizeMode(mode)) {
6539 PyMem_FREE(mode);
6540 return NULL;
6542 if (!_PyVerify_fd(fd))
6543 return posix_error();
6544 Py_BEGIN_ALLOW_THREADS
6545 #if !defined(MS_WINDOWS) && defined(HAVE_FCNTL_H)
6546 if (mode[0] == 'a') {
6547 /* try to make sure the O_APPEND flag is set */
6548 int flags;
6549 flags = fcntl(fd, F_GETFL);
6550 if (flags != -1)
6551 fcntl(fd, F_SETFL, flags | O_APPEND);
6552 fp = fdopen(fd, mode);
6553 if (fp == NULL && flags != -1)
6554 /* restore old mode if fdopen failed */
6555 fcntl(fd, F_SETFL, flags);
6556 } else {
6557 fp = fdopen(fd, mode);
6559 #else
6560 fp = fdopen(fd, mode);
6561 #endif
6562 Py_END_ALLOW_THREADS
6563 PyMem_FREE(mode);
6564 if (fp == NULL)
6565 return posix_error();
6566 f = PyFile_FromFile(fp, "<fdopen>", orgmode, fclose);
6567 if (f != NULL)
6568 PyFile_SetBufSize(f, bufsize);
6569 return f;
6572 PyDoc_STRVAR(posix_isatty__doc__,
6573 "isatty(fd) -> bool\n\n\
6574 Return True if the file descriptor 'fd' is an open file descriptor\n\
6575 connected to the slave end of a terminal.");
6577 static PyObject *
6578 posix_isatty(PyObject *self, PyObject *args)
6580 int fd;
6581 if (!PyArg_ParseTuple(args, "i:isatty", &fd))
6582 return NULL;
6583 if (!_PyVerify_fd(fd))
6584 return PyBool_FromLong(0);
6585 return PyBool_FromLong(isatty(fd));
6588 #ifdef HAVE_PIPE
6589 PyDoc_STRVAR(posix_pipe__doc__,
6590 "pipe() -> (read_end, write_end)\n\n\
6591 Create a pipe.");
6593 static PyObject *
6594 posix_pipe(PyObject *self, PyObject *noargs)
6596 #if defined(PYOS_OS2)
6597 HFILE read, write;
6598 APIRET rc;
6600 Py_BEGIN_ALLOW_THREADS
6601 rc = DosCreatePipe( &read, &write, 4096);
6602 Py_END_ALLOW_THREADS
6603 if (rc != NO_ERROR)
6604 return os2_error(rc);
6606 return Py_BuildValue("(ii)", read, write);
6607 #else
6608 #if !defined(MS_WINDOWS)
6609 int fds[2];
6610 int res;
6611 Py_BEGIN_ALLOW_THREADS
6612 res = pipe(fds);
6613 Py_END_ALLOW_THREADS
6614 if (res != 0)
6615 return posix_error();
6616 return Py_BuildValue("(ii)", fds[0], fds[1]);
6617 #else /* MS_WINDOWS */
6618 HANDLE read, write;
6619 int read_fd, write_fd;
6620 BOOL ok;
6621 Py_BEGIN_ALLOW_THREADS
6622 ok = CreatePipe(&read, &write, NULL, 0);
6623 Py_END_ALLOW_THREADS
6624 if (!ok)
6625 return win32_error("CreatePipe", NULL);
6626 read_fd = _open_osfhandle((Py_intptr_t)read, 0);
6627 write_fd = _open_osfhandle((Py_intptr_t)write, 1);
6628 return Py_BuildValue("(ii)", read_fd, write_fd);
6629 #endif /* MS_WINDOWS */
6630 #endif
6632 #endif /* HAVE_PIPE */
6635 #ifdef HAVE_MKFIFO
6636 PyDoc_STRVAR(posix_mkfifo__doc__,
6637 "mkfifo(filename [, mode=0666])\n\n\
6638 Create a FIFO (a POSIX named pipe).");
6640 static PyObject *
6641 posix_mkfifo(PyObject *self, PyObject *args)
6643 char *filename;
6644 int mode = 0666;
6645 int res;
6646 if (!PyArg_ParseTuple(args, "s|i:mkfifo", &filename, &mode))
6647 return NULL;
6648 Py_BEGIN_ALLOW_THREADS
6649 res = mkfifo(filename, mode);
6650 Py_END_ALLOW_THREADS
6651 if (res < 0)
6652 return posix_error();
6653 Py_INCREF(Py_None);
6654 return Py_None;
6656 #endif
6659 #if defined(HAVE_MKNOD) && defined(HAVE_MAKEDEV)
6660 PyDoc_STRVAR(posix_mknod__doc__,
6661 "mknod(filename [, mode=0600, device])\n\n\
6662 Create a filesystem node (file, device special file or named pipe)\n\
6663 named filename. mode specifies both the permissions to use and the\n\
6664 type of node to be created, being combined (bitwise OR) with one of\n\
6665 S_IFREG, S_IFCHR, S_IFBLK, and S_IFIFO. For S_IFCHR and S_IFBLK,\n\
6666 device defines the newly created device special file (probably using\n\
6667 os.makedev()), otherwise it is ignored.");
6670 static PyObject *
6671 posix_mknod(PyObject *self, PyObject *args)
6673 char *filename;
6674 int mode = 0600;
6675 int device = 0;
6676 int res;
6677 if (!PyArg_ParseTuple(args, "s|ii:mknod", &filename, &mode, &device))
6678 return NULL;
6679 Py_BEGIN_ALLOW_THREADS
6680 res = mknod(filename, mode, device);
6681 Py_END_ALLOW_THREADS
6682 if (res < 0)
6683 return posix_error();
6684 Py_INCREF(Py_None);
6685 return Py_None;
6687 #endif
6689 #ifdef HAVE_DEVICE_MACROS
6690 PyDoc_STRVAR(posix_major__doc__,
6691 "major(device) -> major number\n\
6692 Extracts a device major number from a raw device number.");
6694 static PyObject *
6695 posix_major(PyObject *self, PyObject *args)
6697 int device;
6698 if (!PyArg_ParseTuple(args, "i:major", &device))
6699 return NULL;
6700 return PyInt_FromLong((long)major(device));
6703 PyDoc_STRVAR(posix_minor__doc__,
6704 "minor(device) -> minor number\n\
6705 Extracts a device minor number from a raw device number.");
6707 static PyObject *
6708 posix_minor(PyObject *self, PyObject *args)
6710 int device;
6711 if (!PyArg_ParseTuple(args, "i:minor", &device))
6712 return NULL;
6713 return PyInt_FromLong((long)minor(device));
6716 PyDoc_STRVAR(posix_makedev__doc__,
6717 "makedev(major, minor) -> device number\n\
6718 Composes a raw device number from the major and minor device numbers.");
6720 static PyObject *
6721 posix_makedev(PyObject *self, PyObject *args)
6723 int major, minor;
6724 if (!PyArg_ParseTuple(args, "ii:makedev", &major, &minor))
6725 return NULL;
6726 return PyInt_FromLong((long)makedev(major, minor));
6728 #endif /* device macros */
6731 #ifdef HAVE_FTRUNCATE
6732 PyDoc_STRVAR(posix_ftruncate__doc__,
6733 "ftruncate(fd, length)\n\n\
6734 Truncate a file to a specified length.");
6736 static PyObject *
6737 posix_ftruncate(PyObject *self, PyObject *args)
6739 int fd;
6740 off_t length;
6741 int res;
6742 PyObject *lenobj;
6744 if (!PyArg_ParseTuple(args, "iO:ftruncate", &fd, &lenobj))
6745 return NULL;
6747 #if !defined(HAVE_LARGEFILE_SUPPORT)
6748 length = PyInt_AsLong(lenobj);
6749 #else
6750 length = PyLong_Check(lenobj) ?
6751 PyLong_AsLongLong(lenobj) : PyInt_AsLong(lenobj);
6752 #endif
6753 if (PyErr_Occurred())
6754 return NULL;
6756 Py_BEGIN_ALLOW_THREADS
6757 res = ftruncate(fd, length);
6758 Py_END_ALLOW_THREADS
6759 if (res < 0)
6760 return posix_error();
6761 Py_INCREF(Py_None);
6762 return Py_None;
6764 #endif
6766 #ifdef HAVE_PUTENV
6767 PyDoc_STRVAR(posix_putenv__doc__,
6768 "putenv(key, value)\n\n\
6769 Change or add an environment variable.");
6771 /* Save putenv() parameters as values here, so we can collect them when they
6772 * get re-set with another call for the same key. */
6773 static PyObject *posix_putenv_garbage;
6775 static PyObject *
6776 posix_putenv(PyObject *self, PyObject *args)
6778 char *s1, *s2;
6779 char *newenv;
6780 PyObject *newstr;
6781 size_t len;
6783 if (!PyArg_ParseTuple(args, "ss:putenv", &s1, &s2))
6784 return NULL;
6786 #if defined(PYOS_OS2)
6787 if (stricmp(s1, "BEGINLIBPATH") == 0) {
6788 APIRET rc;
6790 rc = DosSetExtLIBPATH(s2, BEGIN_LIBPATH);
6791 if (rc != NO_ERROR)
6792 return os2_error(rc);
6794 } else if (stricmp(s1, "ENDLIBPATH") == 0) {
6795 APIRET rc;
6797 rc = DosSetExtLIBPATH(s2, END_LIBPATH);
6798 if (rc != NO_ERROR)
6799 return os2_error(rc);
6800 } else {
6801 #endif
6803 /* XXX This can leak memory -- not easy to fix :-( */
6804 len = strlen(s1) + strlen(s2) + 2;
6805 /* len includes space for a trailing \0; the size arg to
6806 PyString_FromStringAndSize does not count that */
6807 newstr = PyString_FromStringAndSize(NULL, (int)len - 1);
6808 if (newstr == NULL)
6809 return PyErr_NoMemory();
6810 newenv = PyString_AS_STRING(newstr);
6811 PyOS_snprintf(newenv, len, "%s=%s", s1, s2);
6812 if (putenv(newenv)) {
6813 Py_DECREF(newstr);
6814 posix_error();
6815 return NULL;
6817 /* Install the first arg and newstr in posix_putenv_garbage;
6818 * this will cause previous value to be collected. This has to
6819 * happen after the real putenv() call because the old value
6820 * was still accessible until then. */
6821 if (PyDict_SetItem(posix_putenv_garbage,
6822 PyTuple_GET_ITEM(args, 0), newstr)) {
6823 /* really not much we can do; just leak */
6824 PyErr_Clear();
6826 else {
6827 Py_DECREF(newstr);
6830 #if defined(PYOS_OS2)
6832 #endif
6833 Py_INCREF(Py_None);
6834 return Py_None;
6836 #endif /* putenv */
6838 #ifdef HAVE_UNSETENV
6839 PyDoc_STRVAR(posix_unsetenv__doc__,
6840 "unsetenv(key)\n\n\
6841 Delete an environment variable.");
6843 static PyObject *
6844 posix_unsetenv(PyObject *self, PyObject *args)
6846 char *s1;
6848 if (!PyArg_ParseTuple(args, "s:unsetenv", &s1))
6849 return NULL;
6851 unsetenv(s1);
6853 /* Remove the key from posix_putenv_garbage;
6854 * this will cause it to be collected. This has to
6855 * happen after the real unsetenv() call because the
6856 * old value was still accessible until then.
6858 if (PyDict_DelItem(posix_putenv_garbage,
6859 PyTuple_GET_ITEM(args, 0))) {
6860 /* really not much we can do; just leak */
6861 PyErr_Clear();
6864 Py_INCREF(Py_None);
6865 return Py_None;
6867 #endif /* unsetenv */
6869 PyDoc_STRVAR(posix_strerror__doc__,
6870 "strerror(code) -> string\n\n\
6871 Translate an error code to a message string.");
6873 static PyObject *
6874 posix_strerror(PyObject *self, PyObject *args)
6876 int code;
6877 char *message;
6878 if (!PyArg_ParseTuple(args, "i:strerror", &code))
6879 return NULL;
6880 message = strerror(code);
6881 if (message == NULL) {
6882 PyErr_SetString(PyExc_ValueError,
6883 "strerror() argument out of range");
6884 return NULL;
6886 return PyString_FromString(message);
6890 #ifdef HAVE_SYS_WAIT_H
6892 #ifdef WCOREDUMP
6893 PyDoc_STRVAR(posix_WCOREDUMP__doc__,
6894 "WCOREDUMP(status) -> bool\n\n\
6895 Return True if the process returning 'status' was dumped to a core file.");
6897 static PyObject *
6898 posix_WCOREDUMP(PyObject *self, PyObject *args)
6900 WAIT_TYPE status;
6901 WAIT_STATUS_INT(status) = 0;
6903 if (!PyArg_ParseTuple(args, "i:WCOREDUMP", &WAIT_STATUS_INT(status)))
6904 return NULL;
6906 return PyBool_FromLong(WCOREDUMP(status));
6908 #endif /* WCOREDUMP */
6910 #ifdef WIFCONTINUED
6911 PyDoc_STRVAR(posix_WIFCONTINUED__doc__,
6912 "WIFCONTINUED(status) -> bool\n\n\
6913 Return True if the process returning 'status' was continued from a\n\
6914 job control stop.");
6916 static PyObject *
6917 posix_WIFCONTINUED(PyObject *self, PyObject *args)
6919 WAIT_TYPE status;
6920 WAIT_STATUS_INT(status) = 0;
6922 if (!PyArg_ParseTuple(args, "i:WCONTINUED", &WAIT_STATUS_INT(status)))
6923 return NULL;
6925 return PyBool_FromLong(WIFCONTINUED(status));
6927 #endif /* WIFCONTINUED */
6929 #ifdef WIFSTOPPED
6930 PyDoc_STRVAR(posix_WIFSTOPPED__doc__,
6931 "WIFSTOPPED(status) -> bool\n\n\
6932 Return True if the process returning 'status' was stopped.");
6934 static PyObject *
6935 posix_WIFSTOPPED(PyObject *self, PyObject *args)
6937 WAIT_TYPE status;
6938 WAIT_STATUS_INT(status) = 0;
6940 if (!PyArg_ParseTuple(args, "i:WIFSTOPPED", &WAIT_STATUS_INT(status)))
6941 return NULL;
6943 return PyBool_FromLong(WIFSTOPPED(status));
6945 #endif /* WIFSTOPPED */
6947 #ifdef WIFSIGNALED
6948 PyDoc_STRVAR(posix_WIFSIGNALED__doc__,
6949 "WIFSIGNALED(status) -> bool\n\n\
6950 Return True if the process returning 'status' was terminated by a signal.");
6952 static PyObject *
6953 posix_WIFSIGNALED(PyObject *self, PyObject *args)
6955 WAIT_TYPE status;
6956 WAIT_STATUS_INT(status) = 0;
6958 if (!PyArg_ParseTuple(args, "i:WIFSIGNALED", &WAIT_STATUS_INT(status)))
6959 return NULL;
6961 return PyBool_FromLong(WIFSIGNALED(status));
6963 #endif /* WIFSIGNALED */
6965 #ifdef WIFEXITED
6966 PyDoc_STRVAR(posix_WIFEXITED__doc__,
6967 "WIFEXITED(status) -> bool\n\n\
6968 Return true if the process returning 'status' exited using the exit()\n\
6969 system call.");
6971 static PyObject *
6972 posix_WIFEXITED(PyObject *self, PyObject *args)
6974 WAIT_TYPE status;
6975 WAIT_STATUS_INT(status) = 0;
6977 if (!PyArg_ParseTuple(args, "i:WIFEXITED", &WAIT_STATUS_INT(status)))
6978 return NULL;
6980 return PyBool_FromLong(WIFEXITED(status));
6982 #endif /* WIFEXITED */
6984 #ifdef WEXITSTATUS
6985 PyDoc_STRVAR(posix_WEXITSTATUS__doc__,
6986 "WEXITSTATUS(status) -> integer\n\n\
6987 Return the process return code from 'status'.");
6989 static PyObject *
6990 posix_WEXITSTATUS(PyObject *self, PyObject *args)
6992 WAIT_TYPE status;
6993 WAIT_STATUS_INT(status) = 0;
6995 if (!PyArg_ParseTuple(args, "i:WEXITSTATUS", &WAIT_STATUS_INT(status)))
6996 return NULL;
6998 return Py_BuildValue("i", WEXITSTATUS(status));
7000 #endif /* WEXITSTATUS */
7002 #ifdef WTERMSIG
7003 PyDoc_STRVAR(posix_WTERMSIG__doc__,
7004 "WTERMSIG(status) -> integer\n\n\
7005 Return the signal that terminated the process that provided the 'status'\n\
7006 value.");
7008 static PyObject *
7009 posix_WTERMSIG(PyObject *self, PyObject *args)
7011 WAIT_TYPE status;
7012 WAIT_STATUS_INT(status) = 0;
7014 if (!PyArg_ParseTuple(args, "i:WTERMSIG", &WAIT_STATUS_INT(status)))
7015 return NULL;
7017 return Py_BuildValue("i", WTERMSIG(status));
7019 #endif /* WTERMSIG */
7021 #ifdef WSTOPSIG
7022 PyDoc_STRVAR(posix_WSTOPSIG__doc__,
7023 "WSTOPSIG(status) -> integer\n\n\
7024 Return the signal that stopped the process that provided\n\
7025 the 'status' value.");
7027 static PyObject *
7028 posix_WSTOPSIG(PyObject *self, PyObject *args)
7030 WAIT_TYPE status;
7031 WAIT_STATUS_INT(status) = 0;
7033 if (!PyArg_ParseTuple(args, "i:WSTOPSIG", &WAIT_STATUS_INT(status)))
7034 return NULL;
7036 return Py_BuildValue("i", WSTOPSIG(status));
7038 #endif /* WSTOPSIG */
7040 #endif /* HAVE_SYS_WAIT_H */
7043 #if defined(HAVE_FSTATVFS) && defined(HAVE_SYS_STATVFS_H)
7044 #ifdef _SCO_DS
7045 /* SCO OpenServer 5.0 and later requires _SVID3 before it reveals the
7046 needed definitions in sys/statvfs.h */
7047 #define _SVID3
7048 #endif
7049 #include <sys/statvfs.h>
7051 static PyObject*
7052 _pystatvfs_fromstructstatvfs(struct statvfs st) {
7053 PyObject *v = PyStructSequence_New(&StatVFSResultType);
7054 if (v == NULL)
7055 return NULL;
7057 #if !defined(HAVE_LARGEFILE_SUPPORT)
7058 PyStructSequence_SET_ITEM(v, 0, PyInt_FromLong((long) st.f_bsize));
7059 PyStructSequence_SET_ITEM(v, 1, PyInt_FromLong((long) st.f_frsize));
7060 PyStructSequence_SET_ITEM(v, 2, PyInt_FromLong((long) st.f_blocks));
7061 PyStructSequence_SET_ITEM(v, 3, PyInt_FromLong((long) st.f_bfree));
7062 PyStructSequence_SET_ITEM(v, 4, PyInt_FromLong((long) st.f_bavail));
7063 PyStructSequence_SET_ITEM(v, 5, PyInt_FromLong((long) st.f_files));
7064 PyStructSequence_SET_ITEM(v, 6, PyInt_FromLong((long) st.f_ffree));
7065 PyStructSequence_SET_ITEM(v, 7, PyInt_FromLong((long) st.f_favail));
7066 PyStructSequence_SET_ITEM(v, 8, PyInt_FromLong((long) st.f_flag));
7067 PyStructSequence_SET_ITEM(v, 9, PyInt_FromLong((long) st.f_namemax));
7068 #else
7069 PyStructSequence_SET_ITEM(v, 0, PyInt_FromLong((long) st.f_bsize));
7070 PyStructSequence_SET_ITEM(v, 1, PyInt_FromLong((long) st.f_frsize));
7071 PyStructSequence_SET_ITEM(v, 2,
7072 PyLong_FromLongLong((PY_LONG_LONG) st.f_blocks));
7073 PyStructSequence_SET_ITEM(v, 3,
7074 PyLong_FromLongLong((PY_LONG_LONG) st.f_bfree));
7075 PyStructSequence_SET_ITEM(v, 4,
7076 PyLong_FromLongLong((PY_LONG_LONG) st.f_bavail));
7077 PyStructSequence_SET_ITEM(v, 5,
7078 PyLong_FromLongLong((PY_LONG_LONG) st.f_files));
7079 PyStructSequence_SET_ITEM(v, 6,
7080 PyLong_FromLongLong((PY_LONG_LONG) st.f_ffree));
7081 PyStructSequence_SET_ITEM(v, 7,
7082 PyLong_FromLongLong((PY_LONG_LONG) st.f_favail));
7083 PyStructSequence_SET_ITEM(v, 8, PyInt_FromLong((long) st.f_flag));
7084 PyStructSequence_SET_ITEM(v, 9, PyInt_FromLong((long) st.f_namemax));
7085 #endif
7087 return v;
7090 PyDoc_STRVAR(posix_fstatvfs__doc__,
7091 "fstatvfs(fd) -> statvfs result\n\n\
7092 Perform an fstatvfs system call on the given fd.");
7094 static PyObject *
7095 posix_fstatvfs(PyObject *self, PyObject *args)
7097 int fd, res;
7098 struct statvfs st;
7100 if (!PyArg_ParseTuple(args, "i:fstatvfs", &fd))
7101 return NULL;
7102 Py_BEGIN_ALLOW_THREADS
7103 res = fstatvfs(fd, &st);
7104 Py_END_ALLOW_THREADS
7105 if (res != 0)
7106 return posix_error();
7108 return _pystatvfs_fromstructstatvfs(st);
7110 #endif /* HAVE_FSTATVFS && HAVE_SYS_STATVFS_H */
7113 #if defined(HAVE_STATVFS) && defined(HAVE_SYS_STATVFS_H)
7114 #include <sys/statvfs.h>
7116 PyDoc_STRVAR(posix_statvfs__doc__,
7117 "statvfs(path) -> statvfs result\n\n\
7118 Perform a statvfs system call on the given path.");
7120 static PyObject *
7121 posix_statvfs(PyObject *self, PyObject *args)
7123 char *path;
7124 int res;
7125 struct statvfs st;
7126 if (!PyArg_ParseTuple(args, "s:statvfs", &path))
7127 return NULL;
7128 Py_BEGIN_ALLOW_THREADS
7129 res = statvfs(path, &st);
7130 Py_END_ALLOW_THREADS
7131 if (res != 0)
7132 return posix_error_with_filename(path);
7134 return _pystatvfs_fromstructstatvfs(st);
7136 #endif /* HAVE_STATVFS */
7139 #ifdef HAVE_TEMPNAM
7140 PyDoc_STRVAR(posix_tempnam__doc__,
7141 "tempnam([dir[, prefix]]) -> string\n\n\
7142 Return a unique name for a temporary file.\n\
7143 The directory and a prefix may be specified as strings; they may be omitted\n\
7144 or None if not needed.");
7146 static PyObject *
7147 posix_tempnam(PyObject *self, PyObject *args)
7149 PyObject *result = NULL;
7150 char *dir = NULL;
7151 char *pfx = NULL;
7152 char *name;
7154 if (!PyArg_ParseTuple(args, "|zz:tempnam", &dir, &pfx))
7155 return NULL;
7157 if (PyErr_Warn(PyExc_RuntimeWarning,
7158 "tempnam is a potential security risk to your program") < 0)
7159 return NULL;
7161 #ifdef MS_WINDOWS
7162 name = _tempnam(dir, pfx);
7163 #else
7164 name = tempnam(dir, pfx);
7165 #endif
7166 if (name == NULL)
7167 return PyErr_NoMemory();
7168 result = PyString_FromString(name);
7169 free(name);
7170 return result;
7172 #endif
7175 #ifdef HAVE_TMPFILE
7176 PyDoc_STRVAR(posix_tmpfile__doc__,
7177 "tmpfile() -> file object\n\n\
7178 Create a temporary file with no directory entries.");
7180 static PyObject *
7181 posix_tmpfile(PyObject *self, PyObject *noargs)
7183 FILE *fp;
7185 fp = tmpfile();
7186 if (fp == NULL)
7187 return posix_error();
7188 return PyFile_FromFile(fp, "<tmpfile>", "w+b", fclose);
7190 #endif
7193 #ifdef HAVE_TMPNAM
7194 PyDoc_STRVAR(posix_tmpnam__doc__,
7195 "tmpnam() -> string\n\n\
7196 Return a unique name for a temporary file.");
7198 static PyObject *
7199 posix_tmpnam(PyObject *self, PyObject *noargs)
7201 char buffer[L_tmpnam];
7202 char *name;
7204 if (PyErr_Warn(PyExc_RuntimeWarning,
7205 "tmpnam is a potential security risk to your program") < 0)
7206 return NULL;
7208 #ifdef USE_TMPNAM_R
7209 name = tmpnam_r(buffer);
7210 #else
7211 name = tmpnam(buffer);
7212 #endif
7213 if (name == NULL) {
7214 PyObject *err = Py_BuildValue("is", 0,
7215 #ifdef USE_TMPNAM_R
7216 "unexpected NULL from tmpnam_r"
7217 #else
7218 "unexpected NULL from tmpnam"
7219 #endif
7221 PyErr_SetObject(PyExc_OSError, err);
7222 Py_XDECREF(err);
7223 return NULL;
7225 return PyString_FromString(buffer);
7227 #endif
7230 /* This is used for fpathconf(), pathconf(), confstr() and sysconf().
7231 * It maps strings representing configuration variable names to
7232 * integer values, allowing those functions to be called with the
7233 * magic names instead of polluting the module's namespace with tons of
7234 * rarely-used constants. There are three separate tables that use
7235 * these definitions.
7237 * This code is always included, even if none of the interfaces that
7238 * need it are included. The #if hackery needed to avoid it would be
7239 * sufficiently pervasive that it's not worth the loss of readability.
7241 struct constdef {
7242 char *name;
7243 long value;
7246 static int
7247 conv_confname(PyObject *arg, int *valuep, struct constdef *table,
7248 size_t tablesize)
7250 if (PyInt_Check(arg)) {
7251 *valuep = PyInt_AS_LONG(arg);
7252 return 1;
7254 if (PyString_Check(arg)) {
7255 /* look up the value in the table using a binary search */
7256 size_t lo = 0;
7257 size_t mid;
7258 size_t hi = tablesize;
7259 int cmp;
7260 char *confname = PyString_AS_STRING(arg);
7261 while (lo < hi) {
7262 mid = (lo + hi) / 2;
7263 cmp = strcmp(confname, table[mid].name);
7264 if (cmp < 0)
7265 hi = mid;
7266 else if (cmp > 0)
7267 lo = mid + 1;
7268 else {
7269 *valuep = table[mid].value;
7270 return 1;
7273 PyErr_SetString(PyExc_ValueError, "unrecognized configuration name");
7275 else
7276 PyErr_SetString(PyExc_TypeError,
7277 "configuration names must be strings or integers");
7278 return 0;
7282 #if defined(HAVE_FPATHCONF) || defined(HAVE_PATHCONF)
7283 static struct constdef posix_constants_pathconf[] = {
7284 #ifdef _PC_ABI_AIO_XFER_MAX
7285 {"PC_ABI_AIO_XFER_MAX", _PC_ABI_AIO_XFER_MAX},
7286 #endif
7287 #ifdef _PC_ABI_ASYNC_IO
7288 {"PC_ABI_ASYNC_IO", _PC_ABI_ASYNC_IO},
7289 #endif
7290 #ifdef _PC_ASYNC_IO
7291 {"PC_ASYNC_IO", _PC_ASYNC_IO},
7292 #endif
7293 #ifdef _PC_CHOWN_RESTRICTED
7294 {"PC_CHOWN_RESTRICTED", _PC_CHOWN_RESTRICTED},
7295 #endif
7296 #ifdef _PC_FILESIZEBITS
7297 {"PC_FILESIZEBITS", _PC_FILESIZEBITS},
7298 #endif
7299 #ifdef _PC_LAST
7300 {"PC_LAST", _PC_LAST},
7301 #endif
7302 #ifdef _PC_LINK_MAX
7303 {"PC_LINK_MAX", _PC_LINK_MAX},
7304 #endif
7305 #ifdef _PC_MAX_CANON
7306 {"PC_MAX_CANON", _PC_MAX_CANON},
7307 #endif
7308 #ifdef _PC_MAX_INPUT
7309 {"PC_MAX_INPUT", _PC_MAX_INPUT},
7310 #endif
7311 #ifdef _PC_NAME_MAX
7312 {"PC_NAME_MAX", _PC_NAME_MAX},
7313 #endif
7314 #ifdef _PC_NO_TRUNC
7315 {"PC_NO_TRUNC", _PC_NO_TRUNC},
7316 #endif
7317 #ifdef _PC_PATH_MAX
7318 {"PC_PATH_MAX", _PC_PATH_MAX},
7319 #endif
7320 #ifdef _PC_PIPE_BUF
7321 {"PC_PIPE_BUF", _PC_PIPE_BUF},
7322 #endif
7323 #ifdef _PC_PRIO_IO
7324 {"PC_PRIO_IO", _PC_PRIO_IO},
7325 #endif
7326 #ifdef _PC_SOCK_MAXBUF
7327 {"PC_SOCK_MAXBUF", _PC_SOCK_MAXBUF},
7328 #endif
7329 #ifdef _PC_SYNC_IO
7330 {"PC_SYNC_IO", _PC_SYNC_IO},
7331 #endif
7332 #ifdef _PC_VDISABLE
7333 {"PC_VDISABLE", _PC_VDISABLE},
7334 #endif
7337 static int
7338 conv_path_confname(PyObject *arg, int *valuep)
7340 return conv_confname(arg, valuep, posix_constants_pathconf,
7341 sizeof(posix_constants_pathconf)
7342 / sizeof(struct constdef));
7344 #endif
7346 #ifdef HAVE_FPATHCONF
7347 PyDoc_STRVAR(posix_fpathconf__doc__,
7348 "fpathconf(fd, name) -> integer\n\n\
7349 Return the configuration limit name for the file descriptor fd.\n\
7350 If there is no limit, return -1.");
7352 static PyObject *
7353 posix_fpathconf(PyObject *self, PyObject *args)
7355 PyObject *result = NULL;
7356 int name, fd;
7358 if (PyArg_ParseTuple(args, "iO&:fpathconf", &fd,
7359 conv_path_confname, &name)) {
7360 long limit;
7362 errno = 0;
7363 limit = fpathconf(fd, name);
7364 if (limit == -1 && errno != 0)
7365 posix_error();
7366 else
7367 result = PyInt_FromLong(limit);
7369 return result;
7371 #endif
7374 #ifdef HAVE_PATHCONF
7375 PyDoc_STRVAR(posix_pathconf__doc__,
7376 "pathconf(path, name) -> integer\n\n\
7377 Return the configuration limit name for the file or directory path.\n\
7378 If there is no limit, return -1.");
7380 static PyObject *
7381 posix_pathconf(PyObject *self, PyObject *args)
7383 PyObject *result = NULL;
7384 int name;
7385 char *path;
7387 if (PyArg_ParseTuple(args, "sO&:pathconf", &path,
7388 conv_path_confname, &name)) {
7389 long limit;
7391 errno = 0;
7392 limit = pathconf(path, name);
7393 if (limit == -1 && errno != 0) {
7394 if (errno == EINVAL)
7395 /* could be a path or name problem */
7396 posix_error();
7397 else
7398 posix_error_with_filename(path);
7400 else
7401 result = PyInt_FromLong(limit);
7403 return result;
7405 #endif
7407 #ifdef HAVE_CONFSTR
7408 static struct constdef posix_constants_confstr[] = {
7409 #ifdef _CS_ARCHITECTURE
7410 {"CS_ARCHITECTURE", _CS_ARCHITECTURE},
7411 #endif
7412 #ifdef _CS_HOSTNAME
7413 {"CS_HOSTNAME", _CS_HOSTNAME},
7414 #endif
7415 #ifdef _CS_HW_PROVIDER
7416 {"CS_HW_PROVIDER", _CS_HW_PROVIDER},
7417 #endif
7418 #ifdef _CS_HW_SERIAL
7419 {"CS_HW_SERIAL", _CS_HW_SERIAL},
7420 #endif
7421 #ifdef _CS_INITTAB_NAME
7422 {"CS_INITTAB_NAME", _CS_INITTAB_NAME},
7423 #endif
7424 #ifdef _CS_LFS64_CFLAGS
7425 {"CS_LFS64_CFLAGS", _CS_LFS64_CFLAGS},
7426 #endif
7427 #ifdef _CS_LFS64_LDFLAGS
7428 {"CS_LFS64_LDFLAGS", _CS_LFS64_LDFLAGS},
7429 #endif
7430 #ifdef _CS_LFS64_LIBS
7431 {"CS_LFS64_LIBS", _CS_LFS64_LIBS},
7432 #endif
7433 #ifdef _CS_LFS64_LINTFLAGS
7434 {"CS_LFS64_LINTFLAGS", _CS_LFS64_LINTFLAGS},
7435 #endif
7436 #ifdef _CS_LFS_CFLAGS
7437 {"CS_LFS_CFLAGS", _CS_LFS_CFLAGS},
7438 #endif
7439 #ifdef _CS_LFS_LDFLAGS
7440 {"CS_LFS_LDFLAGS", _CS_LFS_LDFLAGS},
7441 #endif
7442 #ifdef _CS_LFS_LIBS
7443 {"CS_LFS_LIBS", _CS_LFS_LIBS},
7444 #endif
7445 #ifdef _CS_LFS_LINTFLAGS
7446 {"CS_LFS_LINTFLAGS", _CS_LFS_LINTFLAGS},
7447 #endif
7448 #ifdef _CS_MACHINE
7449 {"CS_MACHINE", _CS_MACHINE},
7450 #endif
7451 #ifdef _CS_PATH
7452 {"CS_PATH", _CS_PATH},
7453 #endif
7454 #ifdef _CS_RELEASE
7455 {"CS_RELEASE", _CS_RELEASE},
7456 #endif
7457 #ifdef _CS_SRPC_DOMAIN
7458 {"CS_SRPC_DOMAIN", _CS_SRPC_DOMAIN},
7459 #endif
7460 #ifdef _CS_SYSNAME
7461 {"CS_SYSNAME", _CS_SYSNAME},
7462 #endif
7463 #ifdef _CS_VERSION
7464 {"CS_VERSION", _CS_VERSION},
7465 #endif
7466 #ifdef _CS_XBS5_ILP32_OFF32_CFLAGS
7467 {"CS_XBS5_ILP32_OFF32_CFLAGS", _CS_XBS5_ILP32_OFF32_CFLAGS},
7468 #endif
7469 #ifdef _CS_XBS5_ILP32_OFF32_LDFLAGS
7470 {"CS_XBS5_ILP32_OFF32_LDFLAGS", _CS_XBS5_ILP32_OFF32_LDFLAGS},
7471 #endif
7472 #ifdef _CS_XBS5_ILP32_OFF32_LIBS
7473 {"CS_XBS5_ILP32_OFF32_LIBS", _CS_XBS5_ILP32_OFF32_LIBS},
7474 #endif
7475 #ifdef _CS_XBS5_ILP32_OFF32_LINTFLAGS
7476 {"CS_XBS5_ILP32_OFF32_LINTFLAGS", _CS_XBS5_ILP32_OFF32_LINTFLAGS},
7477 #endif
7478 #ifdef _CS_XBS5_ILP32_OFFBIG_CFLAGS
7479 {"CS_XBS5_ILP32_OFFBIG_CFLAGS", _CS_XBS5_ILP32_OFFBIG_CFLAGS},
7480 #endif
7481 #ifdef _CS_XBS5_ILP32_OFFBIG_LDFLAGS
7482 {"CS_XBS5_ILP32_OFFBIG_LDFLAGS", _CS_XBS5_ILP32_OFFBIG_LDFLAGS},
7483 #endif
7484 #ifdef _CS_XBS5_ILP32_OFFBIG_LIBS
7485 {"CS_XBS5_ILP32_OFFBIG_LIBS", _CS_XBS5_ILP32_OFFBIG_LIBS},
7486 #endif
7487 #ifdef _CS_XBS5_ILP32_OFFBIG_LINTFLAGS
7488 {"CS_XBS5_ILP32_OFFBIG_LINTFLAGS", _CS_XBS5_ILP32_OFFBIG_LINTFLAGS},
7489 #endif
7490 #ifdef _CS_XBS5_LP64_OFF64_CFLAGS
7491 {"CS_XBS5_LP64_OFF64_CFLAGS", _CS_XBS5_LP64_OFF64_CFLAGS},
7492 #endif
7493 #ifdef _CS_XBS5_LP64_OFF64_LDFLAGS
7494 {"CS_XBS5_LP64_OFF64_LDFLAGS", _CS_XBS5_LP64_OFF64_LDFLAGS},
7495 #endif
7496 #ifdef _CS_XBS5_LP64_OFF64_LIBS
7497 {"CS_XBS5_LP64_OFF64_LIBS", _CS_XBS5_LP64_OFF64_LIBS},
7498 #endif
7499 #ifdef _CS_XBS5_LP64_OFF64_LINTFLAGS
7500 {"CS_XBS5_LP64_OFF64_LINTFLAGS", _CS_XBS5_LP64_OFF64_LINTFLAGS},
7501 #endif
7502 #ifdef _CS_XBS5_LPBIG_OFFBIG_CFLAGS
7503 {"CS_XBS5_LPBIG_OFFBIG_CFLAGS", _CS_XBS5_LPBIG_OFFBIG_CFLAGS},
7504 #endif
7505 #ifdef _CS_XBS5_LPBIG_OFFBIG_LDFLAGS
7506 {"CS_XBS5_LPBIG_OFFBIG_LDFLAGS", _CS_XBS5_LPBIG_OFFBIG_LDFLAGS},
7507 #endif
7508 #ifdef _CS_XBS5_LPBIG_OFFBIG_LIBS
7509 {"CS_XBS5_LPBIG_OFFBIG_LIBS", _CS_XBS5_LPBIG_OFFBIG_LIBS},
7510 #endif
7511 #ifdef _CS_XBS5_LPBIG_OFFBIG_LINTFLAGS
7512 {"CS_XBS5_LPBIG_OFFBIG_LINTFLAGS", _CS_XBS5_LPBIG_OFFBIG_LINTFLAGS},
7513 #endif
7514 #ifdef _MIPS_CS_AVAIL_PROCESSORS
7515 {"MIPS_CS_AVAIL_PROCESSORS", _MIPS_CS_AVAIL_PROCESSORS},
7516 #endif
7517 #ifdef _MIPS_CS_BASE
7518 {"MIPS_CS_BASE", _MIPS_CS_BASE},
7519 #endif
7520 #ifdef _MIPS_CS_HOSTID
7521 {"MIPS_CS_HOSTID", _MIPS_CS_HOSTID},
7522 #endif
7523 #ifdef _MIPS_CS_HW_NAME
7524 {"MIPS_CS_HW_NAME", _MIPS_CS_HW_NAME},
7525 #endif
7526 #ifdef _MIPS_CS_NUM_PROCESSORS
7527 {"MIPS_CS_NUM_PROCESSORS", _MIPS_CS_NUM_PROCESSORS},
7528 #endif
7529 #ifdef _MIPS_CS_OSREL_MAJ
7530 {"MIPS_CS_OSREL_MAJ", _MIPS_CS_OSREL_MAJ},
7531 #endif
7532 #ifdef _MIPS_CS_OSREL_MIN
7533 {"MIPS_CS_OSREL_MIN", _MIPS_CS_OSREL_MIN},
7534 #endif
7535 #ifdef _MIPS_CS_OSREL_PATCH
7536 {"MIPS_CS_OSREL_PATCH", _MIPS_CS_OSREL_PATCH},
7537 #endif
7538 #ifdef _MIPS_CS_OS_NAME
7539 {"MIPS_CS_OS_NAME", _MIPS_CS_OS_NAME},
7540 #endif
7541 #ifdef _MIPS_CS_OS_PROVIDER
7542 {"MIPS_CS_OS_PROVIDER", _MIPS_CS_OS_PROVIDER},
7543 #endif
7544 #ifdef _MIPS_CS_PROCESSORS
7545 {"MIPS_CS_PROCESSORS", _MIPS_CS_PROCESSORS},
7546 #endif
7547 #ifdef _MIPS_CS_SERIAL
7548 {"MIPS_CS_SERIAL", _MIPS_CS_SERIAL},
7549 #endif
7550 #ifdef _MIPS_CS_VENDOR
7551 {"MIPS_CS_VENDOR", _MIPS_CS_VENDOR},
7552 #endif
7555 static int
7556 conv_confstr_confname(PyObject *arg, int *valuep)
7558 return conv_confname(arg, valuep, posix_constants_confstr,
7559 sizeof(posix_constants_confstr)
7560 / sizeof(struct constdef));
7563 PyDoc_STRVAR(posix_confstr__doc__,
7564 "confstr(name) -> string\n\n\
7565 Return a string-valued system configuration variable.");
7567 static PyObject *
7568 posix_confstr(PyObject *self, PyObject *args)
7570 PyObject *result = NULL;
7571 int name;
7572 char buffer[256];
7574 if (PyArg_ParseTuple(args, "O&:confstr", conv_confstr_confname, &name)) {
7575 int len;
7577 errno = 0;
7578 len = confstr(name, buffer, sizeof(buffer));
7579 if (len == 0) {
7580 if (errno) {
7581 posix_error();
7583 else {
7584 result = Py_None;
7585 Py_INCREF(Py_None);
7588 else {
7589 if ((unsigned int)len >= sizeof(buffer)) {
7590 result = PyString_FromStringAndSize(NULL, len-1);
7591 if (result != NULL)
7592 confstr(name, PyString_AS_STRING(result), len);
7594 else
7595 result = PyString_FromStringAndSize(buffer, len-1);
7598 return result;
7600 #endif
7603 #ifdef HAVE_SYSCONF
7604 static struct constdef posix_constants_sysconf[] = {
7605 #ifdef _SC_2_CHAR_TERM
7606 {"SC_2_CHAR_TERM", _SC_2_CHAR_TERM},
7607 #endif
7608 #ifdef _SC_2_C_BIND
7609 {"SC_2_C_BIND", _SC_2_C_BIND},
7610 #endif
7611 #ifdef _SC_2_C_DEV
7612 {"SC_2_C_DEV", _SC_2_C_DEV},
7613 #endif
7614 #ifdef _SC_2_C_VERSION
7615 {"SC_2_C_VERSION", _SC_2_C_VERSION},
7616 #endif
7617 #ifdef _SC_2_FORT_DEV
7618 {"SC_2_FORT_DEV", _SC_2_FORT_DEV},
7619 #endif
7620 #ifdef _SC_2_FORT_RUN
7621 {"SC_2_FORT_RUN", _SC_2_FORT_RUN},
7622 #endif
7623 #ifdef _SC_2_LOCALEDEF
7624 {"SC_2_LOCALEDEF", _SC_2_LOCALEDEF},
7625 #endif
7626 #ifdef _SC_2_SW_DEV
7627 {"SC_2_SW_DEV", _SC_2_SW_DEV},
7628 #endif
7629 #ifdef _SC_2_UPE
7630 {"SC_2_UPE", _SC_2_UPE},
7631 #endif
7632 #ifdef _SC_2_VERSION
7633 {"SC_2_VERSION", _SC_2_VERSION},
7634 #endif
7635 #ifdef _SC_ABI_ASYNCHRONOUS_IO
7636 {"SC_ABI_ASYNCHRONOUS_IO", _SC_ABI_ASYNCHRONOUS_IO},
7637 #endif
7638 #ifdef _SC_ACL
7639 {"SC_ACL", _SC_ACL},
7640 #endif
7641 #ifdef _SC_AIO_LISTIO_MAX
7642 {"SC_AIO_LISTIO_MAX", _SC_AIO_LISTIO_MAX},
7643 #endif
7644 #ifdef _SC_AIO_MAX
7645 {"SC_AIO_MAX", _SC_AIO_MAX},
7646 #endif
7647 #ifdef _SC_AIO_PRIO_DELTA_MAX
7648 {"SC_AIO_PRIO_DELTA_MAX", _SC_AIO_PRIO_DELTA_MAX},
7649 #endif
7650 #ifdef _SC_ARG_MAX
7651 {"SC_ARG_MAX", _SC_ARG_MAX},
7652 #endif
7653 #ifdef _SC_ASYNCHRONOUS_IO
7654 {"SC_ASYNCHRONOUS_IO", _SC_ASYNCHRONOUS_IO},
7655 #endif
7656 #ifdef _SC_ATEXIT_MAX
7657 {"SC_ATEXIT_MAX", _SC_ATEXIT_MAX},
7658 #endif
7659 #ifdef _SC_AUDIT
7660 {"SC_AUDIT", _SC_AUDIT},
7661 #endif
7662 #ifdef _SC_AVPHYS_PAGES
7663 {"SC_AVPHYS_PAGES", _SC_AVPHYS_PAGES},
7664 #endif
7665 #ifdef _SC_BC_BASE_MAX
7666 {"SC_BC_BASE_MAX", _SC_BC_BASE_MAX},
7667 #endif
7668 #ifdef _SC_BC_DIM_MAX
7669 {"SC_BC_DIM_MAX", _SC_BC_DIM_MAX},
7670 #endif
7671 #ifdef _SC_BC_SCALE_MAX
7672 {"SC_BC_SCALE_MAX", _SC_BC_SCALE_MAX},
7673 #endif
7674 #ifdef _SC_BC_STRING_MAX
7675 {"SC_BC_STRING_MAX", _SC_BC_STRING_MAX},
7676 #endif
7677 #ifdef _SC_CAP
7678 {"SC_CAP", _SC_CAP},
7679 #endif
7680 #ifdef _SC_CHARCLASS_NAME_MAX
7681 {"SC_CHARCLASS_NAME_MAX", _SC_CHARCLASS_NAME_MAX},
7682 #endif
7683 #ifdef _SC_CHAR_BIT
7684 {"SC_CHAR_BIT", _SC_CHAR_BIT},
7685 #endif
7686 #ifdef _SC_CHAR_MAX
7687 {"SC_CHAR_MAX", _SC_CHAR_MAX},
7688 #endif
7689 #ifdef _SC_CHAR_MIN
7690 {"SC_CHAR_MIN", _SC_CHAR_MIN},
7691 #endif
7692 #ifdef _SC_CHILD_MAX
7693 {"SC_CHILD_MAX", _SC_CHILD_MAX},
7694 #endif
7695 #ifdef _SC_CLK_TCK
7696 {"SC_CLK_TCK", _SC_CLK_TCK},
7697 #endif
7698 #ifdef _SC_COHER_BLKSZ
7699 {"SC_COHER_BLKSZ", _SC_COHER_BLKSZ},
7700 #endif
7701 #ifdef _SC_COLL_WEIGHTS_MAX
7702 {"SC_COLL_WEIGHTS_MAX", _SC_COLL_WEIGHTS_MAX},
7703 #endif
7704 #ifdef _SC_DCACHE_ASSOC
7705 {"SC_DCACHE_ASSOC", _SC_DCACHE_ASSOC},
7706 #endif
7707 #ifdef _SC_DCACHE_BLKSZ
7708 {"SC_DCACHE_BLKSZ", _SC_DCACHE_BLKSZ},
7709 #endif
7710 #ifdef _SC_DCACHE_LINESZ
7711 {"SC_DCACHE_LINESZ", _SC_DCACHE_LINESZ},
7712 #endif
7713 #ifdef _SC_DCACHE_SZ
7714 {"SC_DCACHE_SZ", _SC_DCACHE_SZ},
7715 #endif
7716 #ifdef _SC_DCACHE_TBLKSZ
7717 {"SC_DCACHE_TBLKSZ", _SC_DCACHE_TBLKSZ},
7718 #endif
7719 #ifdef _SC_DELAYTIMER_MAX
7720 {"SC_DELAYTIMER_MAX", _SC_DELAYTIMER_MAX},
7721 #endif
7722 #ifdef _SC_EQUIV_CLASS_MAX
7723 {"SC_EQUIV_CLASS_MAX", _SC_EQUIV_CLASS_MAX},
7724 #endif
7725 #ifdef _SC_EXPR_NEST_MAX
7726 {"SC_EXPR_NEST_MAX", _SC_EXPR_NEST_MAX},
7727 #endif
7728 #ifdef _SC_FSYNC
7729 {"SC_FSYNC", _SC_FSYNC},
7730 #endif
7731 #ifdef _SC_GETGR_R_SIZE_MAX
7732 {"SC_GETGR_R_SIZE_MAX", _SC_GETGR_R_SIZE_MAX},
7733 #endif
7734 #ifdef _SC_GETPW_R_SIZE_MAX
7735 {"SC_GETPW_R_SIZE_MAX", _SC_GETPW_R_SIZE_MAX},
7736 #endif
7737 #ifdef _SC_ICACHE_ASSOC
7738 {"SC_ICACHE_ASSOC", _SC_ICACHE_ASSOC},
7739 #endif
7740 #ifdef _SC_ICACHE_BLKSZ
7741 {"SC_ICACHE_BLKSZ", _SC_ICACHE_BLKSZ},
7742 #endif
7743 #ifdef _SC_ICACHE_LINESZ
7744 {"SC_ICACHE_LINESZ", _SC_ICACHE_LINESZ},
7745 #endif
7746 #ifdef _SC_ICACHE_SZ
7747 {"SC_ICACHE_SZ", _SC_ICACHE_SZ},
7748 #endif
7749 #ifdef _SC_INF
7750 {"SC_INF", _SC_INF},
7751 #endif
7752 #ifdef _SC_INT_MAX
7753 {"SC_INT_MAX", _SC_INT_MAX},
7754 #endif
7755 #ifdef _SC_INT_MIN
7756 {"SC_INT_MIN", _SC_INT_MIN},
7757 #endif
7758 #ifdef _SC_IOV_MAX
7759 {"SC_IOV_MAX", _SC_IOV_MAX},
7760 #endif
7761 #ifdef _SC_IP_SECOPTS
7762 {"SC_IP_SECOPTS", _SC_IP_SECOPTS},
7763 #endif
7764 #ifdef _SC_JOB_CONTROL
7765 {"SC_JOB_CONTROL", _SC_JOB_CONTROL},
7766 #endif
7767 #ifdef _SC_KERN_POINTERS
7768 {"SC_KERN_POINTERS", _SC_KERN_POINTERS},
7769 #endif
7770 #ifdef _SC_KERN_SIM
7771 {"SC_KERN_SIM", _SC_KERN_SIM},
7772 #endif
7773 #ifdef _SC_LINE_MAX
7774 {"SC_LINE_MAX", _SC_LINE_MAX},
7775 #endif
7776 #ifdef _SC_LOGIN_NAME_MAX
7777 {"SC_LOGIN_NAME_MAX", _SC_LOGIN_NAME_MAX},
7778 #endif
7779 #ifdef _SC_LOGNAME_MAX
7780 {"SC_LOGNAME_MAX", _SC_LOGNAME_MAX},
7781 #endif
7782 #ifdef _SC_LONG_BIT
7783 {"SC_LONG_BIT", _SC_LONG_BIT},
7784 #endif
7785 #ifdef _SC_MAC
7786 {"SC_MAC", _SC_MAC},
7787 #endif
7788 #ifdef _SC_MAPPED_FILES
7789 {"SC_MAPPED_FILES", _SC_MAPPED_FILES},
7790 #endif
7791 #ifdef _SC_MAXPID
7792 {"SC_MAXPID", _SC_MAXPID},
7793 #endif
7794 #ifdef _SC_MB_LEN_MAX
7795 {"SC_MB_LEN_MAX", _SC_MB_LEN_MAX},
7796 #endif
7797 #ifdef _SC_MEMLOCK
7798 {"SC_MEMLOCK", _SC_MEMLOCK},
7799 #endif
7800 #ifdef _SC_MEMLOCK_RANGE
7801 {"SC_MEMLOCK_RANGE", _SC_MEMLOCK_RANGE},
7802 #endif
7803 #ifdef _SC_MEMORY_PROTECTION
7804 {"SC_MEMORY_PROTECTION", _SC_MEMORY_PROTECTION},
7805 #endif
7806 #ifdef _SC_MESSAGE_PASSING
7807 {"SC_MESSAGE_PASSING", _SC_MESSAGE_PASSING},
7808 #endif
7809 #ifdef _SC_MMAP_FIXED_ALIGNMENT
7810 {"SC_MMAP_FIXED_ALIGNMENT", _SC_MMAP_FIXED_ALIGNMENT},
7811 #endif
7812 #ifdef _SC_MQ_OPEN_MAX
7813 {"SC_MQ_OPEN_MAX", _SC_MQ_OPEN_MAX},
7814 #endif
7815 #ifdef _SC_MQ_PRIO_MAX
7816 {"SC_MQ_PRIO_MAX", _SC_MQ_PRIO_MAX},
7817 #endif
7818 #ifdef _SC_NACLS_MAX
7819 {"SC_NACLS_MAX", _SC_NACLS_MAX},
7820 #endif
7821 #ifdef _SC_NGROUPS_MAX
7822 {"SC_NGROUPS_MAX", _SC_NGROUPS_MAX},
7823 #endif
7824 #ifdef _SC_NL_ARGMAX
7825 {"SC_NL_ARGMAX", _SC_NL_ARGMAX},
7826 #endif
7827 #ifdef _SC_NL_LANGMAX
7828 {"SC_NL_LANGMAX", _SC_NL_LANGMAX},
7829 #endif
7830 #ifdef _SC_NL_MSGMAX
7831 {"SC_NL_MSGMAX", _SC_NL_MSGMAX},
7832 #endif
7833 #ifdef _SC_NL_NMAX
7834 {"SC_NL_NMAX", _SC_NL_NMAX},
7835 #endif
7836 #ifdef _SC_NL_SETMAX
7837 {"SC_NL_SETMAX", _SC_NL_SETMAX},
7838 #endif
7839 #ifdef _SC_NL_TEXTMAX
7840 {"SC_NL_TEXTMAX", _SC_NL_TEXTMAX},
7841 #endif
7842 #ifdef _SC_NPROCESSORS_CONF
7843 {"SC_NPROCESSORS_CONF", _SC_NPROCESSORS_CONF},
7844 #endif
7845 #ifdef _SC_NPROCESSORS_ONLN
7846 {"SC_NPROCESSORS_ONLN", _SC_NPROCESSORS_ONLN},
7847 #endif
7848 #ifdef _SC_NPROC_CONF
7849 {"SC_NPROC_CONF", _SC_NPROC_CONF},
7850 #endif
7851 #ifdef _SC_NPROC_ONLN
7852 {"SC_NPROC_ONLN", _SC_NPROC_ONLN},
7853 #endif
7854 #ifdef _SC_NZERO
7855 {"SC_NZERO", _SC_NZERO},
7856 #endif
7857 #ifdef _SC_OPEN_MAX
7858 {"SC_OPEN_MAX", _SC_OPEN_MAX},
7859 #endif
7860 #ifdef _SC_PAGESIZE
7861 {"SC_PAGESIZE", _SC_PAGESIZE},
7862 #endif
7863 #ifdef _SC_PAGE_SIZE
7864 {"SC_PAGE_SIZE", _SC_PAGE_SIZE},
7865 #endif
7866 #ifdef _SC_PASS_MAX
7867 {"SC_PASS_MAX", _SC_PASS_MAX},
7868 #endif
7869 #ifdef _SC_PHYS_PAGES
7870 {"SC_PHYS_PAGES", _SC_PHYS_PAGES},
7871 #endif
7872 #ifdef _SC_PII
7873 {"SC_PII", _SC_PII},
7874 #endif
7875 #ifdef _SC_PII_INTERNET
7876 {"SC_PII_INTERNET", _SC_PII_INTERNET},
7877 #endif
7878 #ifdef _SC_PII_INTERNET_DGRAM
7879 {"SC_PII_INTERNET_DGRAM", _SC_PII_INTERNET_DGRAM},
7880 #endif
7881 #ifdef _SC_PII_INTERNET_STREAM
7882 {"SC_PII_INTERNET_STREAM", _SC_PII_INTERNET_STREAM},
7883 #endif
7884 #ifdef _SC_PII_OSI
7885 {"SC_PII_OSI", _SC_PII_OSI},
7886 #endif
7887 #ifdef _SC_PII_OSI_CLTS
7888 {"SC_PII_OSI_CLTS", _SC_PII_OSI_CLTS},
7889 #endif
7890 #ifdef _SC_PII_OSI_COTS
7891 {"SC_PII_OSI_COTS", _SC_PII_OSI_COTS},
7892 #endif
7893 #ifdef _SC_PII_OSI_M
7894 {"SC_PII_OSI_M", _SC_PII_OSI_M},
7895 #endif
7896 #ifdef _SC_PII_SOCKET
7897 {"SC_PII_SOCKET", _SC_PII_SOCKET},
7898 #endif
7899 #ifdef _SC_PII_XTI
7900 {"SC_PII_XTI", _SC_PII_XTI},
7901 #endif
7902 #ifdef _SC_POLL
7903 {"SC_POLL", _SC_POLL},
7904 #endif
7905 #ifdef _SC_PRIORITIZED_IO
7906 {"SC_PRIORITIZED_IO", _SC_PRIORITIZED_IO},
7907 #endif
7908 #ifdef _SC_PRIORITY_SCHEDULING
7909 {"SC_PRIORITY_SCHEDULING", _SC_PRIORITY_SCHEDULING},
7910 #endif
7911 #ifdef _SC_REALTIME_SIGNALS
7912 {"SC_REALTIME_SIGNALS", _SC_REALTIME_SIGNALS},
7913 #endif
7914 #ifdef _SC_RE_DUP_MAX
7915 {"SC_RE_DUP_MAX", _SC_RE_DUP_MAX},
7916 #endif
7917 #ifdef _SC_RTSIG_MAX
7918 {"SC_RTSIG_MAX", _SC_RTSIG_MAX},
7919 #endif
7920 #ifdef _SC_SAVED_IDS
7921 {"SC_SAVED_IDS", _SC_SAVED_IDS},
7922 #endif
7923 #ifdef _SC_SCHAR_MAX
7924 {"SC_SCHAR_MAX", _SC_SCHAR_MAX},
7925 #endif
7926 #ifdef _SC_SCHAR_MIN
7927 {"SC_SCHAR_MIN", _SC_SCHAR_MIN},
7928 #endif
7929 #ifdef _SC_SELECT
7930 {"SC_SELECT", _SC_SELECT},
7931 #endif
7932 #ifdef _SC_SEMAPHORES
7933 {"SC_SEMAPHORES", _SC_SEMAPHORES},
7934 #endif
7935 #ifdef _SC_SEM_NSEMS_MAX
7936 {"SC_SEM_NSEMS_MAX", _SC_SEM_NSEMS_MAX},
7937 #endif
7938 #ifdef _SC_SEM_VALUE_MAX
7939 {"SC_SEM_VALUE_MAX", _SC_SEM_VALUE_MAX},
7940 #endif
7941 #ifdef _SC_SHARED_MEMORY_OBJECTS
7942 {"SC_SHARED_MEMORY_OBJECTS", _SC_SHARED_MEMORY_OBJECTS},
7943 #endif
7944 #ifdef _SC_SHRT_MAX
7945 {"SC_SHRT_MAX", _SC_SHRT_MAX},
7946 #endif
7947 #ifdef _SC_SHRT_MIN
7948 {"SC_SHRT_MIN", _SC_SHRT_MIN},
7949 #endif
7950 #ifdef _SC_SIGQUEUE_MAX
7951 {"SC_SIGQUEUE_MAX", _SC_SIGQUEUE_MAX},
7952 #endif
7953 #ifdef _SC_SIGRT_MAX
7954 {"SC_SIGRT_MAX", _SC_SIGRT_MAX},
7955 #endif
7956 #ifdef _SC_SIGRT_MIN
7957 {"SC_SIGRT_MIN", _SC_SIGRT_MIN},
7958 #endif
7959 #ifdef _SC_SOFTPOWER
7960 {"SC_SOFTPOWER", _SC_SOFTPOWER},
7961 #endif
7962 #ifdef _SC_SPLIT_CACHE
7963 {"SC_SPLIT_CACHE", _SC_SPLIT_CACHE},
7964 #endif
7965 #ifdef _SC_SSIZE_MAX
7966 {"SC_SSIZE_MAX", _SC_SSIZE_MAX},
7967 #endif
7968 #ifdef _SC_STACK_PROT
7969 {"SC_STACK_PROT", _SC_STACK_PROT},
7970 #endif
7971 #ifdef _SC_STREAM_MAX
7972 {"SC_STREAM_MAX", _SC_STREAM_MAX},
7973 #endif
7974 #ifdef _SC_SYNCHRONIZED_IO
7975 {"SC_SYNCHRONIZED_IO", _SC_SYNCHRONIZED_IO},
7976 #endif
7977 #ifdef _SC_THREADS
7978 {"SC_THREADS", _SC_THREADS},
7979 #endif
7980 #ifdef _SC_THREAD_ATTR_STACKADDR
7981 {"SC_THREAD_ATTR_STACKADDR", _SC_THREAD_ATTR_STACKADDR},
7982 #endif
7983 #ifdef _SC_THREAD_ATTR_STACKSIZE
7984 {"SC_THREAD_ATTR_STACKSIZE", _SC_THREAD_ATTR_STACKSIZE},
7985 #endif
7986 #ifdef _SC_THREAD_DESTRUCTOR_ITERATIONS
7987 {"SC_THREAD_DESTRUCTOR_ITERATIONS", _SC_THREAD_DESTRUCTOR_ITERATIONS},
7988 #endif
7989 #ifdef _SC_THREAD_KEYS_MAX
7990 {"SC_THREAD_KEYS_MAX", _SC_THREAD_KEYS_MAX},
7991 #endif
7992 #ifdef _SC_THREAD_PRIORITY_SCHEDULING
7993 {"SC_THREAD_PRIORITY_SCHEDULING", _SC_THREAD_PRIORITY_SCHEDULING},
7994 #endif
7995 #ifdef _SC_THREAD_PRIO_INHERIT
7996 {"SC_THREAD_PRIO_INHERIT", _SC_THREAD_PRIO_INHERIT},
7997 #endif
7998 #ifdef _SC_THREAD_PRIO_PROTECT
7999 {"SC_THREAD_PRIO_PROTECT", _SC_THREAD_PRIO_PROTECT},
8000 #endif
8001 #ifdef _SC_THREAD_PROCESS_SHARED
8002 {"SC_THREAD_PROCESS_SHARED", _SC_THREAD_PROCESS_SHARED},
8003 #endif
8004 #ifdef _SC_THREAD_SAFE_FUNCTIONS
8005 {"SC_THREAD_SAFE_FUNCTIONS", _SC_THREAD_SAFE_FUNCTIONS},
8006 #endif
8007 #ifdef _SC_THREAD_STACK_MIN
8008 {"SC_THREAD_STACK_MIN", _SC_THREAD_STACK_MIN},
8009 #endif
8010 #ifdef _SC_THREAD_THREADS_MAX
8011 {"SC_THREAD_THREADS_MAX", _SC_THREAD_THREADS_MAX},
8012 #endif
8013 #ifdef _SC_TIMERS
8014 {"SC_TIMERS", _SC_TIMERS},
8015 #endif
8016 #ifdef _SC_TIMER_MAX
8017 {"SC_TIMER_MAX", _SC_TIMER_MAX},
8018 #endif
8019 #ifdef _SC_TTY_NAME_MAX
8020 {"SC_TTY_NAME_MAX", _SC_TTY_NAME_MAX},
8021 #endif
8022 #ifdef _SC_TZNAME_MAX
8023 {"SC_TZNAME_MAX", _SC_TZNAME_MAX},
8024 #endif
8025 #ifdef _SC_T_IOV_MAX
8026 {"SC_T_IOV_MAX", _SC_T_IOV_MAX},
8027 #endif
8028 #ifdef _SC_UCHAR_MAX
8029 {"SC_UCHAR_MAX", _SC_UCHAR_MAX},
8030 #endif
8031 #ifdef _SC_UINT_MAX
8032 {"SC_UINT_MAX", _SC_UINT_MAX},
8033 #endif
8034 #ifdef _SC_UIO_MAXIOV
8035 {"SC_UIO_MAXIOV", _SC_UIO_MAXIOV},
8036 #endif
8037 #ifdef _SC_ULONG_MAX
8038 {"SC_ULONG_MAX", _SC_ULONG_MAX},
8039 #endif
8040 #ifdef _SC_USHRT_MAX
8041 {"SC_USHRT_MAX", _SC_USHRT_MAX},
8042 #endif
8043 #ifdef _SC_VERSION
8044 {"SC_VERSION", _SC_VERSION},
8045 #endif
8046 #ifdef _SC_WORD_BIT
8047 {"SC_WORD_BIT", _SC_WORD_BIT},
8048 #endif
8049 #ifdef _SC_XBS5_ILP32_OFF32
8050 {"SC_XBS5_ILP32_OFF32", _SC_XBS5_ILP32_OFF32},
8051 #endif
8052 #ifdef _SC_XBS5_ILP32_OFFBIG
8053 {"SC_XBS5_ILP32_OFFBIG", _SC_XBS5_ILP32_OFFBIG},
8054 #endif
8055 #ifdef _SC_XBS5_LP64_OFF64
8056 {"SC_XBS5_LP64_OFF64", _SC_XBS5_LP64_OFF64},
8057 #endif
8058 #ifdef _SC_XBS5_LPBIG_OFFBIG
8059 {"SC_XBS5_LPBIG_OFFBIG", _SC_XBS5_LPBIG_OFFBIG},
8060 #endif
8061 #ifdef _SC_XOPEN_CRYPT
8062 {"SC_XOPEN_CRYPT", _SC_XOPEN_CRYPT},
8063 #endif
8064 #ifdef _SC_XOPEN_ENH_I18N
8065 {"SC_XOPEN_ENH_I18N", _SC_XOPEN_ENH_I18N},
8066 #endif
8067 #ifdef _SC_XOPEN_LEGACY
8068 {"SC_XOPEN_LEGACY", _SC_XOPEN_LEGACY},
8069 #endif
8070 #ifdef _SC_XOPEN_REALTIME
8071 {"SC_XOPEN_REALTIME", _SC_XOPEN_REALTIME},
8072 #endif
8073 #ifdef _SC_XOPEN_REALTIME_THREADS
8074 {"SC_XOPEN_REALTIME_THREADS", _SC_XOPEN_REALTIME_THREADS},
8075 #endif
8076 #ifdef _SC_XOPEN_SHM
8077 {"SC_XOPEN_SHM", _SC_XOPEN_SHM},
8078 #endif
8079 #ifdef _SC_XOPEN_UNIX
8080 {"SC_XOPEN_UNIX", _SC_XOPEN_UNIX},
8081 #endif
8082 #ifdef _SC_XOPEN_VERSION
8083 {"SC_XOPEN_VERSION", _SC_XOPEN_VERSION},
8084 #endif
8085 #ifdef _SC_XOPEN_XCU_VERSION
8086 {"SC_XOPEN_XCU_VERSION", _SC_XOPEN_XCU_VERSION},
8087 #endif
8088 #ifdef _SC_XOPEN_XPG2
8089 {"SC_XOPEN_XPG2", _SC_XOPEN_XPG2},
8090 #endif
8091 #ifdef _SC_XOPEN_XPG3
8092 {"SC_XOPEN_XPG3", _SC_XOPEN_XPG3},
8093 #endif
8094 #ifdef _SC_XOPEN_XPG4
8095 {"SC_XOPEN_XPG4", _SC_XOPEN_XPG4},
8096 #endif
8099 static int
8100 conv_sysconf_confname(PyObject *arg, int *valuep)
8102 return conv_confname(arg, valuep, posix_constants_sysconf,
8103 sizeof(posix_constants_sysconf)
8104 / sizeof(struct constdef));
8107 PyDoc_STRVAR(posix_sysconf__doc__,
8108 "sysconf(name) -> integer\n\n\
8109 Return an integer-valued system configuration variable.");
8111 static PyObject *
8112 posix_sysconf(PyObject *self, PyObject *args)
8114 PyObject *result = NULL;
8115 int name;
8117 if (PyArg_ParseTuple(args, "O&:sysconf", conv_sysconf_confname, &name)) {
8118 int value;
8120 errno = 0;
8121 value = sysconf(name);
8122 if (value == -1 && errno != 0)
8123 posix_error();
8124 else
8125 result = PyInt_FromLong(value);
8127 return result;
8129 #endif
8132 /* This code is used to ensure that the tables of configuration value names
8133 * are in sorted order as required by conv_confname(), and also to build the
8134 * the exported dictionaries that are used to publish information about the
8135 * names available on the host platform.
8137 * Sorting the table at runtime ensures that the table is properly ordered
8138 * when used, even for platforms we're not able to test on. It also makes
8139 * it easier to add additional entries to the tables.
8142 static int
8143 cmp_constdefs(const void *v1, const void *v2)
8145 const struct constdef *c1 =
8146 (const struct constdef *) v1;
8147 const struct constdef *c2 =
8148 (const struct constdef *) v2;
8150 return strcmp(c1->name, c2->name);
8153 static int
8154 setup_confname_table(struct constdef *table, size_t tablesize,
8155 char *tablename, PyObject *module)
8157 PyObject *d = NULL;
8158 size_t i;
8160 qsort(table, tablesize, sizeof(struct constdef), cmp_constdefs);
8161 d = PyDict_New();
8162 if (d == NULL)
8163 return -1;
8165 for (i=0; i < tablesize; ++i) {
8166 PyObject *o = PyInt_FromLong(table[i].value);
8167 if (o == NULL || PyDict_SetItemString(d, table[i].name, o) == -1) {
8168 Py_XDECREF(o);
8169 Py_DECREF(d);
8170 return -1;
8172 Py_DECREF(o);
8174 return PyModule_AddObject(module, tablename, d);
8177 /* Return -1 on failure, 0 on success. */
8178 static int
8179 setup_confname_tables(PyObject *module)
8181 #if defined(HAVE_FPATHCONF) || defined(HAVE_PATHCONF)
8182 if (setup_confname_table(posix_constants_pathconf,
8183 sizeof(posix_constants_pathconf)
8184 / sizeof(struct constdef),
8185 "pathconf_names", module))
8186 return -1;
8187 #endif
8188 #ifdef HAVE_CONFSTR
8189 if (setup_confname_table(posix_constants_confstr,
8190 sizeof(posix_constants_confstr)
8191 / sizeof(struct constdef),
8192 "confstr_names", module))
8193 return -1;
8194 #endif
8195 #ifdef HAVE_SYSCONF
8196 if (setup_confname_table(posix_constants_sysconf,
8197 sizeof(posix_constants_sysconf)
8198 / sizeof(struct constdef),
8199 "sysconf_names", module))
8200 return -1;
8201 #endif
8202 return 0;
8206 PyDoc_STRVAR(posix_abort__doc__,
8207 "abort() -> does not return!\n\n\
8208 Abort the interpreter immediately. This 'dumps core' or otherwise fails\n\
8209 in the hardest way possible on the hosting operating system.");
8211 static PyObject *
8212 posix_abort(PyObject *self, PyObject *noargs)
8214 abort();
8215 /*NOTREACHED*/
8216 Py_FatalError("abort() called from Python code didn't abort!");
8217 return NULL;
8220 #ifdef MS_WINDOWS
8221 PyDoc_STRVAR(win32_startfile__doc__,
8222 "startfile(filepath [, operation]) - Start a file with its associated\n\
8223 application.\n\
8225 When \"operation\" is not specified or \"open\", this acts like\n\
8226 double-clicking the file in Explorer, or giving the file name as an\n\
8227 argument to the DOS \"start\" command: the file is opened with whatever\n\
8228 application (if any) its extension is associated.\n\
8229 When another \"operation\" is given, it specifies what should be done with\n\
8230 the file. A typical operation is \"print\".\n\
8232 startfile returns as soon as the associated application is launched.\n\
8233 There is no option to wait for the application to close, and no way\n\
8234 to retrieve the application's exit status.\n\
8236 The filepath is relative to the current directory. If you want to use\n\
8237 an absolute path, make sure the first character is not a slash (\"/\");\n\
8238 the underlying Win32 ShellExecute function doesn't work if it is.");
8240 static PyObject *
8241 win32_startfile(PyObject *self, PyObject *args)
8243 char *filepath;
8244 char *operation = NULL;
8245 HINSTANCE rc;
8246 #ifdef Py_WIN_WIDE_FILENAMES
8247 if (unicode_file_names()) {
8248 PyObject *unipath, *woperation = NULL;
8249 if (!PyArg_ParseTuple(args, "U|s:startfile",
8250 &unipath, &operation)) {
8251 PyErr_Clear();
8252 goto normal;
8256 if (operation) {
8257 woperation = PyUnicode_DecodeASCII(operation,
8258 strlen(operation), NULL);
8259 if (!woperation) {
8260 PyErr_Clear();
8261 operation = NULL;
8262 goto normal;
8266 Py_BEGIN_ALLOW_THREADS
8267 rc = ShellExecuteW((HWND)0, woperation ? PyUnicode_AS_UNICODE(woperation) : 0,
8268 PyUnicode_AS_UNICODE(unipath),
8269 NULL, NULL, SW_SHOWNORMAL);
8270 Py_END_ALLOW_THREADS
8272 Py_XDECREF(woperation);
8273 if (rc <= (HINSTANCE)32) {
8274 PyObject *errval = win32_error_unicode("startfile",
8275 PyUnicode_AS_UNICODE(unipath));
8276 return errval;
8278 Py_INCREF(Py_None);
8279 return Py_None;
8281 #endif
8283 normal:
8284 if (!PyArg_ParseTuple(args, "et|s:startfile",
8285 Py_FileSystemDefaultEncoding, &filepath,
8286 &operation))
8287 return NULL;
8288 Py_BEGIN_ALLOW_THREADS
8289 rc = ShellExecute((HWND)0, operation, filepath,
8290 NULL, NULL, SW_SHOWNORMAL);
8291 Py_END_ALLOW_THREADS
8292 if (rc <= (HINSTANCE)32) {
8293 PyObject *errval = win32_error("startfile", filepath);
8294 PyMem_Free(filepath);
8295 return errval;
8297 PyMem_Free(filepath);
8298 Py_INCREF(Py_None);
8299 return Py_None;
8301 #endif
8303 #ifdef HAVE_GETLOADAVG
8304 PyDoc_STRVAR(posix_getloadavg__doc__,
8305 "getloadavg() -> (float, float, float)\n\n\
8306 Return the number of processes in the system run queue averaged over\n\
8307 the last 1, 5, and 15 minutes or raises OSError if the load average\n\
8308 was unobtainable");
8310 static PyObject *
8311 posix_getloadavg(PyObject *self, PyObject *noargs)
8313 double loadavg[3];
8314 if (getloadavg(loadavg, 3)!=3) {
8315 PyErr_SetString(PyExc_OSError, "Load averages are unobtainable");
8316 return NULL;
8317 } else
8318 return Py_BuildValue("ddd", loadavg[0], loadavg[1], loadavg[2]);
8320 #endif
8322 #ifdef MS_WINDOWS
8324 PyDoc_STRVAR(win32_urandom__doc__,
8325 "urandom(n) -> str\n\n\
8326 Return a string of n random bytes suitable for cryptographic use.");
8328 typedef BOOL (WINAPI *CRYPTACQUIRECONTEXTA)(HCRYPTPROV *phProv,\
8329 LPCSTR pszContainer, LPCSTR pszProvider, DWORD dwProvType,\
8330 DWORD dwFlags );
8331 typedef BOOL (WINAPI *CRYPTGENRANDOM)(HCRYPTPROV hProv, DWORD dwLen,\
8332 BYTE *pbBuffer );
8334 static CRYPTGENRANDOM pCryptGenRandom = NULL;
8335 /* This handle is never explicitly released. Instead, the operating
8336 system will release it when the process terminates. */
8337 static HCRYPTPROV hCryptProv = 0;
8339 static PyObject*
8340 win32_urandom(PyObject *self, PyObject *args)
8342 int howMany;
8343 PyObject* result;
8345 /* Read arguments */
8346 if (! PyArg_ParseTuple(args, "i:urandom", &howMany))
8347 return NULL;
8348 if (howMany < 0)
8349 return PyErr_Format(PyExc_ValueError,
8350 "negative argument not allowed");
8352 if (hCryptProv == 0) {
8353 HINSTANCE hAdvAPI32 = NULL;
8354 CRYPTACQUIRECONTEXTA pCryptAcquireContext = NULL;
8356 /* Obtain handle to the DLL containing CryptoAPI
8357 This should not fail */
8358 hAdvAPI32 = GetModuleHandle("advapi32.dll");
8359 if(hAdvAPI32 == NULL)
8360 return win32_error("GetModuleHandle", NULL);
8362 /* Obtain pointers to the CryptoAPI functions
8363 This will fail on some early versions of Win95 */
8364 pCryptAcquireContext = (CRYPTACQUIRECONTEXTA)GetProcAddress(
8365 hAdvAPI32,
8366 "CryptAcquireContextA");
8367 if (pCryptAcquireContext == NULL)
8368 return PyErr_Format(PyExc_NotImplementedError,
8369 "CryptAcquireContextA not found");
8371 pCryptGenRandom = (CRYPTGENRANDOM)GetProcAddress(
8372 hAdvAPI32, "CryptGenRandom");
8373 if (pCryptGenRandom == NULL)
8374 return PyErr_Format(PyExc_NotImplementedError,
8375 "CryptGenRandom not found");
8377 /* Acquire context */
8378 if (! pCryptAcquireContext(&hCryptProv, NULL, NULL,
8379 PROV_RSA_FULL, CRYPT_VERIFYCONTEXT))
8380 return win32_error("CryptAcquireContext", NULL);
8383 /* Allocate bytes */
8384 result = PyString_FromStringAndSize(NULL, howMany);
8385 if (result != NULL) {
8386 /* Get random data */
8387 memset(PyString_AS_STRING(result), 0, howMany); /* zero seed */
8388 if (! pCryptGenRandom(hCryptProv, howMany, (unsigned char*)
8389 PyString_AS_STRING(result))) {
8390 Py_DECREF(result);
8391 return win32_error("CryptGenRandom", NULL);
8394 return result;
8396 #endif
8398 #ifdef __VMS
8399 /* Use openssl random routine */
8400 #include <openssl/rand.h>
8401 PyDoc_STRVAR(vms_urandom__doc__,
8402 "urandom(n) -> str\n\n\
8403 Return a string of n random bytes suitable for cryptographic use.");
8405 static PyObject*
8406 vms_urandom(PyObject *self, PyObject *args)
8408 int howMany;
8409 PyObject* result;
8411 /* Read arguments */
8412 if (! PyArg_ParseTuple(args, "i:urandom", &howMany))
8413 return NULL;
8414 if (howMany < 0)
8415 return PyErr_Format(PyExc_ValueError,
8416 "negative argument not allowed");
8418 /* Allocate bytes */
8419 result = PyString_FromStringAndSize(NULL, howMany);
8420 if (result != NULL) {
8421 /* Get random data */
8422 if (RAND_pseudo_bytes((unsigned char*)
8423 PyString_AS_STRING(result),
8424 howMany) < 0) {
8425 Py_DECREF(result);
8426 return PyErr_Format(PyExc_ValueError,
8427 "RAND_pseudo_bytes");
8430 return result;
8432 #endif
8434 static PyMethodDef posix_methods[] = {
8435 {"access", posix_access, METH_VARARGS, posix_access__doc__},
8436 #ifdef HAVE_TTYNAME
8437 {"ttyname", posix_ttyname, METH_VARARGS, posix_ttyname__doc__},
8438 #endif
8439 {"chdir", posix_chdir, METH_VARARGS, posix_chdir__doc__},
8440 #ifdef HAVE_CHFLAGS
8441 {"chflags", posix_chflags, METH_VARARGS, posix_chflags__doc__},
8442 #endif /* HAVE_CHFLAGS */
8443 {"chmod", posix_chmod, METH_VARARGS, posix_chmod__doc__},
8444 #ifdef HAVE_FCHMOD
8445 {"fchmod", posix_fchmod, METH_VARARGS, posix_fchmod__doc__},
8446 #endif /* HAVE_FCHMOD */
8447 #ifdef HAVE_CHOWN
8448 {"chown", posix_chown, METH_VARARGS, posix_chown__doc__},
8449 #endif /* HAVE_CHOWN */
8450 #ifdef HAVE_LCHMOD
8451 {"lchmod", posix_lchmod, METH_VARARGS, posix_lchmod__doc__},
8452 #endif /* HAVE_LCHMOD */
8453 #ifdef HAVE_FCHOWN
8454 {"fchown", posix_fchown, METH_VARARGS, posix_fchown__doc__},
8455 #endif /* HAVE_FCHOWN */
8456 #ifdef HAVE_LCHFLAGS
8457 {"lchflags", posix_lchflags, METH_VARARGS, posix_lchflags__doc__},
8458 #endif /* HAVE_LCHFLAGS */
8459 #ifdef HAVE_LCHOWN
8460 {"lchown", posix_lchown, METH_VARARGS, posix_lchown__doc__},
8461 #endif /* HAVE_LCHOWN */
8462 #ifdef HAVE_CHROOT
8463 {"chroot", posix_chroot, METH_VARARGS, posix_chroot__doc__},
8464 #endif
8465 #ifdef HAVE_CTERMID
8466 {"ctermid", posix_ctermid, METH_NOARGS, posix_ctermid__doc__},
8467 #endif
8468 #ifdef HAVE_GETCWD
8469 {"getcwd", posix_getcwd, METH_NOARGS, posix_getcwd__doc__},
8470 #ifdef Py_USING_UNICODE
8471 {"getcwdu", posix_getcwdu, METH_NOARGS, posix_getcwdu__doc__},
8472 #endif
8473 #endif
8474 #ifdef HAVE_LINK
8475 {"link", posix_link, METH_VARARGS, posix_link__doc__},
8476 #endif /* HAVE_LINK */
8477 {"listdir", posix_listdir, METH_VARARGS, posix_listdir__doc__},
8478 {"lstat", posix_lstat, METH_VARARGS, posix_lstat__doc__},
8479 {"mkdir", posix_mkdir, METH_VARARGS, posix_mkdir__doc__},
8480 #ifdef HAVE_NICE
8481 {"nice", posix_nice, METH_VARARGS, posix_nice__doc__},
8482 #endif /* HAVE_NICE */
8483 #ifdef HAVE_READLINK
8484 {"readlink", posix_readlink, METH_VARARGS, posix_readlink__doc__},
8485 #endif /* HAVE_READLINK */
8486 {"rename", posix_rename, METH_VARARGS, posix_rename__doc__},
8487 {"rmdir", posix_rmdir, METH_VARARGS, posix_rmdir__doc__},
8488 {"stat", posix_stat, METH_VARARGS, posix_stat__doc__},
8489 {"stat_float_times", stat_float_times, METH_VARARGS, stat_float_times__doc__},
8490 #ifdef HAVE_SYMLINK
8491 {"symlink", posix_symlink, METH_VARARGS, posix_symlink__doc__},
8492 #endif /* HAVE_SYMLINK */
8493 #ifdef HAVE_SYSTEM
8494 {"system", posix_system, METH_VARARGS, posix_system__doc__},
8495 #endif
8496 {"umask", posix_umask, METH_VARARGS, posix_umask__doc__},
8497 #ifdef HAVE_UNAME
8498 {"uname", posix_uname, METH_NOARGS, posix_uname__doc__},
8499 #endif /* HAVE_UNAME */
8500 {"unlink", posix_unlink, METH_VARARGS, posix_unlink__doc__},
8501 {"remove", posix_unlink, METH_VARARGS, posix_remove__doc__},
8502 {"utime", posix_utime, METH_VARARGS, posix_utime__doc__},
8503 #ifdef HAVE_TIMES
8504 {"times", posix_times, METH_NOARGS, posix_times__doc__},
8505 #endif /* HAVE_TIMES */
8506 {"_exit", posix__exit, METH_VARARGS, posix__exit__doc__},
8507 #ifdef HAVE_EXECV
8508 {"execv", posix_execv, METH_VARARGS, posix_execv__doc__},
8509 {"execve", posix_execve, METH_VARARGS, posix_execve__doc__},
8510 #endif /* HAVE_EXECV */
8511 #ifdef HAVE_SPAWNV
8512 {"spawnv", posix_spawnv, METH_VARARGS, posix_spawnv__doc__},
8513 {"spawnve", posix_spawnve, METH_VARARGS, posix_spawnve__doc__},
8514 #if defined(PYOS_OS2)
8515 {"spawnvp", posix_spawnvp, METH_VARARGS, posix_spawnvp__doc__},
8516 {"spawnvpe", posix_spawnvpe, METH_VARARGS, posix_spawnvpe__doc__},
8517 #endif /* PYOS_OS2 */
8518 #endif /* HAVE_SPAWNV */
8519 #ifdef HAVE_FORK1
8520 {"fork1", posix_fork1, METH_NOARGS, posix_fork1__doc__},
8521 #endif /* HAVE_FORK1 */
8522 #ifdef HAVE_FORK
8523 {"fork", posix_fork, METH_NOARGS, posix_fork__doc__},
8524 #endif /* HAVE_FORK */
8525 #if defined(HAVE_OPENPTY) || defined(HAVE__GETPTY) || defined(HAVE_DEV_PTMX)
8526 {"openpty", posix_openpty, METH_NOARGS, posix_openpty__doc__},
8527 #endif /* HAVE_OPENPTY || HAVE__GETPTY || HAVE_DEV_PTMX */
8528 #ifdef HAVE_FORKPTY
8529 {"forkpty", posix_forkpty, METH_NOARGS, posix_forkpty__doc__},
8530 #endif /* HAVE_FORKPTY */
8531 #ifdef HAVE_GETEGID
8532 {"getegid", posix_getegid, METH_NOARGS, posix_getegid__doc__},
8533 #endif /* HAVE_GETEGID */
8534 #ifdef HAVE_GETEUID
8535 {"geteuid", posix_geteuid, METH_NOARGS, posix_geteuid__doc__},
8536 #endif /* HAVE_GETEUID */
8537 #ifdef HAVE_GETGID
8538 {"getgid", posix_getgid, METH_NOARGS, posix_getgid__doc__},
8539 #endif /* HAVE_GETGID */
8540 #ifdef HAVE_GETGROUPS
8541 {"getgroups", posix_getgroups, METH_NOARGS, posix_getgroups__doc__},
8542 #endif
8543 {"getpid", posix_getpid, METH_NOARGS, posix_getpid__doc__},
8544 #ifdef HAVE_GETPGRP
8545 {"getpgrp", posix_getpgrp, METH_NOARGS, posix_getpgrp__doc__},
8546 #endif /* HAVE_GETPGRP */
8547 #ifdef HAVE_GETPPID
8548 {"getppid", posix_getppid, METH_NOARGS, posix_getppid__doc__},
8549 #endif /* HAVE_GETPPID */
8550 #ifdef HAVE_GETUID
8551 {"getuid", posix_getuid, METH_NOARGS, posix_getuid__doc__},
8552 #endif /* HAVE_GETUID */
8553 #ifdef HAVE_GETLOGIN
8554 {"getlogin", posix_getlogin, METH_NOARGS, posix_getlogin__doc__},
8555 #endif
8556 #ifdef HAVE_KILL
8557 {"kill", posix_kill, METH_VARARGS, posix_kill__doc__},
8558 #endif /* HAVE_KILL */
8559 #ifdef HAVE_KILLPG
8560 {"killpg", posix_killpg, METH_VARARGS, posix_killpg__doc__},
8561 #endif /* HAVE_KILLPG */
8562 #ifdef HAVE_PLOCK
8563 {"plock", posix_plock, METH_VARARGS, posix_plock__doc__},
8564 #endif /* HAVE_PLOCK */
8565 #ifdef HAVE_POPEN
8566 {"popen", posix_popen, METH_VARARGS, posix_popen__doc__},
8567 #ifdef MS_WINDOWS
8568 {"popen2", win32_popen2, METH_VARARGS},
8569 {"popen3", win32_popen3, METH_VARARGS},
8570 {"popen4", win32_popen4, METH_VARARGS},
8571 {"startfile", win32_startfile, METH_VARARGS, win32_startfile__doc__},
8572 #else
8573 #if defined(PYOS_OS2) && defined(PYCC_GCC)
8574 {"popen2", os2emx_popen2, METH_VARARGS},
8575 {"popen3", os2emx_popen3, METH_VARARGS},
8576 {"popen4", os2emx_popen4, METH_VARARGS},
8577 #endif
8578 #endif
8579 #endif /* HAVE_POPEN */
8580 #ifdef HAVE_SETUID
8581 {"setuid", posix_setuid, METH_VARARGS, posix_setuid__doc__},
8582 #endif /* HAVE_SETUID */
8583 #ifdef HAVE_SETEUID
8584 {"seteuid", posix_seteuid, METH_VARARGS, posix_seteuid__doc__},
8585 #endif /* HAVE_SETEUID */
8586 #ifdef HAVE_SETEGID
8587 {"setegid", posix_setegid, METH_VARARGS, posix_setegid__doc__},
8588 #endif /* HAVE_SETEGID */
8589 #ifdef HAVE_SETREUID
8590 {"setreuid", posix_setreuid, METH_VARARGS, posix_setreuid__doc__},
8591 #endif /* HAVE_SETREUID */
8592 #ifdef HAVE_SETREGID
8593 {"setregid", posix_setregid, METH_VARARGS, posix_setregid__doc__},
8594 #endif /* HAVE_SETREGID */
8595 #ifdef HAVE_SETGID
8596 {"setgid", posix_setgid, METH_VARARGS, posix_setgid__doc__},
8597 #endif /* HAVE_SETGID */
8598 #ifdef HAVE_SETGROUPS
8599 {"setgroups", posix_setgroups, METH_O, posix_setgroups__doc__},
8600 #endif /* HAVE_SETGROUPS */
8601 #ifdef HAVE_GETPGID
8602 {"getpgid", posix_getpgid, METH_VARARGS, posix_getpgid__doc__},
8603 #endif /* HAVE_GETPGID */
8604 #ifdef HAVE_SETPGRP
8605 {"setpgrp", posix_setpgrp, METH_NOARGS, posix_setpgrp__doc__},
8606 #endif /* HAVE_SETPGRP */
8607 #ifdef HAVE_WAIT
8608 {"wait", posix_wait, METH_NOARGS, posix_wait__doc__},
8609 #endif /* HAVE_WAIT */
8610 #ifdef HAVE_WAIT3
8611 {"wait3", posix_wait3, METH_VARARGS, posix_wait3__doc__},
8612 #endif /* HAVE_WAIT3 */
8613 #ifdef HAVE_WAIT4
8614 {"wait4", posix_wait4, METH_VARARGS, posix_wait4__doc__},
8615 #endif /* HAVE_WAIT4 */
8616 #if defined(HAVE_WAITPID) || defined(HAVE_CWAIT)
8617 {"waitpid", posix_waitpid, METH_VARARGS, posix_waitpid__doc__},
8618 #endif /* HAVE_WAITPID */
8619 #ifdef HAVE_GETSID
8620 {"getsid", posix_getsid, METH_VARARGS, posix_getsid__doc__},
8621 #endif /* HAVE_GETSID */
8622 #ifdef HAVE_SETSID
8623 {"setsid", posix_setsid, METH_NOARGS, posix_setsid__doc__},
8624 #endif /* HAVE_SETSID */
8625 #ifdef HAVE_SETPGID
8626 {"setpgid", posix_setpgid, METH_VARARGS, posix_setpgid__doc__},
8627 #endif /* HAVE_SETPGID */
8628 #ifdef HAVE_TCGETPGRP
8629 {"tcgetpgrp", posix_tcgetpgrp, METH_VARARGS, posix_tcgetpgrp__doc__},
8630 #endif /* HAVE_TCGETPGRP */
8631 #ifdef HAVE_TCSETPGRP
8632 {"tcsetpgrp", posix_tcsetpgrp, METH_VARARGS, posix_tcsetpgrp__doc__},
8633 #endif /* HAVE_TCSETPGRP */
8634 {"open", posix_open, METH_VARARGS, posix_open__doc__},
8635 {"close", posix_close, METH_VARARGS, posix_close__doc__},
8636 {"closerange", posix_closerange, METH_VARARGS, posix_closerange__doc__},
8637 {"dup", posix_dup, METH_VARARGS, posix_dup__doc__},
8638 {"dup2", posix_dup2, METH_VARARGS, posix_dup2__doc__},
8639 {"lseek", posix_lseek, METH_VARARGS, posix_lseek__doc__},
8640 {"read", posix_read, METH_VARARGS, posix_read__doc__},
8641 {"write", posix_write, METH_VARARGS, posix_write__doc__},
8642 {"fstat", posix_fstat, METH_VARARGS, posix_fstat__doc__},
8643 {"fdopen", posix_fdopen, METH_VARARGS, posix_fdopen__doc__},
8644 {"isatty", posix_isatty, METH_VARARGS, posix_isatty__doc__},
8645 #ifdef HAVE_PIPE
8646 {"pipe", posix_pipe, METH_NOARGS, posix_pipe__doc__},
8647 #endif
8648 #ifdef HAVE_MKFIFO
8649 {"mkfifo", posix_mkfifo, METH_VARARGS, posix_mkfifo__doc__},
8650 #endif
8651 #if defined(HAVE_MKNOD) && defined(HAVE_MAKEDEV)
8652 {"mknod", posix_mknod, METH_VARARGS, posix_mknod__doc__},
8653 #endif
8654 #ifdef HAVE_DEVICE_MACROS
8655 {"major", posix_major, METH_VARARGS, posix_major__doc__},
8656 {"minor", posix_minor, METH_VARARGS, posix_minor__doc__},
8657 {"makedev", posix_makedev, METH_VARARGS, posix_makedev__doc__},
8658 #endif
8659 #ifdef HAVE_FTRUNCATE
8660 {"ftruncate", posix_ftruncate, METH_VARARGS, posix_ftruncate__doc__},
8661 #endif
8662 #ifdef HAVE_PUTENV
8663 {"putenv", posix_putenv, METH_VARARGS, posix_putenv__doc__},
8664 #endif
8665 #ifdef HAVE_UNSETENV
8666 {"unsetenv", posix_unsetenv, METH_VARARGS, posix_unsetenv__doc__},
8667 #endif
8668 {"strerror", posix_strerror, METH_VARARGS, posix_strerror__doc__},
8669 #ifdef HAVE_FCHDIR
8670 {"fchdir", posix_fchdir, METH_O, posix_fchdir__doc__},
8671 #endif
8672 #ifdef HAVE_FSYNC
8673 {"fsync", posix_fsync, METH_O, posix_fsync__doc__},
8674 #endif
8675 #ifdef HAVE_FDATASYNC
8676 {"fdatasync", posix_fdatasync, METH_O, posix_fdatasync__doc__},
8677 #endif
8678 #ifdef HAVE_SYS_WAIT_H
8679 #ifdef WCOREDUMP
8680 {"WCOREDUMP", posix_WCOREDUMP, METH_VARARGS, posix_WCOREDUMP__doc__},
8681 #endif /* WCOREDUMP */
8682 #ifdef WIFCONTINUED
8683 {"WIFCONTINUED",posix_WIFCONTINUED, METH_VARARGS, posix_WIFCONTINUED__doc__},
8684 #endif /* WIFCONTINUED */
8685 #ifdef WIFSTOPPED
8686 {"WIFSTOPPED", posix_WIFSTOPPED, METH_VARARGS, posix_WIFSTOPPED__doc__},
8687 #endif /* WIFSTOPPED */
8688 #ifdef WIFSIGNALED
8689 {"WIFSIGNALED", posix_WIFSIGNALED, METH_VARARGS, posix_WIFSIGNALED__doc__},
8690 #endif /* WIFSIGNALED */
8691 #ifdef WIFEXITED
8692 {"WIFEXITED", posix_WIFEXITED, METH_VARARGS, posix_WIFEXITED__doc__},
8693 #endif /* WIFEXITED */
8694 #ifdef WEXITSTATUS
8695 {"WEXITSTATUS", posix_WEXITSTATUS, METH_VARARGS, posix_WEXITSTATUS__doc__},
8696 #endif /* WEXITSTATUS */
8697 #ifdef WTERMSIG
8698 {"WTERMSIG", posix_WTERMSIG, METH_VARARGS, posix_WTERMSIG__doc__},
8699 #endif /* WTERMSIG */
8700 #ifdef WSTOPSIG
8701 {"WSTOPSIG", posix_WSTOPSIG, METH_VARARGS, posix_WSTOPSIG__doc__},
8702 #endif /* WSTOPSIG */
8703 #endif /* HAVE_SYS_WAIT_H */
8704 #if defined(HAVE_FSTATVFS) && defined(HAVE_SYS_STATVFS_H)
8705 {"fstatvfs", posix_fstatvfs, METH_VARARGS, posix_fstatvfs__doc__},
8706 #endif
8707 #if defined(HAVE_STATVFS) && defined(HAVE_SYS_STATVFS_H)
8708 {"statvfs", posix_statvfs, METH_VARARGS, posix_statvfs__doc__},
8709 #endif
8710 #ifdef HAVE_TMPFILE
8711 {"tmpfile", posix_tmpfile, METH_NOARGS, posix_tmpfile__doc__},
8712 #endif
8713 #ifdef HAVE_TEMPNAM
8714 {"tempnam", posix_tempnam, METH_VARARGS, posix_tempnam__doc__},
8715 #endif
8716 #ifdef HAVE_TMPNAM
8717 {"tmpnam", posix_tmpnam, METH_NOARGS, posix_tmpnam__doc__},
8718 #endif
8719 #ifdef HAVE_CONFSTR
8720 {"confstr", posix_confstr, METH_VARARGS, posix_confstr__doc__},
8721 #endif
8722 #ifdef HAVE_SYSCONF
8723 {"sysconf", posix_sysconf, METH_VARARGS, posix_sysconf__doc__},
8724 #endif
8725 #ifdef HAVE_FPATHCONF
8726 {"fpathconf", posix_fpathconf, METH_VARARGS, posix_fpathconf__doc__},
8727 #endif
8728 #ifdef HAVE_PATHCONF
8729 {"pathconf", posix_pathconf, METH_VARARGS, posix_pathconf__doc__},
8730 #endif
8731 {"abort", posix_abort, METH_NOARGS, posix_abort__doc__},
8732 #ifdef MS_WINDOWS
8733 {"_getfullpathname", posix__getfullpathname, METH_VARARGS, NULL},
8734 #endif
8735 #ifdef HAVE_GETLOADAVG
8736 {"getloadavg", posix_getloadavg, METH_NOARGS, posix_getloadavg__doc__},
8737 #endif
8738 #ifdef MS_WINDOWS
8739 {"urandom", win32_urandom, METH_VARARGS, win32_urandom__doc__},
8740 #endif
8741 #ifdef __VMS
8742 {"urandom", vms_urandom, METH_VARARGS, vms_urandom__doc__},
8743 #endif
8744 {NULL, NULL} /* Sentinel */
8748 static int
8749 ins(PyObject *module, char *symbol, long value)
8751 return PyModule_AddIntConstant(module, symbol, value);
8754 #if defined(PYOS_OS2)
8755 /* Insert Platform-Specific Constant Values (Strings & Numbers) of Common Use */
8756 static int insertvalues(PyObject *module)
8758 APIRET rc;
8759 ULONG values[QSV_MAX+1];
8760 PyObject *v;
8761 char *ver, tmp[50];
8763 Py_BEGIN_ALLOW_THREADS
8764 rc = DosQuerySysInfo(1L, QSV_MAX, &values[1], sizeof(ULONG) * QSV_MAX);
8765 Py_END_ALLOW_THREADS
8767 if (rc != NO_ERROR) {
8768 os2_error(rc);
8769 return -1;
8772 if (ins(module, "meminstalled", values[QSV_TOTPHYSMEM])) return -1;
8773 if (ins(module, "memkernel", values[QSV_TOTRESMEM])) return -1;
8774 if (ins(module, "memvirtual", values[QSV_TOTAVAILMEM])) return -1;
8775 if (ins(module, "maxpathlen", values[QSV_MAX_PATH_LENGTH])) return -1;
8776 if (ins(module, "maxnamelen", values[QSV_MAX_COMP_LENGTH])) return -1;
8777 if (ins(module, "revision", values[QSV_VERSION_REVISION])) return -1;
8778 if (ins(module, "timeslice", values[QSV_MIN_SLICE])) return -1;
8780 switch (values[QSV_VERSION_MINOR]) {
8781 case 0: ver = "2.00"; break;
8782 case 10: ver = "2.10"; break;
8783 case 11: ver = "2.11"; break;
8784 case 30: ver = "3.00"; break;
8785 case 40: ver = "4.00"; break;
8786 case 50: ver = "5.00"; break;
8787 default:
8788 PyOS_snprintf(tmp, sizeof(tmp),
8789 "%d-%d", values[QSV_VERSION_MAJOR],
8790 values[QSV_VERSION_MINOR]);
8791 ver = &tmp[0];
8794 /* Add Indicator of the Version of the Operating System */
8795 if (PyModule_AddStringConstant(module, "version", tmp) < 0)
8796 return -1;
8798 /* Add Indicator of Which Drive was Used to Boot the System */
8799 tmp[0] = 'A' + values[QSV_BOOT_DRIVE] - 1;
8800 tmp[1] = ':';
8801 tmp[2] = '\0';
8803 return PyModule_AddStringConstant(module, "bootdrive", tmp);
8805 #endif
8807 static int
8808 all_ins(PyObject *d)
8810 #ifdef F_OK
8811 if (ins(d, "F_OK", (long)F_OK)) return -1;
8812 #endif
8813 #ifdef R_OK
8814 if (ins(d, "R_OK", (long)R_OK)) return -1;
8815 #endif
8816 #ifdef W_OK
8817 if (ins(d, "W_OK", (long)W_OK)) return -1;
8818 #endif
8819 #ifdef X_OK
8820 if (ins(d, "X_OK", (long)X_OK)) return -1;
8821 #endif
8822 #ifdef NGROUPS_MAX
8823 if (ins(d, "NGROUPS_MAX", (long)NGROUPS_MAX)) return -1;
8824 #endif
8825 #ifdef TMP_MAX
8826 if (ins(d, "TMP_MAX", (long)TMP_MAX)) return -1;
8827 #endif
8828 #ifdef WCONTINUED
8829 if (ins(d, "WCONTINUED", (long)WCONTINUED)) return -1;
8830 #endif
8831 #ifdef WNOHANG
8832 if (ins(d, "WNOHANG", (long)WNOHANG)) return -1;
8833 #endif
8834 #ifdef WUNTRACED
8835 if (ins(d, "WUNTRACED", (long)WUNTRACED)) return -1;
8836 #endif
8837 #ifdef O_RDONLY
8838 if (ins(d, "O_RDONLY", (long)O_RDONLY)) return -1;
8839 #endif
8840 #ifdef O_WRONLY
8841 if (ins(d, "O_WRONLY", (long)O_WRONLY)) return -1;
8842 #endif
8843 #ifdef O_RDWR
8844 if (ins(d, "O_RDWR", (long)O_RDWR)) return -1;
8845 #endif
8846 #ifdef O_NDELAY
8847 if (ins(d, "O_NDELAY", (long)O_NDELAY)) return -1;
8848 #endif
8849 #ifdef O_NONBLOCK
8850 if (ins(d, "O_NONBLOCK", (long)O_NONBLOCK)) return -1;
8851 #endif
8852 #ifdef O_APPEND
8853 if (ins(d, "O_APPEND", (long)O_APPEND)) return -1;
8854 #endif
8855 #ifdef O_DSYNC
8856 if (ins(d, "O_DSYNC", (long)O_DSYNC)) return -1;
8857 #endif
8858 #ifdef O_RSYNC
8859 if (ins(d, "O_RSYNC", (long)O_RSYNC)) return -1;
8860 #endif
8861 #ifdef O_SYNC
8862 if (ins(d, "O_SYNC", (long)O_SYNC)) return -1;
8863 #endif
8864 #ifdef O_NOCTTY
8865 if (ins(d, "O_NOCTTY", (long)O_NOCTTY)) return -1;
8866 #endif
8867 #ifdef O_CREAT
8868 if (ins(d, "O_CREAT", (long)O_CREAT)) return -1;
8869 #endif
8870 #ifdef O_EXCL
8871 if (ins(d, "O_EXCL", (long)O_EXCL)) return -1;
8872 #endif
8873 #ifdef O_TRUNC
8874 if (ins(d, "O_TRUNC", (long)O_TRUNC)) return -1;
8875 #endif
8876 #ifdef O_BINARY
8877 if (ins(d, "O_BINARY", (long)O_BINARY)) return -1;
8878 #endif
8879 #ifdef O_TEXT
8880 if (ins(d, "O_TEXT", (long)O_TEXT)) return -1;
8881 #endif
8882 #ifdef O_LARGEFILE
8883 if (ins(d, "O_LARGEFILE", (long)O_LARGEFILE)) return -1;
8884 #endif
8885 #ifdef O_SHLOCK
8886 if (ins(d, "O_SHLOCK", (long)O_SHLOCK)) return -1;
8887 #endif
8888 #ifdef O_EXLOCK
8889 if (ins(d, "O_EXLOCK", (long)O_EXLOCK)) return -1;
8890 #endif
8892 /* MS Windows */
8893 #ifdef O_NOINHERIT
8894 /* Don't inherit in child processes. */
8895 if (ins(d, "O_NOINHERIT", (long)O_NOINHERIT)) return -1;
8896 #endif
8897 #ifdef _O_SHORT_LIVED
8898 /* Optimize for short life (keep in memory). */
8899 /* MS forgot to define this one with a non-underscore form too. */
8900 if (ins(d, "O_SHORT_LIVED", (long)_O_SHORT_LIVED)) return -1;
8901 #endif
8902 #ifdef O_TEMPORARY
8903 /* Automatically delete when last handle is closed. */
8904 if (ins(d, "O_TEMPORARY", (long)O_TEMPORARY)) return -1;
8905 #endif
8906 #ifdef O_RANDOM
8907 /* Optimize for random access. */
8908 if (ins(d, "O_RANDOM", (long)O_RANDOM)) return -1;
8909 #endif
8910 #ifdef O_SEQUENTIAL
8911 /* Optimize for sequential access. */
8912 if (ins(d, "O_SEQUENTIAL", (long)O_SEQUENTIAL)) return -1;
8913 #endif
8915 /* GNU extensions. */
8916 #ifdef O_ASYNC
8917 /* Send a SIGIO signal whenever input or output
8918 becomes available on file descriptor */
8919 if (ins(d, "O_ASYNC", (long)O_ASYNC)) return -1;
8920 #endif
8921 #ifdef O_DIRECT
8922 /* Direct disk access. */
8923 if (ins(d, "O_DIRECT", (long)O_DIRECT)) return -1;
8924 #endif
8925 #ifdef O_DIRECTORY
8926 /* Must be a directory. */
8927 if (ins(d, "O_DIRECTORY", (long)O_DIRECTORY)) return -1;
8928 #endif
8929 #ifdef O_NOFOLLOW
8930 /* Do not follow links. */
8931 if (ins(d, "O_NOFOLLOW", (long)O_NOFOLLOW)) return -1;
8932 #endif
8933 #ifdef O_NOATIME
8934 /* Do not update the access time. */
8935 if (ins(d, "O_NOATIME", (long)O_NOATIME)) return -1;
8936 #endif
8938 /* These come from sysexits.h */
8939 #ifdef EX_OK
8940 if (ins(d, "EX_OK", (long)EX_OK)) return -1;
8941 #endif /* EX_OK */
8942 #ifdef EX_USAGE
8943 if (ins(d, "EX_USAGE", (long)EX_USAGE)) return -1;
8944 #endif /* EX_USAGE */
8945 #ifdef EX_DATAERR
8946 if (ins(d, "EX_DATAERR", (long)EX_DATAERR)) return -1;
8947 #endif /* EX_DATAERR */
8948 #ifdef EX_NOINPUT
8949 if (ins(d, "EX_NOINPUT", (long)EX_NOINPUT)) return -1;
8950 #endif /* EX_NOINPUT */
8951 #ifdef EX_NOUSER
8952 if (ins(d, "EX_NOUSER", (long)EX_NOUSER)) return -1;
8953 #endif /* EX_NOUSER */
8954 #ifdef EX_NOHOST
8955 if (ins(d, "EX_NOHOST", (long)EX_NOHOST)) return -1;
8956 #endif /* EX_NOHOST */
8957 #ifdef EX_UNAVAILABLE
8958 if (ins(d, "EX_UNAVAILABLE", (long)EX_UNAVAILABLE)) return -1;
8959 #endif /* EX_UNAVAILABLE */
8960 #ifdef EX_SOFTWARE
8961 if (ins(d, "EX_SOFTWARE", (long)EX_SOFTWARE)) return -1;
8962 #endif /* EX_SOFTWARE */
8963 #ifdef EX_OSERR
8964 if (ins(d, "EX_OSERR", (long)EX_OSERR)) return -1;
8965 #endif /* EX_OSERR */
8966 #ifdef EX_OSFILE
8967 if (ins(d, "EX_OSFILE", (long)EX_OSFILE)) return -1;
8968 #endif /* EX_OSFILE */
8969 #ifdef EX_CANTCREAT
8970 if (ins(d, "EX_CANTCREAT", (long)EX_CANTCREAT)) return -1;
8971 #endif /* EX_CANTCREAT */
8972 #ifdef EX_IOERR
8973 if (ins(d, "EX_IOERR", (long)EX_IOERR)) return -1;
8974 #endif /* EX_IOERR */
8975 #ifdef EX_TEMPFAIL
8976 if (ins(d, "EX_TEMPFAIL", (long)EX_TEMPFAIL)) return -1;
8977 #endif /* EX_TEMPFAIL */
8978 #ifdef EX_PROTOCOL
8979 if (ins(d, "EX_PROTOCOL", (long)EX_PROTOCOL)) return -1;
8980 #endif /* EX_PROTOCOL */
8981 #ifdef EX_NOPERM
8982 if (ins(d, "EX_NOPERM", (long)EX_NOPERM)) return -1;
8983 #endif /* EX_NOPERM */
8984 #ifdef EX_CONFIG
8985 if (ins(d, "EX_CONFIG", (long)EX_CONFIG)) return -1;
8986 #endif /* EX_CONFIG */
8987 #ifdef EX_NOTFOUND
8988 if (ins(d, "EX_NOTFOUND", (long)EX_NOTFOUND)) return -1;
8989 #endif /* EX_NOTFOUND */
8991 #ifdef HAVE_SPAWNV
8992 #if defined(PYOS_OS2) && defined(PYCC_GCC)
8993 if (ins(d, "P_WAIT", (long)P_WAIT)) return -1;
8994 if (ins(d, "P_NOWAIT", (long)P_NOWAIT)) return -1;
8995 if (ins(d, "P_OVERLAY", (long)P_OVERLAY)) return -1;
8996 if (ins(d, "P_DEBUG", (long)P_DEBUG)) return -1;
8997 if (ins(d, "P_SESSION", (long)P_SESSION)) return -1;
8998 if (ins(d, "P_DETACH", (long)P_DETACH)) return -1;
8999 if (ins(d, "P_PM", (long)P_PM)) return -1;
9000 if (ins(d, "P_DEFAULT", (long)P_DEFAULT)) return -1;
9001 if (ins(d, "P_MINIMIZE", (long)P_MINIMIZE)) return -1;
9002 if (ins(d, "P_MAXIMIZE", (long)P_MAXIMIZE)) return -1;
9003 if (ins(d, "P_FULLSCREEN", (long)P_FULLSCREEN)) return -1;
9004 if (ins(d, "P_WINDOWED", (long)P_WINDOWED)) return -1;
9005 if (ins(d, "P_FOREGROUND", (long)P_FOREGROUND)) return -1;
9006 if (ins(d, "P_BACKGROUND", (long)P_BACKGROUND)) return -1;
9007 if (ins(d, "P_NOCLOSE", (long)P_NOCLOSE)) return -1;
9008 if (ins(d, "P_NOSESSION", (long)P_NOSESSION)) return -1;
9009 if (ins(d, "P_QUOTE", (long)P_QUOTE)) return -1;
9010 if (ins(d, "P_TILDE", (long)P_TILDE)) return -1;
9011 if (ins(d, "P_UNRELATED", (long)P_UNRELATED)) return -1;
9012 if (ins(d, "P_DEBUGDESC", (long)P_DEBUGDESC)) return -1;
9013 #else
9014 if (ins(d, "P_WAIT", (long)_P_WAIT)) return -1;
9015 if (ins(d, "P_NOWAIT", (long)_P_NOWAIT)) return -1;
9016 if (ins(d, "P_OVERLAY", (long)_OLD_P_OVERLAY)) return -1;
9017 if (ins(d, "P_NOWAITO", (long)_P_NOWAITO)) return -1;
9018 if (ins(d, "P_DETACH", (long)_P_DETACH)) return -1;
9019 #endif
9020 #endif
9022 #if defined(PYOS_OS2)
9023 if (insertvalues(d)) return -1;
9024 #endif
9025 return 0;
9029 #if (defined(_MSC_VER) || defined(__WATCOMC__) || defined(__BORLANDC__)) && !defined(__QNX__)
9030 #define INITFUNC initnt
9031 #define MODNAME "nt"
9033 #elif defined(PYOS_OS2)
9034 #define INITFUNC initos2
9035 #define MODNAME "os2"
9037 #else
9038 #define INITFUNC initposix
9039 #define MODNAME "posix"
9040 #endif
9042 PyMODINIT_FUNC
9043 INITFUNC(void)
9045 PyObject *m, *v;
9047 m = Py_InitModule3(MODNAME,
9048 posix_methods,
9049 posix__doc__);
9050 if (m == NULL)
9051 return;
9053 /* Initialize environ dictionary */
9054 v = convertenviron();
9055 Py_XINCREF(v);
9056 if (v == NULL || PyModule_AddObject(m, "environ", v) != 0)
9057 return;
9058 Py_DECREF(v);
9060 if (all_ins(m))
9061 return;
9063 if (setup_confname_tables(m))
9064 return;
9066 Py_INCREF(PyExc_OSError);
9067 PyModule_AddObject(m, "error", PyExc_OSError);
9069 #ifdef HAVE_PUTENV
9070 if (posix_putenv_garbage == NULL)
9071 posix_putenv_garbage = PyDict_New();
9072 #endif
9074 if (!initialized) {
9075 stat_result_desc.name = MODNAME ".stat_result";
9076 stat_result_desc.fields[7].name = PyStructSequence_UnnamedField;
9077 stat_result_desc.fields[8].name = PyStructSequence_UnnamedField;
9078 stat_result_desc.fields[9].name = PyStructSequence_UnnamedField;
9079 PyStructSequence_InitType(&StatResultType, &stat_result_desc);
9080 structseq_new = StatResultType.tp_new;
9081 StatResultType.tp_new = statresult_new;
9083 statvfs_result_desc.name = MODNAME ".statvfs_result";
9084 PyStructSequence_InitType(&StatVFSResultType, &statvfs_result_desc);
9085 #ifdef NEED_TICKS_PER_SECOND
9086 # if defined(HAVE_SYSCONF) && defined(_SC_CLK_TCK)
9087 ticks_per_second = sysconf(_SC_CLK_TCK);
9088 # elif defined(HZ)
9089 ticks_per_second = HZ;
9090 # else
9091 ticks_per_second = 60; /* magic fallback value; may be bogus */
9092 # endif
9093 #endif
9095 Py_INCREF((PyObject*) &StatResultType);
9096 PyModule_AddObject(m, "stat_result", (PyObject*) &StatResultType);
9097 Py_INCREF((PyObject*) &StatVFSResultType);
9098 PyModule_AddObject(m, "statvfs_result",
9099 (PyObject*) &StatVFSResultType);
9100 initialized = 1;
9102 #ifdef __APPLE__
9104 * Step 2 of weak-linking support on Mac OS X.
9106 * The code below removes functions that are not available on the
9107 * currently active platform.
9109 * This block allow one to use a python binary that was build on
9110 * OSX 10.4 on OSX 10.3, without loosing access to new APIs on
9111 * OSX 10.4.
9113 #ifdef HAVE_FSTATVFS
9114 if (fstatvfs == NULL) {
9115 if (PyObject_DelAttrString(m, "fstatvfs") == -1) {
9116 return;
9119 #endif /* HAVE_FSTATVFS */
9121 #ifdef HAVE_STATVFS
9122 if (statvfs == NULL) {
9123 if (PyObject_DelAttrString(m, "statvfs") == -1) {
9124 return;
9127 #endif /* HAVE_STATVFS */
9129 # ifdef HAVE_LCHOWN
9130 if (lchown == NULL) {
9131 if (PyObject_DelAttrString(m, "lchown") == -1) {
9132 return;
9135 #endif /* HAVE_LCHOWN */
9138 #endif /* __APPLE__ */
9142 #ifdef __cplusplus
9144 #endif