OS routines for Mac, NT, or Posix depending on what system we're
on.
Programs that import and use 'os' stand a better chance of being
portable between different platforms. Of course, they must then only use
functions that are defined by all platforms (e.g., unlink and opendir),
and leave all pathname manipulation to os.path (e.g., split and
join).
bool
|
WCOREDUMP(status)
Return True if the process returning 'status' was dumped to a core
file. |
|
|
integer
|
WEXITSTATUS(status)
Return the process return code from 'status'. |
|
|
bool
|
WIFCONTINUED(status)
Return True if the process returning 'status' was continued from a
job control stop. |
|
|
bool
|
WIFEXITED(status)
Return true if the process returning 'status' exited using the exit()
system call. |
|
|
bool
|
WIFSIGNALED(status)
Return True if the process returning 'status' was terminated by a
signal. |
|
|
bool
|
WIFSTOPPED(status)
Return True if the process returning 'status' was stopped. |
|
|
integer
|
WSTOPSIG(status)
Return the signal that stopped the process that provided the 'status'
value. |
|
|
integer
|
WTERMSIG(status)
Return the signal that terminated the process that provided the
'status' value. |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
does not return!
|
abort()
Abort the interpreter immediately. |
|
|
True if granted, False otherwise
|
access(path,
mode)
Use the real uid/gid to test for access to a path. |
|
|
|
chdir(path)
Change the current working directory to the specified path. |
|
|
|
chmod(path,
mode)
Change the access permissions of a file. |
|
|
|
chown(path,
uid,
gid)
Change the owner and group id of path to the numeric uid and gid. |
|
|
|
chroot(path)
Change root directory to path. |
|
|
|
close(fd)
Close a file descriptor (for low level IO). |
|
|
|
closerange(fd_low,
fd_high)
Closes all file descriptors in [fd_low, fd_high), ignoring errors. |
|
|
string
|
confstr(name)
Return a string-valued system configuration variable. |
|
|
string
|
ctermid()
Return the name of the controlling terminal for this process. |
|
|
fd2
|
dup(fd)
Return a duplicate of a file descriptor. |
|
|
|
dup2(old_fd,
new_fd)
Duplicate file descriptor. |
|
|
|
execl(file,
*args)
Execute the executable file with argument list args, replacing the
current process. |
source code
|
|
|
execle(file,
env,
*args)
Execute the executable file with argument list args and environment
env, replacing the current process. |
source code
|
|
|
execlp(file,
*args)
Execute the executable file (which is searched for along $PATH) with
argument list args, replacing the current process. |
source code
|
|
|
execlpe(file,
env,
*args)
Execute the executable file (which is searched for along $PATH) with
argument list args and environment env, replacing the current
process. |
source code
|
|
|
execv(path,
args)
Execute an executable path with arguments, replacing current process. |
|
|
|
execve(path,
args,
env)
Execute a path with arguments and environment, replacing current process. |
|
|
|
execvp(file,
args)
Execute the executable file (which is searched for along $PATH) with
argument list args, replacing the current process. |
source code
|
|
|
execvpe(file,
args,
env)
Execute the executable file (which is searched for along $PATH) with
argument list args and environment env , replacing the current
process. |
source code
|
|
|
fchdir(fildes)
Change to the directory of the given file descriptor. |
|
|
|
fchmod(fd,
mode)
Change the access permissions of the file given by file descriptor
fd. |
|
|
|
fchown(fd,
uid,
gid)
Change the owner and group id of the file given by file descriptor fd
to the numeric uid and gid. |
|
|
|
fdatasync(fildes)
force write of file with filedescriptor to disk. |
|
|
file_object
|
fdopen(fd,
mode='r' ,
bufsize=...)
Return an open file object connected to a file descriptor. |
|
|
pid
|
fork()
Fork a child process. |
|
|
(pid, master_fd)
|
forkpty()
Fork a new process with a new pseudo-terminal as controlling tty. |
|
|
integer
|
fpathconf(fd,
name)
Return the configuration limit name for the file descriptor fd. |
|
|
stat result
|
fstat(fd)
Like stat(), but for an open file descriptor. |
|
|
statvfs result
|
fstatvfs(fd)
Perform an fstatvfs system call on the given fd. |
|
|
|
fsync(fildes)
force write of file with filedescriptor to disk. |
|
|
|
ftruncate(fd,
length)
Truncate a file to a specified length. |
|
|
path
|
getcwd()
Return a string representing the current working directory. |
|
|
path
|
getcwdu()
Return a unicode string representing the current working directory. |
|
|
egid
|
getegid()
Return the current process's effective group id. |
|
|
|
getenv(key,
default=None)
Get an environment variable, return None if it doesn't exist. |
source code
|
|
euid
|
geteuid()
Return the current process's effective user id. |
|
|
gid
|
getgid()
Return the current process's group id. |
|
|
list of group IDs
|
getgroups()
Return list of supplemental group IDs for the process. |
|
|
(float, float, float)
|
getloadavg()
Return the number of processes in the system run queue averaged over
the last 1, 5, and 15 minutes or raises OSError if the load average
was unobtainable |
|
|
string
|
getlogin()
Return the actual login name. |
|
|
pgid
|
getpgid(pid)
Call the system call getpgid(). |
|
|
pgrp
|
getpgrp()
Return the current process group id. |
|
|
pid
|
getpid()
Return the current process id |
|
|
ppid
|
getppid()
Return the parent's process id. |
|
|
sid
|
getsid(pid)
Call the system call getsid(). |
|
|
uid
|
getuid()
Return the current process's user id. |
|
|
bool
|
isatty(fd)
Return True if the file descriptor 'fd' is an open file descriptor
connected to the slave end of a terminal. |
|
|
|
kill(pid,
sig)
Kill a process with a signal. |
|
|
|
killpg(pgid,
sig)
Kill a process group with a signal. |
|
|
|
lchown(path,
uid,
gid)
Change the owner and group id of path to the numeric uid and gid. |
|
|
|
link(src,
dst)
Create a hard link to a file. |
|
|
list_of_strings
|
listdir(path)
Return a list containing the names of the entries in the directory. |
|
|
newpos
|
lseek(fd,
pos,
how)
Set the current position of a file descriptor. |
|
|
stat result
|
lstat(path)
Like stat(path), but do not follow symbolic links. |
|
|
major number
|
major(device)
Extracts a device major number from a raw device number. |
|
|
device number
|
makedev(major,
minor)
Composes a raw device number from the major and minor device numbers. |
|
|
|
makedirs(path,
mode=0777)
Super-mkdir; create a leaf directory and all intermediate ones. |
source code
|
|
minor number
|
minor(device)
Extracts a device minor number from a raw device number. |
|
|
|
mkdir(path,
mode=0777)
Create a directory. |
|
|
|
mkfifo(filename,
mode=0666)
Create a FIFO (a POSIX named pipe). |
|
|
|
mknod(filename,
mode=0600,
device=...)
Create a filesystem node (file, device special file or named pipe)
named filename. |
|
|
new_priority
|
nice(inc)
Decrease the priority of process by inc and return the new priority. |
|
|
fd
|
open(filename,
flag,
mode=0777)
Open a file (for low level IO). |
|
|
(master_fd, slave_fd)
|
openpty()
Open a pseudo-terminal, returning open fd's for both master and slave
end. |
|
|
integer
|
pathconf(path,
name)
Return the configuration limit name for the file or directory path. |
|
|
(read_end, write_end)
|
|
pipe
|
popen(command,
mode='r' ,
bufsize=...)
Open a pipe to/from a command returning a file object. |
|
|
|
popen2(cmd,
mode=' t ' ,
bufsize=-1)
Execute the shell command 'cmd' in a sub-process. |
source code
|
|
|
popen3(cmd,
mode=' t ' ,
bufsize=-1)
Execute the shell command 'cmd' in a sub-process. |
source code
|
|
|
popen4(cmd,
mode=' t ' ,
bufsize=-1)
Execute the shell command 'cmd' in a sub-process. |
source code
|
|
|
putenv(key,
value)
Change or add an environment variable. |
|
|
string
|
read(fd,
buffersize)
Read a file descriptor. |
|
|
path
|
readlink(path)
Return a string representing the path to which the symbolic link
points. |
|
|
|
remove(path)
Remove a file (same as unlink(path)). |
|
|
|
|
|
rename(old,
new)
Rename a file or directory. |
|
|
|
renames(old,
new)
Super-rename; create directories as necessary and delete any left
empty. |
source code
|
|
|
rmdir(path)
Remove a directory. |
|
|
|
setegid(gid)
Set the current process's effective group id. |
|
|
|
seteuid(uid)
Set the current process's effective user id. |
|
|
|
setgid(gid)
Set the current process's group id. |
|
|
|
setgroups(list)
Set the groups of the current process to list. |
|
|
|
setpgid(pid,
pgrp)
Call the system call setpgid(). |
|
|
|
setpgrp()
Make this process a session leader. |
|
|
|
setregid(rgid,
egid)
Set the current process's real and effective group ids. |
|
|
|
setreuid(ruid,
euid)
Set the current process's real and effective user ids. |
|
|
|
setsid()
Call the system call setsid(). |
|
|
|
setuid(uid)
Set the current process's user id. |
|
|
integer
|
spawnl(mode,
file,
*args)
Execute file with arguments from args in a subprocess. |
source code
|
|
integer
|
spawnle(mode,
file,
env,
*args)
Execute file with arguments from args in a subprocess with the
supplied environment. |
source code
|
|
integer
|
spawnlp(mode,
file,
*args)
Execute file (which is looked for along $PATH) with arguments from
args in a subprocess with the supplied environment. |
source code
|
|
integer
|
spawnlpe(mode,
file,
env,
*args)
Execute file (which is looked for along $PATH) with arguments from
args in a subprocess with the supplied environment. |
source code
|
|
integer
|
spawnv(mode,
file,
args)
Execute file with arguments from args in a subprocess. |
source code
|
|
integer
|
spawnve(mode,
file,
args,
env)
Execute file with arguments from args in a subprocess with the
specified environment. |
source code
|
|
integer
|
spawnvp(mode,
file,
args)
Execute file (which is looked for along $PATH) with arguments from
args in a subprocess. |
source code
|
|
integer
|
spawnvpe(mode,
file,
args,
env)
Execute file (which is looked for along $PATH) with arguments from
args in a subprocess with the supplied environment. |
source code
|
|
stat result
|
stat(path)
Perform a stat system call on the given path. |
|
|
oldval
|
stat_float_times(newval=...)
Determine whether os.[lf]stat represents time stamps as float
objects. |
|
|
statvfs result
|
statvfs(path)
Perform a statvfs system call on the given path. |
|
|
string
|
strerror(code)
Translate an error code to a message string. |
|
|
|
symlink(src,
dst)
Create a symbolic link pointing to src named dst. |
|
|
integer
|
sysconf(name)
Return an integer-valued system configuration variable. |
|
|
exit_status
|
system(command)
Execute the command (a string) in a subshell. |
|
|
pgid
|
tcgetpgrp(fd)
Return the process group associated with the terminal given by a fd. |
|
|
|
tcsetpgrp(fd,
pgid)
Set the process group associated with the terminal given by a fd. |
|
|
string
|
tempnam(dir=...,
prefix=...)
Return a unique name for a temporary file. |
|
|
(utime, stime, cutime, cstime, elapsed_time)
|
times()
Return a tuple of floating point numbers indicating process times. |
|
|
file object
|
tmpfile()
Create a temporary file with no directory entries. |
|
|
string
|
tmpnam()
Return a unique name for a temporary file. |
|
|
string
|
ttyname(fd)
Return the name of the terminal device connected to 'fd'. |
|
|
old_mask
|
umask(new_mask)
Set the current numeric umask and return the previous umask. |
|
|
(sysname, nodename, release, version, machine)
|
uname()
Return a tuple identifying the current operating system. |
|
|
|
unlink(path)
Remove a file (same as remove(path)). |
|
|
|
unsetenv(key)
Delete an environment variable. |
|
|
str
|
urandom(n)
Return a string of n random bytes suitable for cryptographic use. |
source code
|
|
|
utime(...)
utime(path, (atime, mtime)) utime(path, None) |
|
|
(pid, status)
|
wait()
Wait for completion of a child process. |
|
|
(pid, status, rusage)
|
wait3(options)
Wait for completion of a child process. |
|
|
(pid, status, rusage)
|
wait4(pid,
options)
Wait for completion of a given child process. |
|
|
(pid, status)
|
waitpid(pid,
options)
Wait for completion of a given child process. |
|
|
|
walk(top,
topdown=True,
onerror=None,
followlinks=False)
Directory tree generator. |
source code
|
|
byteswritten
|
write(fd,
string)
Write a string to a file descriptor. |
|
|