os — Interfaces misceláneas del sistema operativo¶

Nombres de archivos, argumentos de la línea de comandos y variables de entorno¶

En Python, los nombres de archivo, los argumentos de la línea de comandos y las variables de entorno se representan mediante el tipo de cadena de caracteres. En algunos sistemas, es necesario decodificar estas cadenas desde y hacia bytes antes de pasarlas al sistema operativo. Python usa la codificación del sistema de archivos y manejador de errores para realizar esta conversión (consulte sys.getfilesystemencoding()).

La codificación del sistema de archivos y manejador de errores se configuran al inicio de Python mediante la función PyConfig_Read(): consulte los miembros filesystem_encoding y filesystem_errors de PyConfig.

La codificación del sistema de archivos y manejador de errores debe garantizar la decodificación exitosa de todos los bytes por debajo de 128. Si la codificación del sistema de archivos no proporciona esta garantía, las funciones de API pueden generar UnicodeError.

Consulte también la codificación de la configuración regional.

Modo Python UTF-8¶

El modo Python UTF-8 ignora la codificación de la configuración regional y fuerza el uso de la codificación UTF-8:

• Utilice UTF-8 como codificación del sistema de archivos y manejador de errores.

• sys.getfilesystemencoding() retorna 'utf-8'.

• locale.getpreferredencoding() retorna 'utf-8' (el argumento do_setlocale no tiene ningún efecto).

• sys.stdin, sys.stdout y sys.stderr usan UTF-8 como su codificación de texto, con surrogateescape error handler habilitado para sys.stdin y sys.stdout (sys.stderr continúa usando backslashreplace como lo hace en el modo predeterminado de reconocimiento de configuración regional)

• En Unix, os.device_encoding() retorna 'utf-8'. en lugar de la codificación del dispositivo.

Tenga en cuenta que PYTHONIOENCODING puede anular la configuración de transmisión estándar en el modo UTF-8 (al igual que en el modo predeterminado con reconocimiento de configuración regional).

Como consecuencia de los cambios en esas API de nivel inferior, otras API de nivel superior también exhiben diferentes comportamientos predeterminados:

• Los argumentos de la línea de comandos, las variables de entorno y los nombres de archivo se decodifican en texto utilizando la codificación UTF-8.

• os.fsdecode() y os.fsencode() utilizan la codificación UTF-8.

• open(), io.open() y codecs.open() utilizan la codificación UTF-8 de forma predeterminada. Sin embargo, todavía usan el controlador de errores estricto de forma predeterminada, por lo que es probable que intentar abrir un archivo binario en modo texto genere una excepción en lugar de producir datos sin sentido.

El Modo Python UTF-8 se habilita si la configuración regional LC_CTYPE es C o POSIX al iniciar Python (consulte la función PyConfig_Read()).

Se puede habilitar o deshabilitar usando la opción de línea de comando -X utf8 y la variable de entorno PYTHONUTF8.

Si la variable de entorno PYTHONUTF8 no está configurada en absoluto, entonces el intérprete utiliza de forma predeterminada la configuración regional actual, a no ser que la configuración regional actual se identifica como una configuración regional heredada basada en ASCII (como se describe para PYTHONCOERCECLOCALE) y la coerción de la configuración regional está deshabilitada o falla . En tales configuraciones regionales heredadas, el intérprete habilitará de forma predeterminada el modo UTF-8 a menos que se le indique explícitamente que no lo haga.

El modo Python UTF-8 solo se puede habilitar al inicio de Python. Su valor se puede leer en sys.flags.utf8_mode.

Consulte también modo UTF-8 en Windows y codificación del sistema de archivos y manejador de errores.

Parámetros de proceso¶

Estas funciones y elementos de datos proporcionan información y operan en el proceso y con el usuario actuales.

os.ctermid()¶

Retorna el nombre del archivo correspondiente al terminal que controla el proceso.

Availability: Unix, not WASI.

os.environ¶

Un objeto mapping donde las claves y los valores son cadenas que representan el entorno del proceso. Por ejemplo, environ['HOME'] es el nombre de ruta de su directorio de inicio (en algunas plataformas) y es equivalente a getenv("HOME") en C.

Esta asignación se captura la primera vez que se importa el módulo os, normalmente durante el inicio de Python como parte del procesamiento de site.py. Los cambios en el entorno realizados después de este tiempo no se reflejan en os.environ, excepto los cambios realizados modificando os.environ directamente.

Este mapeo puede ser usado para modificar el entorno y también para consultarlo. putenv() será llamado automáticamente cuando el mapeo sea modificado.

En Unix, claves y valores usan la función sys.getfilesystemencoding() y el controlador de errores 'surrogateescape'. Hay que utilizar environb si se quiere usar una codificación diferente.

En Windows, las claves se convierten a mayúsculas. Esto también se aplica al obtener, configurar o eliminar un elemento. Por ejemplo, environ['monty'] = 'python' asigna a la clave 'MONTY' el valor 'python'.

Nota

Llamar a putenv() directamente no cambia os.environ, por lo que es mejor modificar os.environ.

Nota

En algunas plataformas, incluidas FreeBSD y macOS, configurar environ puede provocar pérdidas de memoria. Consulte la documentación del sistema para putenv().

Puede eliminar elementos en esta asignación para desactivar las variables de entorno. unsetenv() se llamará automáticamente cuando se elimine un elemento de os.environ y cuando se llame a uno de los métodos pop() o clear().

Ver también

The os.reload_environ() function.

Distinto en la versión 3.9: Actualizado para soportar los operadores merge (|) y update (|=) de PEP 584’s.

os.environb¶

Versión de bytes de environ: un objeto mapping donde tanto las claves como los valores son objetos bytes que representan el entorno del proceso. environ y environb están sincronizados (modificando environb actualiza environ, y viceversa).

environb está disponible sólo si supports_bytes_environ está establecido en True.

Added in version 3.2.

Distinto en la versión 3.9: Actualizado para soportar los operadores merge (|) y update (|=) de PEP 584’s.

os.reload_environ()¶

The os.environ and os.environb mappings are a cache of environment variables at the time that Python started. As such, changes to the current process environment are not reflected if made outside Python, or by os.putenv() or os.unsetenv(). Use os.reload_environ() to update os.environ and os.environb with any such changes to the current process environment.

Advertencia

This function is not thread-safe. Calling it while the environment is being modified in an other thread is an undefined behavior. Reading from os.environ or os.environb, or calling os.getenv() while reloading, may return an empty result.

Added in version 3.14.

os.chdir(path)

os.fchdir(fd)

os.getcwd()

Estas funciones están detalladas en Archivos y directorios.

os.fsencode(filename)¶

Codifique path-like filename en filesystem encoding and error handler; retorna bytes sin cambios.

fsdecode() es la función inversa.

Added in version 3.2.

Distinto en la versión 3.6: Soporte agregado para aceptar objetos que implementan una interfaz os.PathLike.

os.fsdecode(filename)¶

Decodifica el path-like filename del filesystem encoding and error handler; retorna str sin cambios.

fsencode() es la función inversa.

Added in version 3.2.

Distinto en la versión 3.6: Soporte agregado para aceptar objetos que implementan una interfaz os.PathLike.

os.fspath(path)¶

Retorna la representación en el sistema de archivos de la ruta.

Si se le pasa str o bytes, retorna sin alterar. De lo contrario se llama a __fspath__() y se retorna su valor siempre que sea un objeto str o bytes. En los demás casos se lanza una excepción del tipo TypeError.

Added in version 3.6.

class os.PathLike¶

Una clase base abstracta para objetos que representan una ruta del sistema de archivos, i.e. pathlib.PurePath.

Added in version 3.6.

abstractmethod __fspath__()¶

Retorna la representación de la ruta del sistema de archivos del objeto.

Este método sólo retornará objetos str or bytes, preferentemente str.

os.getenv(key, default=None)¶

Devuelve el valor de la variable de entorno key como una cadena si existe, o default si no existe. key es una cadena. Tenga en cuenta que dado que getenv() usa os.environ, la asignación de getenv() también se captura de manera similar en la importación, y es posible que la función no refleje futuros cambios en el entorno.

En Unix, claves y valores se decodifican con la función sys.getfilesystemencoding() y con el controlador de errores 'surrogateescape'. Usar os.getenvb() si se quiere usar una codificación diferente.

Availability: Unix, Windows.

os.getenvb(key, default=None)¶

Devuelve el valor de la variable de entorno key como bytes si existe, o default si no existe. key debe ser bytes. Tenga en cuenta que dado que getenvb() usa os.environb, la asignación de getenvb() también se captura de manera similar en la importación, y es posible que la función no refleje futuros cambios en el entorno.

getenvb() está disponible sólo si supports_bytes_environ está establecido en True.

Availability: Unix.

Added in version 3.2.

os.get_exec_path(env=None)¶

Retorna una lista de directorios en la que se buscará un ejecutable, similar a una shell, cuando se ejecuta un proceso. env, cuando se especifica, tienen que ser un diccionario de variables de entorno donde buscar el PATH. Por defecto cuando env es None, se usa environ.

Added in version 3.2.

os.getegid()¶

Retorna el id del grupo (gid) efectivo correspondiente al proceso que se está ejecutando. Esto corresponde al bit de «set id» en el archivo que se está ejecutando en el proceso actual.

Availability: Unix, not WASI.

os.geteuid()¶

Retorna el id el usuario correspondiente al proceso que se está ejecutando actualmente.

Availability: Unix, not WASI.

os.getgid()¶

Retorna el id del grupo real correspondiente al proceso que se está ejecutando actualmente.

Availability: Unix.

La función es un «stub» de WASI, consulte Plataformas WebAssembly para obtener más información.

os.getgrouplist(user, group, /)¶

Devuelve la lista de ID de grupo a los que pertenece user. Si group no está en la lista, se incluye; normalmente, group se especifica como el campo de ID de grupo del registro de contraseña para user, porque de lo contrario, esa ID de grupo podría omitirse.

Availability: Unix, not WASI.

Added in version 3.3.

os.getgroups()¶

Retorna la lista de ids de grupos secundarios asociados con el proceso actual.

Availability: Unix, not WASI.

Nota

En macOS, el comportamiento de getgroups() difiere un poco del de otras plataformas Unix. Si el intérprete de Python se creó con un objetivo de implementación 10.5 o anterior, getgroups() devuelve la lista de identificadores de grupo efectivos asociados con el proceso de usuario actual; esta lista está limitada a una cantidad de entradas definida por el sistema, normalmente 16, y puede modificarse mediante llamadas a setgroups() si se cuenta con los privilegios adecuados. Si se creó con un objetivo de implementación mayor que 10.5, getgroups() devuelve la lista de acceso de grupo actual para el usuario asociado con el identificador de usuario efectivo del proceso; la lista de acceso de grupo puede cambiar durante la vida útil del proceso, no se ve afectada por las llamadas a setgroups() y su longitud no está limitada a 16. El valor del objetivo de implementación, MACOSX_DEPLOYMENT_TARGET, se puede obtener con sysconfig.get_config_var().

os.getlogin()¶

Retorna el nombre del usuario que inició sesión en el terminal que controla el proceso. Para la mayoría de los casos, es más útil usar getpass.getuser() ya que este último verifica las variables de entorno LOGNAME o USERNAME para averiguar quién es el usuario y recurre a pwd.getpwuid(os.getuid())[0] para obtener el nombre de inicio de sesión del ID de usuario real actual.

Availability: Unix, Windows, not WASI.

os.getpgid(pid)¶

Retorna el id del grupo de procesos del proceso con la identificación del proceso pid. Si pid es 0, se retorna la identificación del grupo de proceso del proceso actual.

Availability: Unix, not WASI.

os.getpgrp()¶

Retorna el id del grupo de proceso actual.

Availability: Unix, not WASI.

os.getpid()¶

Retorna el id del proceso actual.

La función es un «stub» de WASI, consulte Plataformas WebAssembly para obtener más información.

os.getppid()¶

Retorna el id del proceso del padre. Cuando el proceso padre ha terminado, en Unix la identificación que retorna es la del proceso init (1), en Windows sigue siendo la misma identificación, que ya puede ser reutilizada por otro proceso.

Availability: Unix, Windows, not WASI.

Distinto en la versión 3.2: Se agregó soporte para Windows.

os.getpriority(which, who)¶

Obtenga la prioridad del programa. El valor which es uno de PRIO_PROCESS, PRIO_PGRP, o PRIO_USER, y who se interpreta en relación a which (un identificador de proceso para PRIO_PROCESS, un identificador de grupo de proceso para PRIO_PGRP, y un ID de usuario para PRIO_USER). Un valor cero para who denota (respectivamente) el proceso llamado, el grupo de proceso del proceso llamado o el ID de usuario real del proceso llamado.

Availability: Unix, not WASI.

Added in version 3.3.

os.PRIO_PROCESS¶

os.PRIO_PGRP¶

os.PRIO_USER¶

Parámetros para las funciones getpriority() y setpriority().

Availability: Unix, not WASI.

Added in version 3.3.

os.PRIO_DARWIN_THREAD¶

os.PRIO_DARWIN_PROCESS¶

os.PRIO_DARWIN_BG¶

os.PRIO_DARWIN_NONUI¶

Parámetros para las funciones getpriority() y setpriority().

Availability: macOS

Added in version 3.12.

os.getresuid()¶

Retorna una tupla (ruid, euid, suid) que denota los ID de usuario reales, efectivos y guardados del proceso actual.

Availability: Unix, not WASI.

Added in version 3.2.

os.getresgid()¶

Retorna una tupla (rgid, egid, sgid) que denota los ID de grupo reales, efectivos y guardados del proceso actual.

Availability: Unix, not WASI.

Added in version 3.2.

os.getuid()¶

Retorna el id del usuario real del proceso actual.

Availability: Unix.

La función es un «stub» de WASI, consulte Plataformas WebAssembly para obtener más información.

os.initgroups(username, gid, /)¶

Llamada al sistema initgroups() para inicializar la lista de acceso de grupo con todos los grupos de los que es miembro el nombre de usuario especificado, más el ID del grupo especificado.

Availability: Unix, not WASI, not Android.

Added in version 3.2.

os.putenv(key, value, /)¶

Establece la variable de entorno llamada key con el valor de la cadena value. Dichos cambios en el entorno impactan a los subprocesos iniciados con os.system(), popen() o fork() y execv().

Las asignaciones a elementos en os.environ se traducen automáticamente en llamadas correspondientes a putenv(); sin embargo, las llamadas a putenv() no actualizan os.environ, por lo que en realidad es preferible asignar elementos de os.environ. Esto también se aplica a getenv() y getenvb(), que utilizan respectivamente os.environ y os.environb en sus implementaciones.

See also the os.reload_environ() function.

Nota

En algunas plataformas, incluidas FreeBSD y macOS, la configuración de environ puede provocar pérdidas de memoria. Consulta la documentación del sistema para obtener información sobre putenv().

Lanza un evento de auditoría os.putenv con argumentos key, value.

Distinto en la versión 3.9: Esta función actualmente siempre esta disponible.

os.setegid(egid, /)¶

Establece el id de grupo efectivo del proceso actual.

Availability: Unix, not WASI, not Android.

os.seteuid(euid, /)¶

Establece el id de usuario efectivo del proceso actual.

Availability: Unix, not WASI, not Android.

os.setgid(gid, /)¶

Establece el id de grupo del proceso actual.

Availability: Unix, not WASI, not Android.

os.setgroups(groups, /)¶

Establece la lista de ids de grupos secundarios asociados con el proceso actual en groups. groups debe ser una secuencia y cada elemento debe ser un número entero que identifique un grupo. Esta operación generalmente está disponible sólo para el superusuario.

Availability: Unix, not WASI.

Nota

En macOS, la longitud de groups no puede exceder el número máximo definido por el sistema de ID de grupo efectivos, por lo general 16. Consulte la documentación de getgroups() para ver los casos en los que puede no retornar la misma lista de grupos establecida llamando a setgroups().

os.setns(fd, nstype=0)¶

Reasociar el hilo actual con un espacio de nombres de Linux. Consulta las páginas del manual setns(2) y namespaces(7) para obtener más detalles.

Si fd hace referencia a un enlace /proc/pid/ns/, setns() reasocia el hilo que llama con el espacio de nombres asociado con ese enlace, y nstype puede configurarse en uno de los CLONE_NEW* constants para imponer restricciones a la operación (0 significa sin restricciones).

Desde Linux 5.8, fd puede hacer referencia a un descriptor de archivo PID obtenido de pidfd_open(). En este caso, setns() reasocia el subproceso que realiza la llamada en uno o más de los mismos espacios de nombres que el subproceso al que hace referencia fd. Esto está sujeto a las restricciones impuestas por nstype, que es una máscara de bits que combina uno o más de los CLONE_NEW* constants, por ejemplo, setns(fd, os.CLONE_NEWUTS | os.CLONE_NEWPID). Las pertenencias del autor de la llamada a espacios de nombres no especificados no se modifican.

fd puede ser cualquier objeto con un método fileno() o un descriptor de archivo sin formato.

Este ejemplo reasocia el hilo con el espacio de nombres de red del proceso init:

fd = os.open("/proc/1/ns/net", os.O_RDONLY)
os.setns(fd, os.CLONE_NEWNET)
os.close(fd)

Availability: Linux >= 3.0 with glibc >= 2.14.

Added in version 3.12.

Ver también

La función unshare().

os.setpgrp()¶

Llama a la llamada del sistema setpgrp() o setpgrp(0, 0) según la versión implementada (si hay alguna). Consulte el manual de Unix para conocer la semántica.

Availability: Unix, not WASI.

os.setpgid(pid, pgrp, /)¶

Llama a la llamada del sistema setpgid() para establecer el ID del grupo de procesos del proceso con el ID pid en el grupo de procesos con el ID pgrp. Consulte el manual de Unix para conocer la semántica.

Availability: Unix, not WASI.

os.setpriority(which, who, priority)¶

Establecer la prioridad del programa. El valor which es uno de PRIO_PROCESS, PRIO_PGRP, o PRIO_USER, y who se interpreta en relación con which (un identificador de proceso para PRIO_PROCESS, un identificador de grupo de proceso para PRIO_PGRP, y un ID de usuario para PRIO_USER). Un valor cero para who denota (respectivamente) el proceso llamado, el grupo de procesos del proceso llamado o el ID del usuario real del proceso llamado. priority es un valor en el rango de -20 a 19. La prioridad predeterminada es 0; las prioridades más bajas causan una programación más favorable.

Availability: Unix, not WASI.

Added in version 3.3.

os.setregid(rgid, egid, /)¶

Establece los ids de grupos reales y efectivos del proceso actual.

Availability: Unix, not WASI, not Android.

os.setresgid(rgid, egid, sgid, /)¶

Establece los ids de grupo reales, efectivos y guardados del proceso actual.

Availability: Unix, not WASI, not Android.

Added in version 3.2.

os.setresuid(ruid, euid, suid, /)¶

Establece los ids de usuario reales, efectivos y guardados del proceso actual.

Availability: Unix, not WASI, not Android.

Added in version 3.2.

os.setreuid(ruid, euid, /)¶

Establece los ids de usuario reales y efectivos del proceso actual.

Availability: Unix, not WASI, not Android.

os.getsid(pid, /)¶

Llamar a la llamada del sistema getsid(). Consultar el manual de Unix para conocer la semántica.

Availability: Unix, not WASI.

os.setsid()¶

Llamar a la llamada del sistema setsid(). Consultar el manual de Unix para conocer la semántica.

Availability: Unix, not WASI.

os.setuid(uid, /)¶

Establece id del usuario del proceso actual.

Availability: Unix, not WASI, not Android.

os.strerror(code, /)¶

Devuelve el mensaje de error correspondiente al código de error en code. En las plataformas donde strerror() devuelve NULL cuando se le asigna un número de error desconocido, se genera ValueError.

os.supports_bytes_environ¶

True si el tipo de entorno nativo del sistema operativo es bytes (por ejemplo, False en Windows).

Added in version 3.2.

os.umask(mask, /)¶

Establece la umask numérica actual y retorna la umask anterior.

La función es un «stub» de WASI, consulte Plataformas WebAssembly para obtener más información.

os.uname()¶

Retorna información que identifica el sistema operativo actual. El valor retornado es un objeto con cinco atributos:

• sysname - nombre del sistema operativo

• nodename - nombre de la máquina en la red (definida por la implementación)

• release - release del sistema operativo

• version - versión del sistema operativo

• machine - identificador de hardware

Por compatibilidad con versiones anteriores, este objeto también es iterable, se comporta como una tupla que contiene sysname, nodename, release, version, y machine en ese orden.

Algunos sistemas se truncan nodename a 8 caracteres o al componente principal; una mejor manera de obtener el nombre de host es usar socket.gethostname() o incluso socket.gethostbyaddr(socket.gethostname()).

En macOS, iOS y Android, esto devuelve el nombre y la versión de kernel (es decir, 'Darwin' en macOS e iOS; 'Linux' en Android). platform.uname() se puede utilizar para obtener el nombre y la versión del sistema operativo que ven los usuarios en iOS y Android.

Availability: Unix.

Distinto en la versión 3.3: El tipo de objeto retornado cambió de una tupla a un objeto tipo tupla con atributos con nombre.

os.unsetenv(key, /)¶

Desestablece (elimine) la variable de entorno llamada key. Dichos cambios en el entorno afectan a los subprocesos iniciados con os.system(), popen() o fork() y execv().

La eliminación de elementos en os.environ se traduce automáticamente en una llamada correspondiente a unsetenv(); sin embargo, las llamadas a unsetenv() no actualizan os.environ, por lo que en realidad es preferible eliminar elementos de os.environ.

See also the os.reload_environ() function.

Lanza un evento de auditoría os.unsetenv con argumento key.

Distinto en la versión 3.9: Estas funciones se encuentra ahora siempre disponible y también esta disponible en Windows.

os.unshare(flags)¶

Desasociar partes del contexto de ejecución del proceso y moverlas a un nuevo espacio de nombres creado. Consulte la página del manual unshare(2) para obtener más detalles. El argumento flags es una máscara de bits que combina cero o más de los CLONE_* constants y que especifica qué partes del contexto de ejecución deben dejar de compartirse de sus asociaciones existentes y moverse a un nuevo espacio de nombres. Si el argumento flags es 0, no se realizan cambios en el contexto de ejecución del proceso que realiza la llamada.

Availability: Linux >= 2.6.16.

Added in version 3.12.

Ver también

La función setns().

Indicadores de la función unshare(), si la implementación los admite. Consulte unshare(2) en el manual de Linux para conocer su efecto exacto y su disponibilidad.

os.CLONE_FILES¶

os.CLONE_FS¶

os.CLONE_NEWCGROUP¶

os.CLONE_NEWIPC¶

os.CLONE_NEWNET¶

os.CLONE_NEWNS¶

os.CLONE_NEWPID¶

os.CLONE_NEWTIME¶

os.CLONE_NEWUSER¶

os.CLONE_NEWUTS¶

os.CLONE_SIGHAND¶

os.CLONE_SYSVSEM¶

os.CLONE_THREAD¶

os.CLONE_VM¶

Creación de objetos de tipo archivo¶

Estas funciones crean nuevos objetos de archivo. (Consulte también open() para abrir los descriptores de archivos).

os.fdopen(fd, *args, **kwargs)¶

Retorna un objeto de archivo abierto conectado al descriptor de archivo fd. Este es un alias de la función incorporada open() y acepta los mismos argumentos. La única diferencia es que el primer argumento de fdopen() siempre debe ser un número entero.

Operaciones de descriptores de archivos¶

Estas funciones operan en flujos de E/S a los que se hace referencia mediante descriptores de archivo.

Los descriptores de archivo son enteros pequeños que corresponden a un archivo que ha sido abierto por el proceso actual. Por ejemplo, la entrada estándar suele ser el descriptor de archivo 0, la salida estándar es el 1 y el error estándar es el 2. A los archivos abiertos por un proceso se les asignará 3, 4, 5, y así sucesivamente. El nombre «descriptor de archivo» es ligeramente engañoso; en las plataformas Unix, los descriptores de archivo también hacen referencia a sockets y tuberías.

El método fileno() se puede utilizar para obtener el descriptor de archivo asociado con un file object cuando sea necesario. Tenga en cuenta que el uso del descriptor de archivo directamente omitirá los métodos de objeto de archivo, ignorando aspectos como el almacenamiento interno interno de datos.

os.close(fd)¶

Cierra el descriptor de archivo fd.

Nota

Esta función está diseñada para E/S de bajo nivel y debe aplicarse a un descriptor de archivo tal como lo retorna os.open() o pipe(). Para cerrar un «objeto de archivo» retornado por la función incorporada open() o por popen() o fdopen(), use el método close().

os.closerange(fd_low, fd_high, /)¶

Cierra todos los descriptores de archivo desde fd_low (inclusive) hasta fd_high (exclusivo), ignorando los errores. Equivalente a (pero mucho más rápido que):

for fd in range(fd_low, fd_high):
    try:
        os.close(fd)
    except OSError:
        pass

os.copy_file_range(src, dst, count, offset_src=None, offset_dst=None)¶

Copiar bytes count desde el descriptor de archivo src, comenzando desde el desplazamiento offset_src, al descriptor de archivo dst, comenzando desde el desplazamiento offset_dst. Si offset_src es None, entonces src se lee desde la posición actual; respectivamente para offset_dst.

En un kernel de Linux anterior a 5.3, los archivos a los que apuntan src y dst deben residir en el mismo sistema de archivos; de lo contrario, se genera un OSError con errno establecido en errno.EXDEV.

Esta copia se realiza sin el costo adicional de transferir datos desde el núcleo al espacio de usuario y luego de vuelta al núcleo. Además, algunos sistemas de archivos podrían implementar optimizaciones adicionales, como el uso de enlaces de referencia (es decir, dos o más inodos que comparten punteros a los mismos bloques de disco de copia en escritura; los sistemas de archivos compatibles incluyen btrfs y XFS) y copia del lado del servidor (en el caso de NFS).

La función copia bytes entre dos descriptores de archivo. Las opciones de texto, como la codificación y el final de línea, se ignoran.

El valor de retorno es la cantidad de bytes copiados. Esto podría ser menor que la cantidad solicitada.

Nota

En Linux, no se debe utilizar os.copy_file_range() para copiar un rango de un pseudoarchivo desde un sistema de archivos especial como procfs y sysfs. Siempre no copiará ningún byte y devolverá 0 como si el archivo estuviera vacío debido a un problema conocido del kernel de Linux.

Availability: Linux >= 4.5 with glibc >= 2.27.

Added in version 3.8.

os.device_encoding(fd)¶

Retorna una cadena que describe la codificación del dispositivo asociado con fd si está conectado a una terminal; sino retorna None.

En Unix, si el Modo Python UTF-8 está habilitado, retorna 'UTF-8' en lugar de la codificación del dispositivo.

Distinto en la versión 3.10: En Unix, la función ahora implementa el modo Python UTF-8.

os.dup(fd, /)¶

Retorna un duplicado del descriptor de archivo fd. El nuevo descriptor de archivo es no heredable.

En Windows, al duplicar un flujo estándar (0: stdin, 1: stdout, 2: stderr), el nuevo descriptor de archivo es heredable.

Availability: not WASI.

Distinto en la versión 3.4: El nuevo descriptor de archivo ahora es no heredable.

os.dup2(fd, fd2, inheritable=True)¶

Duplicar el descriptor de archivo fd a fd2, cerrando el anterior si es necesario. Retorna fd2. El nuevo descriptor de archivo es heredable por defecto o no heredable si inheritable es False.

Availability: not WASI.

Distinto en la versión 3.4: Agrega el parámetro opcional inheritable.

Distinto en la versión 3.7: Retorna fd2 en caso de éxito. Anteriormente se retornaba siempre None.

os.fchmod(fd, mode)¶

Cambia el modo del archivo dado por fd al modo numérico mode. Consulte los documentos para chmod() para conocer los posibles valores de mode. A partir de Python 3.3, esto es equivalente a os.chmod(fd, mode).

Lanza un evento de auditoría os.chmod con argumentos path, mode, dir_fd.

Availability: Unix, Windows.

La función está limitada en WASI, consulte Plataformas WebAssembly para obtener más información.

Distinto en la versión 3.13: Se agregó soporte en Windows.

os.fchown(fd, uid, gid)¶

Cambia el propietario y el id del grupo del archivo proporcionado por fd a los numéricos dados por uid y gid. Para dejar uno de los identificadores sin cambios, configúrelo en -1. Ver chown(). A partir de Python 3.3, esto es equivalente a os.chown(fd, uid, gid).

Lanza un evento de auditoría os.chown con argumentos path, uid, gid, dir_fd.

Availability: Unix.

La función está limitada en WASI, consulte Plataformas WebAssembly para obtener más información.

os.fdatasync(fd)¶

Fuerza la escritura del archivo con el descriptor de archivo fd en el disco. No fuerza la actualización de metadatos.

Availability: Unix.

Nota

Esta función no está disponible en MacOS.

os.fpathconf(fd, name, /)¶

Retorna la información de configuración del sistema relevante para un archivo abierto. name especifica el valor de configuración para recuperar; puede ser una cadena que es el nombre de un valor de sistema definido; estos nombres se especifican en varios estándares (POSIX.1, Unix 95, Unix 98 y otros). Algunas plataformas también definen nombres adicionales. Los nombres conocidos por el sistema operativo anfitrión se dan en el diccionario pathconf_names. Para las variables de configuración no incluidas en esa asignación, también se acepta pasar un número entero para name.

Si name es una cadena y no se conoce, se lanza un ValueError. Si el sistema anfitrión no admite un valor específico para name, incluso si está incluido en pathconf_names, se genera un OSError con errno.EINVAL para el número de error.

A partir de Python 3.3, esto es equivalente a os.pathconf(fd, name).

Availability: Unix.

os.fstat(fd)¶

Obtiene el estado del descriptor de archivo fd. Retorna un objeto stat_result.

A partir de Python 3.3, esto es equivalente a os.stat(fd).

Ver también

La función stat().

os.fstatvfs(fd, /)¶

Retorna información sobre el sistema de archivos que contiene el archivo asociado con el descriptor de archivo fd, como statvfs(). A partir de Python 3.3, esto es equivalente a os.statvfs(fd).

Availability: Unix.

os.fsync(fd)¶

Fuerza la escritura de un archivo con el descriptor de archivo fd en el disco. En Unix, esto llama a la función fsync() nativa; en Windows, a la función _commit() de MS.

Si está comenzando con un Python almacenado en búfer file object f, primero haga f.flush(), y luego haga os.fsync(f.fileno()), para garantizar que todas las memorias intermedias internas asociadas con f se escriban en disco.

Availability: Unix, Windows.

os.ftruncate(fd, length, /)¶

Trunca el archivo correspondiente al descriptor de archivo fd, para que tenga como máximo length bytes de tamaño. A partir de Python 3.3, esto es equivalente a os.truncate(fd, length).

Lanza un evento de auditoría os.truncate con argumentos fd, length.

Availability: Unix, Windows.

Distinto en la versión 3.5: Se agregó soporte para Windows

os.get_blocking(fd, /)¶

Obtiene el modo de bloqueo del descriptor de archivo: False si se establece el indicador O_NONBLOCK, True si el indicador se borra.

Consulte también set_blocking() y socket.socket.setblocking().

Availability: Unix, Windows.

La función está limitada en WASI, consulte Plataformas WebAssembly para obtener más información.

En Windows, esta función está limitada a las tuberías.

Added in version 3.5.

Distinto en la versión 3.12: Se agregó soporte para pipes en Windows.

os.grantpt(fd, /)¶

Otorgar acceso al dispositivo pseudoterminal esclavo asociado con el dispositivo pseudoterminal maestro al que hace referencia el descriptor de archivo fd. El descriptor de archivo fd no se cierra en caso de falla.

Llama a la función de la biblioteca estándar C grantpt().

Availability: Unix, not WASI.

Added in version 3.13.

os.isatty(fd, /)¶

Retorna True si el descriptor de archivo fd está abierto y conectado a un dispositivo tipo tty, de lo contrario, False.

os.lockf(fd, cmd, len, /)¶

Aplique, pruebe o elimine un bloqueo POSIX en un descriptor de archivo abierto. fd es un descriptor de archivo abierto. cmd especifica el comando a usar - uno de F_LOCK, F_TLOCK, F_ULOCK o F_TEST. len especifica la sección del archivo a bloquear.

Lanza un evento de auditoría os.lockf con argumentos fd, cmd, len.

Availability: Unix.

Added in version 3.3.

os.F_LOCK¶

os.F_TLOCK¶

os.F_ULOCK¶

os.F_TEST¶

Indicadores que especifican qué acción tomará lockf().

Availability: Unix.

Added in version 3.3.

os.login_tty(fd, /)¶

Prepare el tty del cual fd es un descriptor de archivo para una nueva sesión de inicio de sesión. Convierta el proceso de convocatoria en un líder de sesión; hacer que el tty sea el tty controlador, el stdin, el stdout y el stderr del proceso de llamada; cerrar fd.

Availability: Unix, not WASI.

Added in version 3.11.

os.lseek(fd, pos, whence, /)¶

Establece la posición actual del descriptor de archivo fd en la posición pos, modificada por whence, y devuelve la nueva posición en bytes con respecto al inicio del archivo. Los valores válidos para whence son:

• SEEK_SET o 0: establece pos en relación con el comienzo del archivo

• SEEK_CUR o 1: establece pos en relación con la posición actual del archivo

• SEEK_END o 2: establece pos en relación con el final del archivo

• SEEK_HOLE: establece pos en la siguiente ubicación de datos, relativa a pos

• SEEK_DATA: establece pos en el siguiente agujero de datos, relativo a pos

Distinto en la versión 3.3: Añadir soporte para SEEK_HOLE y SEEK_DATA.

os.SEEK_SET¶

os.SEEK_CUR¶

os.SEEK_END¶

Parámetros de la función lseek() y del método seek() en file-like objects, para desde donde ajustar el indicador de posición del archivo.

SEEK_SET

Ajuste la posición del archivo en relación con el comienzo del archivo.

SEEK_CUR

Ajuste la posición del archivo en relación con la posición del archivo actual.

SEEK_END

Ajuste la posición del archivo en relación con el final del archivo.

Sus valores son 0, 1 y 2, respectivamente.

os.SEEK_HOLE¶

os.SEEK_DATA¶

Parámetros de la función lseek() y del método seek() en file-like objects, para buscar datos de archivos y agujeros en archivos escasamente asignados.

SEEK_DATA

Ajuste el desplazamiento del archivo a la siguiente ubicación que contenga datos, en relación con la posición de búsqueda.

SEEK_HOLE

Ajuste el desplazamiento del archivo a la siguiente ubicación que contenga un agujero, en relación con la posición de búsqueda. Un agujero se define como una secuencia de ceros.

Nota

Estas operaciones sólo tienen sentido para los sistemas de archivos que las admiten.

Availability: Linux >= 3.1, macOS, Unix

Added in version 3.3.

os.open(path, flags, mode=0o777, *, dir_fd=None)¶

Abre el archivo path y configura varios indicadores según flags y su modo según mode. Al calcular el modo el valor actual de umask se enmascara primero. Retorna el descriptor de archivo para el archivo recién abierto. El nuevo descriptor de archivo es no heredable.

Para una descripción de los valores de indicadores (flags) y modo (mode), consulte la documentación de tiempo de ejecución de C; los indicadores constantes de flag (como O_RDONLY y O_WRONLY) se definen en el módulo os. En particular, en Windows agregar O_BINARY es necesario para abrir archivos en modo binario.

Esta función puede admitir rutas relativas a descriptores de directorio con el parámetro dir_fd.

Lanza un evento de auditoría open con argumentos path, mode, flags.

Distinto en la versión 3.4: El nuevo descriptor de archivo ahora es no heredable.

Nota

Esta función está diseñada para E/S de bajo nivel. Para un uso normal, use la función integrada open(), que retorna un file object con métodos read() y write() (y mucho mas). Para envolver un descriptor de archivo en un objeto de archivo, use fdopen().

Distinto en la versión 3.3: Se agregó el parámetro dir_fd.

Distinto en la versión 3.5: Si la llamada al sistema se interrumpe y el controlador de señal no genera una excepción, la función vuelve a intentar la llamada del sistema en lugar de generar una excepción InterruptedError (ver PEP 475 para la justificación).

Distinto en la versión 3.6: Acepta un objeto tipo ruta.

Las siguientes constantes son opciones para el parámetro flags de la función open(). Se pueden combinar con el operador OR a nivel de bit |. Algunos de ellas no están disponibles en todas las plataformas. Para obtener descripciones de su disponibilidad y uso, consulte la página de manual open(2) en Unix o la MSDN en Windows.

os.O_RDONLY¶

os.O_WRONLY¶

os.O_RDWR¶

os.O_APPEND¶

os.O_CREAT¶

os.O_EXCL¶

os.O_TRUNC¶

Las constantes anteriores están disponibles en Unix y Windows.

os.O_DSYNC¶

os.O_RSYNC¶

os.O_SYNC¶

os.O_NDELAY¶

os.O_NONBLOCK¶

os.O_NOCTTY¶

os.O_CLOEXEC¶

Las constantes anteriores sólo están disponibles en Unix.

Distinto en la versión 3.3: Se agregó la constante O_CLOEXEC.

os.O_BINARY¶

os.O_NOINHERIT¶

os.O_SHORT_LIVED¶

os.O_TEMPORARY¶

os.O_RANDOM¶

os.O_SEQUENTIAL¶

os.O_TEXT¶

Las constantes anteriores sólo están disponibles en Windows.

os.O_EVTONLY¶

os.O_FSYNC¶

os.O_SYMLINK¶

os.O_NOFOLLOW_ANY¶

Las constantes anteriores solo están disponibles en macOS.

Distinto en la versión 3.10: Agregue las constantes O_EVTONLY, O_FSYNC, O_SYMLINK y O_NOFOLLOW_ANY.

os.O_ASYNC¶

os.O_DIRECT¶

os.O_DIRECTORY¶

os.O_NOFOLLOW¶

os.O_NOATIME¶

os.O_PATH¶

os.O_TMPFILE¶

os.O_SHLOCK¶

os.O_EXLOCK¶

Las constantes anteriores son extensiones y no están presentes si no están definidas por la biblioteca de C.

Distinto en la versión 3.4: Se agrega la constante O_PATH en los sistemas que lo admiten. Se agrega O_TMPFILE, sólo disponible en Linux para el Kernel 3.11 o posterior.

os.openpty()¶

Abre un nuevo par de pseudo-terminal. Retorna un par de descriptores de archivo (master, slave); para pty y tty, respectivamente. Los nuevos descriptores de archivo son no heredable. Para un enfoque (ligeramente) más portátil, use el módulo pty.

Availability: Unix, not WASI.

Distinto en la versión 3.4: Los nuevos descriptores de archivo ahora son no heredables.

os.pipe()¶

Crea una tubería. Retorna un par de descriptores de archivo (r, w) que se pueden usar para leer y escribir, respectivamente. El nuevo descriptor de archivo es no heredable.

Availability: Unix, Windows.

Distinto en la versión 3.4: Los nuevos descriptores de archivo ahora son no heredables.

os.pipe2(flags, /)¶

Crea una tubería con flags establecidas atómicamente. flags pueden construirse juntando uno o más de estos valores: O_NONBLOCK, O_CLOEXEC con el operador OR. Retorna un par de descriptores de archivo (r, w) que se pueden usar para leer y escribir, respectivamente.

Availability: Unix, not WASI.

Added in version 3.3.

os.posix_fallocate(fd, offset, len, /)¶

Asegura que se asigne suficiente espacio en disco para el archivo especificado por fd a partir de offset y se extiende por len bytes.

Availability: Unix.

Added in version 3.3.

os.posix_fadvise(fd, offset, len, advice, /)¶

Avisa una intención de acceder a los datos en un patrón específico, permitiendo así que el núcleo haga optimizaciones. El consejo se aplica a la región del archivo especificada por fd que comienza en offset y se extiende para len bytes. advice es uno de POSIX_FADV_NORMAL, POSIX_FADV_SEQUENTIAL, POSIX_FADV_RANDOM, POSIX_FADV_NOREUSE, POSIX_FADV_WILLNEED o POSIX_FADV_DONTNEED.

Availability: Unix.

Added in version 3.3.

os.POSIX_FADV_NORMAL¶

os.POSIX_FADV_SEQUENTIAL¶

os.POSIX_FADV_RANDOM¶

os.POSIX_FADV_NOREUSE¶

os.POSIX_FADV_WILLNEED¶

os.POSIX_FADV_DONTNEED¶

Indicadores que se pueden usar en advice en posix_fadvise() que especifican el patrón de acceso que es probable que se use.

Availability: Unix.

Added in version 3.3.

os.pread(fd, n, offset, /)¶

Lee como máximo n bytes del descriptor de archivo fd en una posición de offset, sin modificar el desplazamiento (offset) del archivo.

Retorna una cadena de bytes que contiene los bytes leídos. Si se alcanza el final del archivo al que hace referencia fd, se retorna un objeto de bytes vacío.

Availability: Unix.

Added in version 3.3.

os.posix_openpt(oflag, /)¶

Abrir y devolver un descriptor de archivo para un dispositivo pseudo-terminal maestro.

Llama a la función de la biblioteca estándar de C posix_openpt(). El argumento oflag se utiliza para establecer indicadores de estado de archivo y modos de acceso a archivos, tal como se especifica en la página del manual de posix_openpt() de su sistema.

El descriptor de archivo devuelto es non-inheritable. Si el valor O_CLOEXEC está disponible en el sistema, se agrega a oflag.

Availability: Unix, not WASI.

Added in version 3.13.

os.preadv(fd, buffers, offset, flags=0, /)¶

Lee de un descriptor de archivo fd en una posición de offset en mutable objetos de tipo bytes buffers, dejando el desplazamiento del archivo sin cambios. Transfiere datos a cada búfer hasta que esté lleno y luego pase al siguiente búfer en la secuencia para contener el resto de los datos.

El argumento flags contiene un operador de bit a bit OR de cero o más de las siguientes flags:

• RWF_HIPRI

• RWF_NOWAIT

Retorna el número total de bytes realmente leídos que puede ser menor que la capacidad total de todos los objetos.

El sistema operativo puede establecer un límite (sysconf() valor 'SC_IOV_MAX') en el número de búferes que se pueden usar.

Combina la funcionalidad de os.readv() y os.pread().

Availability: Linux >= 2.6.30, FreeBSD >= 6.0, OpenBSD >= 2.7, AIX >= 7.1.

El uso de banderas requiere Linux >= 4.6.

Added in version 3.7.

os.RWF_NOWAIT¶

No espere datos que no estén disponibles de inmediato. Si se especifica este indicador, la llamada al sistema regresará instantáneamente si tuviera que leer datos del almacenamiento de respaldo o esperar por un bloqueo.

Si se leyeron correctamente algunos datos, devolverá la cantidad de bytes leídos. Si no se leyeron bytes, devolverá -1 y establecerá errno en errno.EAGAIN.

Availability: Linux >= 4.14.

Added in version 3.7.

os.RWF_HIPRI¶

Alta prioridad de lectura/escritura. Permite que los sistemas de archivos basados en bloques utilicen el sondeo del dispositivo, lo que proporciona una latencia más baja, pero puede usar recursos adicionales.

Actualmente, en Linux, esta función sólo se puede usar en un descriptor de archivo abierto con el indicador O_DIRECT.

Availability: Linux >= 4.6.

Added in version 3.7.

os.ptsname(fd, /)¶

Devuelve el nombre del dispositivo pseudoterminal esclavo asociado con el dispositivo pseudoterminal maestro al que hace referencia el descriptor de archivo fd. El descriptor de archivo fd no se cierra en caso de error.

Llama a la función de biblioteca estándar reentrante C ptsname_r() si está disponible; de ​​lo contrario, se llama a la función de biblioteca estándar C ptsname(), que no se garantiza que sea segura para subprocesos.

Availability: Unix, not WASI.

Added in version 3.13.

os.pwrite(fd, str, offset, /)¶

Escribe la cadena de bytes en str en el descriptor de archivo fd en la posición offset, sin modificar el desplazamiento del archivo.

Retorna el número de bytes realmente escritos.

Availability: Unix.

Added in version 3.3.

os.pwritev(fd, buffers, offset, flags=0, /)¶

Escribe el contenido de buffers en el descriptor de archivo fd en un desplazamiento offset, sin modificar el desplazamiento del archivo. buffers debe ser una secuencia de bytes-like objects. Los búferes se procesan en orden de matriz. Se escribe todo el contenido del primer búfer antes de pasar al segundo, y así sucesivamente.

El argumento flags contiene un operador de bit a bit OR de cero o más de las siguientes flags:

• RWF_DSYNC

• RWF_SYNC

• RWF_APPEND

Retorna el número total de bytes realmente escritos.

El sistema operativo puede establecer un límite (sysconf() valor 'SC_IOV_MAX') en el número de búferes que se pueden usar.

Combina la funcionalidad de os.writev() y os.pwrite().

Availability: Linux >= 2.6.30, FreeBSD >= 6.0, OpenBSD >= 2.7, AIX >= 7.1.

El uso de banderas requiere Linux >= 4.6.

Added in version 3.7.

os.RWF_DSYNC¶

Proporcione un equivalente por escritura del indicador O_DSYNC os.open(). Este efecto de bandera se aplica solo al rango de datos escrito por la llamada al sistema.

Availability: Linux >= 4.7.

Added in version 3.7.

os.RWF_SYNC¶

Proporcione un equivalente por escritura del indicador O_SYNC os.open(). Este efecto de bandera se aplica solo al rango de datos escrito por la llamada al sistema.

Availability: Linux >= 4.7.

Added in version 3.7.

os.RWF_APPEND¶

Proporcione un equivalente por escritura del indicador O_APPEND os.open(). Esta bandera es significativa solo para os.pwritev() y su efecto se aplica solo al rango de datos escrito por la llamada al sistema. El argumento offset no afecta la operación de escritura; los datos siempre se añaden al final del archivo. Sin embargo, si el argumento offset es -1, se actualiza el offset actual del archivo.

Availability: Linux >= 4.16.

Added in version 3.10.

os.read(fd, n, /)¶

Lee como máximo n bytes del descriptor de archivo fd.

Retorna una cadena de bytes que contiene los bytes leídos. Si se alcanza el final del archivo al que hace referencia fd, se retorna un objeto de bytes vacío.

Nota

Esta función está diseñada para E/S de bajo nivel y debe aplicarse a un descriptor de archivo tal como lo retorna os.open() o pipe(). Para leer un «objeto archivo» retornado por la función incorporada open() o por popen() o fdopen(), o sys.stdin, use los métodos read() o readline().

Distinto en la versión 3.5: Si la llamada al sistema se interrumpe y el controlador de señal no genera una excepción, la función vuelve a intentar la llamada del sistema en lugar de generar una excepción InterruptedError (ver PEP 475 para la justificación).

os.readinto(fd, buffer, /)¶

Read from a file descriptor fd into a mutable buffer object buffer.

The buffer should be mutable and bytes-like. On success, returns the number of bytes read. Less bytes may be read than the size of the buffer. The underlying system call will be retried when interrupted by a signal, unless the signal handler raises an exception. Other errors will not be retried and an error will be raised.

Returns 0 if fd is at end of file or if the provided buffer has length 0 (which can be used to check for errors without reading data). Never returns negative.

Nota

This function is intended for low-level I/O and must be applied to a file descriptor as returned by os.open() or os.pipe(). To read a «file object» returned by the built-in function open(), or sys.stdin, use its member functions, for example io.BufferedIOBase.readinto(), io.BufferedIOBase.read(), or io.TextIOBase.read()

Added in version 3.14.

os.sendfile(out_fd, in_fd, offset, count)¶

os.sendfile(out_fd, in_fd, offset, count, headers=(), trailers=(), flags=0)

Copia count bytes del descriptor de archivo in_fd al descriptor de archivo out_fd comenzando en offset. Retorna el número de bytes enviados. Cuando se alcanza EOF, retorna 0.

La primera notación de la función es compatible con todas las plataformas que definen sendfile().

En Linux, si offset se entrega como None, los bytes se leen desde la posición actual de in_fd y la posición de in_fd se actualiza.

El segundo caso se puede usar en macOS y FreeBSD donde headers y trailers son secuencias arbitrarias de búferes que se escriben antes y después de que se escriban los datos de in_fd. Retorna lo mismo que el primer caso.

En macOS y FreeBSD, un valor de 0 para count especifica enviar hasta que se alcanza el final de in_fd.

Todas las plataformas admiten sockets como descriptor de archivo out_fd, y algunas plataformas también permiten otros tipos (por ejemplo, archivo regular, tuberías).

Las aplicaciones multiplataforma no deben usar los argumentos headers, trailers y flags.

Availability: Unix, not WASI.

Nota

Para un contenedor de alto nivel de sendfile(), vea socket.socket.sendfile().

Added in version 3.3.

Distinto en la versión 3.9: Parámetros out e in han sido renombrados a out_fd e in_fd.

os.SF_NODISKIO¶

os.SF_MNOWAIT¶

os.SF_SYNC¶

Parámetros para la función sendfile(), si la implementación los admite.

Availability: Unix, not WASI.

Added in version 3.3.

os.SF_NOCACHE¶

Parámetro a la función sendfile(), si la implementación lo admite. Los datos no se almacenarán en caché en la memoria virtual y se liberarán después.

Availability: Unix, not WASI.

Added in version 3.11.

os.set_blocking(fd, blocking, /)¶

Establece el modo de bloqueo del descriptor de archivo especificado. Establece la flag O_NONBLOCK si se quiere que el bloqueo sea False, borre la flag de lo contrario.

Consulte también get_blocking() y socket.socket.setblocking().

Availability: Unix, Windows.

La función está limitada en WASI, consulte Plataformas WebAssembly para obtener más información.

En Windows, esta función está limitada a las tuberías.

Added in version 3.5.

Distinto en la versión 3.12: Se agregó soporte para pipes en Windows.

os.splice(src, dst, count, offset_src=None, offset_dst=None, flags=0)¶

Transfer count bytes from file descriptor src, starting from offset offset_src, to file descriptor dst, starting from offset offset_dst.

The splicing behaviour can be modified by specifying a flags value. Any of the following variables may used, combined using bitwise OR (the | operator):

• If SPLICE_F_MOVE is specified, the kernel is asked to move pages instead of copying, but pages may still be copied if the kernel cannot move the pages from the pipe.

• If SPLICE_F_NONBLOCK is specified, the kernel is asked to not block on I/O. This makes the splice pipe operations nonblocking, but splice may nevertheless block because the spliced file descriptors may block.

• If SPLICE_F_MORE is specified, it hints to the kernel that more data will be coming in a subsequent splice.

At least one of the file descriptors must refer to a pipe. If offset_src is None, then src is read from the current position; respectively for offset_dst. The offset associated to the file descriptor that refers to a pipe must be None. The files pointed to by src and dst must reside in the same filesystem, otherwise an OSError is raised with errno set to errno.EXDEV.

Esta copia se realiza sin el costo adicional de transferir datos desde el kernel al espacio del usuario y luego nuevamente al kernel. También, algunos sistemas de archivos podrían implementar optimizaciones adicionales. La copia se realiza como si ambos archivos se abrieran como binarios.

Una vez completado con éxito, retorna el número de bytes empalmados hacia o desde la tubería. Un valor de retorno de 0 significa el final de la entrada. Si src se refiere a una tubería, esto significa que no hay datos para transferir y no tendría sentido bloquear porque no hay escritores conectados al extremo de escritura de la tubería.

Ver también

The splice(2) man page.

Availability: Linux >= 2.6.17 with glibc >= 2.5

Added in version 3.10.

os.SPLICE_F_MOVE¶

os.SPLICE_F_NONBLOCK¶

os.SPLICE_F_MORE¶

Added in version 3.10.

os.readv(fd, buffers, /)¶

Leer desde un descriptor de archivo fd en una cantidad de mutable objetos tipo bytes buffers. Transfiere datos a cada búfer hasta que esté lleno y luego pase al siguiente búfer en la secuencia para contener el resto de los datos.

Retorna el número total de bytes realmente leídos que puede ser menor que la capacidad total de todos los objetos.

El sistema operativo puede establecer un límite (sysconf() valor 'SC_IOV_MAX') en el número de búferes que se pueden usar.

Availability: Unix.

Added in version 3.3.

os.tcgetpgrp(fd, /)¶

Retorna el grupo del proceso asociado con la terminal proporcionada por fd (un descriptor de archivo abierto como lo retorna os.open()).

Availability: Unix, not WASI.

os.tcsetpgrp(fd, pg, /)¶

Establece el grupo del proceso asociado con la terminal dada por fd (un descriptor de archivo abierto como lo retorna os.open()) a pg.

Availability: Unix, not WASI.

os.ttyname(fd, /)¶

Retorna una cadena que especifica el dispositivo de terminal asociado con el descriptor de archivo fd. Si fd no está asociado con un dispositivo de terminal, se genera una excepción.

Availability: Unix.

os.unlockpt(fd, /)¶

Desbloquee el dispositivo pseudoterminal esclavo asociado con el dispositivo pseudoterminal maestro al que hace referencia el descriptor de archivo fd. El descriptor de archivo fd no se cierra en caso de falla.

Llama a la función de la biblioteca estándar C unlockpt().

Availability: Unix, not WASI.

Added in version 3.13.

os.write(fd, str, /)¶

Escribe la cadena de bytes en str en el descriptor de archivo fd.

Retorna el número de bytes realmente escritos.

Nota

Esta función está diseñada para E/S de bajo nivel y debe aplicarse a un descriptor de archivo tal como lo retorna os.open() o pipe(). Para escribir un «objeto archivo» retornado por la función incorporada open() o por popen() o fdopen(), o sys.stdout o sys.stderr, use el método write().

Distinto en la versión 3.5: Si la llamada al sistema se interrumpe y el controlador de señal no genera una excepción, la función vuelve a intentar la llamada del sistema en lugar de generar una excepción InterruptedError (ver PEP 475 para la justificación).

os.writev(fd, buffers, /)¶

Escribe el contenido de buffers en el descriptor de archivo fd. buffers debe ser una secuencia de objetos tipo bytes. Los búferes se procesan en orden secuencial. Se escribe todo el contenido del primer búfer antes de pasar al segundo, y así sucesivamente.

Retorna el número total de bytes realmente escritos.

El sistema operativo puede establecer un límite (sysconf() valor 'SC_IOV_MAX') en el número de búferes que se pueden usar.

Availability: Unix.

Added in version 3.3.

Archivos y directorios¶

En algunas plataformas Unix, muchas de estas funciones admiten una o más de estas características:

• specifying a file descriptor: Normally the path argument provided to functions in the os module must be a string specifying a file path. However, some functions now alternatively accept an open file descriptor for their path argument. The function will then operate on the file referred to by the descriptor. For POSIX systems, Python will call the variant of the function prefixed with f (e.g. call fchdir instead of chdir).

  Puede verificar si path se puede especificar o no como un descriptor de archivo para una función particular en su plataforma usando os.supports_fd. Si esta funcionalidad no está disponible, su uso lanzará un NotImplementedError.

  Si la función también admite argumentos dir_fd o follow_symlinks, es un error especificar uno de esos al suministrar path como descriptor de archivo.

• paths relative to directory descriptors: If dir_fd is not None, it should be a file descriptor referring to a directory, and the path to operate on should be relative; path will then be relative to that directory. If the path is absolute, dir_fd is ignored. For POSIX systems, Python will call the variant of the function with an at suffix and possibly prefixed with f (e.g. call faccessat instead of access).

  Puede verificar si dir_fd es compatible o no para una función particular en su plataforma usando os.supports_dir_fd. Si no está disponible, usarlo lanzará un NotImplementedError.

• not following symlinks: If follow_symlinks is False, and the last element of the path to operate on is a symbolic link, the function will operate on the symbolic link itself rather than the file pointed to by the link. For POSIX systems, Python will call the l... variant of the function.

  Puede verificar si follow_symlinks es compatible o no para una función particular en su plataforma usando os.supports_follow_symlinks. Si no está disponible, usarlo lanzará un NotImplementedError.

os.access(path, mode, *, dir_fd=None, effective_ids=False, follow_symlinks=True)¶

Use el uid/gid real para probar el acceso a path. Tenga en cuenta que la mayoría de las operaciones utilizarán el uid/gid efectivo, por lo tanto, esta rutina se puede usar en un entorno suid/sgid para probar si el usuario que invoca tiene el acceso especificado a path. mode debería ser F_OK para probar la existencia de path, o puede ser el OR inclusivo de uno o más de R_OK, W_OK, y X_OK para probar los permisos. Retorna True si el acceso está permitido, False si no. Consulte la página de manual de Unix access (2) para obtener más información.

Esta función puede admitir la especificación rutas relativas a descriptores de directorio y no seguir los enlaces simbólicos.

Si effective_ids es True, access() realizará sus comprobaciones de acceso utilizando el uid/gid efectivo en lugar del uid/gid real. effective_ids puede no ser compatible con su plataforma; puede verificar si está disponible o no usando os.supports_effective_ids. Si no está disponible, usarlo lanzará un NotImplementedError.

Nota

Usando access() para verificar si un usuario está autorizado para, por ejemplo, abrir un archivo antes de hacerlo usando open() crea un agujero de seguridad, porque el usuario podría explotar el breve intervalo de tiempo entre verificar y abrir el archivo para manipularlo es preferible utilizar técnicas EAFP. Por ejemplo:

if os.access("myfile", os.R_OK):
    with open("myfile") as fp:
        return fp.read()
return "some default data"

está mejor escrito como:

try:
    fp = open("myfile")
except PermissionError:
    return "some default data"
else:
    with fp:
        return fp.read()

Nota

Las operaciones de E/S pueden fallar incluso cuando access() indica que tendrán éxito, particularmente para operaciones en sistemas de archivos de red que pueden tener una semántica de permisos más allá del modelo habitual de bits de permiso POSIX.

Distinto en la versión 3.3: Se agregaron los parámetros dir_fd, effective_ids y follow_symlinks.

Distinto en la versión 3.6: Acepta un objeto tipo ruta.

os.F_OK¶

os.R_OK¶

os.W_OK¶

os.X_OK¶

Valores para pasar como parámetro mode de access() para probar la existencia, legibilidad, escritura y ejecutabilidad de path, respectivamente.

os.chdir(path)¶

Cambia el directorio de trabajo actual a path.

Esta función puede soportar especificando un descriptor de archivo. El descriptor debe hacer referencia a un directorio abierto, no a un archivo abierto.

Esta función puede generar OSError y subclases como FileNotFoundError, PermissionError, y NotADirectoryError.

Lanza un evento de auditoría os.chdir con argumento path.

Distinto en la versión 3.3: Se agregó soporte para especificar path como descriptor de archivo en algunas plataformas.

Distinto en la versión 3.6: Acepta un objeto tipo ruta.

os.chflags(path, flags, *, follow_symlinks=True)¶

Establece las flags del path a las flags numéricas. flags puede tomar una combinación (OR bit a bit) de los siguientes valores (como se define en el módulo stat):

• stat.UF_NODUMP

• stat.UF_IMMUTABLE

• stat.UF_APPEND

• stat.UF_OPAQUE

• stat.UF_NOUNLINK

• stat.UF_COMPRESSED

• stat.UF_HIDDEN

• stat.SF_ARCHIVED

• stat.SF_IMMUTABLE

• stat.SF_APPEND

• stat.SF_NOUNLINK

• stat.SF_SNAPSHOT

Esta función puede soportar no seguir enlaces simbólicos.

Lanza un evento de auditoría os.chflags con argumentos path, flags.

Availability: Unix, not WASI.

Distinto en la versión 3.3: Se agregó el argumento follow_symlinks.

Distinto en la versión 3.6: Acepta un objeto tipo ruta.

os.chmod(path, mode, *, dir_fd=None, follow_symlinks=True)¶

Cambia el modo de path al modo numérico mode. mode puede tomar uno de los siguientes valores (como se define en el módulo stat) o combinaciones OR de bit a bit de ellos:

• stat.S_ISUID

• stat.S_ISGID

• stat.S_ENFMT

• stat.S_ISVTX

• stat.S_IREAD

• stat.S_IWRITE

• stat.S_IEXEC

• stat.S_IRWXU

• stat.S_IRUSR

• stat.S_IWUSR

• stat.S_IXUSR

• stat.S_IRWXG

• stat.S_IRGRP

• stat.S_IWGRP

• stat.S_IXGRP

• stat.S_IRWXO

• stat.S_IROTH

• stat.S_IWOTH

• stat.S_IXOTH

Esta función puede soportar especificando un descriptor de archivo, rutas relativas a los descriptores de directorio y no seguir enlaces simbólicos.

Nota

Aunque Windows admite chmod(), solo se puede configurar el indicador de solo lectura del archivo con él (a través de las constantes stat.S_IWRITE y stat.S_IREAD o un valor entero correspondiente). Se ignoran todos los demás bits. El valor predeterminado de follow_symlinks es False en Windows.

La función está limitada en WASI, consulte Plataformas WebAssembly para obtener más información.

Lanza un evento de auditoría os.chmod con argumentos path, mode, dir_fd.

Distinto en la versión 3.3: Se agregó soporte para especificar path como un descriptor de archivo abierto, y los argumentos dir_fd y follow_symlinks.

Distinto en la versión 3.6: Acepta un objeto tipo ruta.

Distinto en la versión 3.13: Se agregó soporte para un descriptor de archivo y el argumento follow_symlinks en Windows.

os.chown(path, uid, gid, *, dir_fd=None, follow_symlinks=True)¶

Cambia el propietario y el id del grupo de path a los numéricos uid y gid. Para dejar uno de los identificadores sin cambios, configúrelo en -1.

Esta función puede soportar especificando un descriptor de archivo, rutas relativas a los descriptores de directorio y no seguir enlaces simbólicos.

Ver shutil.chown() para una función de nivel superior que acepta nombres además de identificadores numéricos.

Lanza un evento de auditoría os.chown con argumentos path, uid, gid, dir_fd.

Availability: Unix.

La función está limitada en WASI, consulte Plataformas WebAssembly para obtener más información.

Distinto en la versión 3.3: Se agregó soporte para especificar path como un descriptor de archivo abierto, y los argumentos dir_fd y follow_symlinks.

Distinto en la versión 3.6: Admite un objeto tipo ruta.

os.chroot(path)¶

Cambia el directorio raíz del proceso actual a path.

Availability: Unix, not WASI, not Android.

Distinto en la versión 3.6: Acepta un objeto tipo ruta.

os.fchdir(fd)¶

Cambia el directorio de trabajo actual al directorio representado por el descriptor de archivo fd. El descriptor debe hacer referencia a un directorio abierto, no a un archivo abierto. A partir de Python 3.3, esto es equivalente a os.chdir(fd).

Lanza un evento de auditoría os.chdir con argumento path.

Availability: Unix.

os.getcwd()¶

Retorna una cadena que representa el directorio de trabajo actual.

os.getcwdb()¶

Retorna una cadena de bytes que representa el directorio de trabajo actual.

Distinto en la versión 3.8: La función ahora usa la codificación UTF-8 en Windows, en lugar de los códigos ANSI: consulte PEP 529 para ver la justificación. La función ya no está en desuso en Windows.

os.lchflags(path, flags)¶

Establece las flags de path a las flags numéricas, como chflags(), pero no siga los enlaces simbólicos. A partir de Python 3.3, esto es equivalente a os.chflags(path, flags, follow_symlinks=False).

Lanza un evento de auditoría os.chflags con argumentos path, flags.

Availability: Unix, not WASI.

Distinto en la versión 3.6: Acepta un objeto tipo ruta.

os.lchmod(path, mode)¶

Cambia el modo de path al mode numérico. Si la ruta es un enlace simbólico, esto afecta al enlace simbólico en lugar del objetivo. Consulte los documentos para chmod() para conocer los posibles valores de mode. A partir de Python 3.3, esto es equivalente a os.chmod(path, mode, follow_symlinks=False).

lchmod() no es parte de POSIX, pero las implementaciones de Unix pueden tenerlo si se admite el cambio del modo de enlaces simbólicos.

Lanza un evento de auditoría os.chmod con argumentos path, mode, dir_fd.

Availability: Unix, Windows, not Linux, FreeBSD >= 1.3, NetBSD >= 1.3, not OpenBSD

Distinto en la versión 3.6: Acepta un objeto tipo ruta.

Distinto en la versión 3.13: Se agregó soporte en Windows.

os.lchown(path, uid, gid)¶

Cambia el propietario y la identificación del grupo de path a los numéricos uid y gid. Esta función no seguirá enlaces simbólicos. A partir de Python 3.3, esto es equivalente a os.chown(path, uid, gid, follow_symlinks=False).

Lanza un evento de auditoría os.chown con argumentos path, uid, gid, dir_fd.

Availability: Unix.

Distinto en la versión 3.6: Acepta un objeto tipo ruta.

os.link(src, dst, *, src_dir_fd=None, dst_dir_fd=None, follow_symlinks=True)¶

Cree un enlace rígido que apunte a src llamado dst.

This function can support specifying src_dir_fd and/or dst_dir_fd to supply paths relative to directory descriptors, and not following symlinks. The default value of follow_symlinks is False on Windows.

Lanza un evento de auditoría os.link con argumentos src, dst, src_dir_fd, dst_dir_fd.

Availability: Unix, Windows.

Distinto en la versión 3.2: Se agregó soporte para Windows.

Distinto en la versión 3.3: Se agregaron los parámetros src_dir_fd, dst_dir_fd y follow_symlinks.

Distinto en la versión 3.6: Acepta un path-like object para src y dst.

os.listdir(path='.')¶

Retorna una lista que contiene los nombres de las entradas en el directorio dado por path. La lista está en un orden arbitrario y no incluye las entradas especiales '.' Y '..' incluso si están presentes en el directorio. Si un archivo es removido de o añadido al directorio mientras se llama a esta función, no se especifica si el nombre para el archivo será incluido.

path puede ser un path-like object. Si path es de tipo bytes (directa o indirectamente a través de la interfaz PathLike), los nombres de archivo retornados también serán de tipo bytes; en todas las demás circunstancias, serán del tipo str.

Esta función también puede admitir especificando un descriptor de archivo; el descriptor de archivo debe hacer referencia a un directorio.

Lanza un evento de auditoría os.listdir con el argumento ruta.

Nota

Para codificar los nombres de archivo str en bytes, use fsencode().

Ver también

La función scandir() retorna entradas de directorio junto con información de atributos de archivo, lo que proporciona un mejor rendimiento para muchos casos de uso comunes.

Distinto en la versión 3.2: El parámetro path se convirtió en opcional.

Distinto en la versión 3.3: Se agregó soporte para especificar path como un descriptor de archivo abierto.

Distinto en la versión 3.6: Acepta un objeto tipo ruta.

os.listdrives()¶

Devuelve una lista que contiene los nombres de las unidades en un sistema Windows.

El nombre de una unidad suele ser 'C:\\'. No todos los nombres de unidades se asociarán a un volumen y es posible que algunas sean inaccesibles por diversos motivos, incluidos permisos, conectividad de red o medios faltantes. Esta función no prueba el acceso.

Puede generar OSError si ocurre un error al recopilar los nombres de las unidades.

Genera un auditing event os.listdrives sin argumentos.

Availability: Windows

Added in version 3.12.

os.listmounts(volume)¶

Devuelve una lista que contiene los puntos de montaje de un volumen en un sistema Windows.

volume debe representarse como una ruta GUID, como las que devuelve os.listvolumes(). Los volúmenes pueden montarse en varias ubicaciones o no montarse en ninguna. En este último caso, la lista estará vacía. Esta función no devolverá los puntos de montaje que no estén asociados a un volumen.

Los puntos de montaje devueltos por esta función serán rutas absolutas y pueden ser más largos que el nombre de la unidad.

Genera OSError si no se reconoce el volumen o si se produce un error al recopilar las rutas.

Genera un auditing event os.listmounts con el argumento volume.

Availability: Windows

Added in version 3.12.

os.listvolumes()¶

Devuelve una lista que contiene los volúmenes del sistema.

Los volúmenes se representan normalmente como una ruta GUID similar a \\?\Volume{xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}\. Normalmente, se puede acceder a los archivos a través de una ruta GUID, si los permisos lo permiten. Sin embargo, los usuarios no suelen estar familiarizados con ellos, por lo que el uso recomendado de esta función es recuperar los puntos de montaje mediante os.listmounts().

Puede generar OSError si ocurre un error al recopilar los volúmenes.

Genera un auditing event os.listvolumes sin argumentos.

Availability: Windows

Added in version 3.12.

os.lstat(path, *, dir_fd=None)¶

Realiza el equivalente de una llamada al sistema lstat() en la ruta indicada. Similar a stat(), pero no sigue enlaces simbólicos. Devuelve un objeto stat_result.

En plataformas que no admiten enlaces simbólicos, este es un alias para stat().

A partir de Python 3.3, esto es equivalente a os.stat(path, dir_fd=dir_fd, follow_symlinks=False).

Esta función también puede admitir rutas relativas a descriptores de directorio.

Ver también

La función stat().

Distinto en la versión 3.2: Se agregó soporte para enlaces simbólicos de Windows 6.0 (Vista).

Distinto en la versión 3.3: Se agregó el parámetro dir_fd.

Distinto en la versión 3.6: Acepta un objeto tipo ruta.

Distinto en la versión 3.8: En Windows, ahora abre puntos de análisis que representan otra ruta (nombres sustitutos), incluidos enlaces simbólicos y uniones de directorio. El sistema operativo resuelve otros tipos de puntos de análisis como stat().

os.mkdir(path, mode=0o777, *, dir_fd=None)¶

Cree un directorio llamado path con modo numérico mode.

Si el directorio ya existe, se genera FileExistsError. Si no existe un directorio principal en la ruta, se genera FileNotFoundError.

En algunos sistemas, mode se ignora. Donde se usa, el valor actual de umask se enmascara primero. Si se establecen bits distintos de los últimos 9 (es decir, los últimos 3 dígitos de la representación octal del mode), su significado depende de la plataforma. En algunas plataformas, se ignoran y debe llamar a chmod() explícitamente para configurarlos.

En Windows, se maneja específicamente un mode o 0o700 para aplicar el control de acceso al nuevo directorio de modo que solo el usuario actual y los administradores tengan acceso. Se ignoran otros valores de mode.

Esta función también puede admitir rutas relativas a descriptores de directorio.

También es posible crear directorios temporales; vea la función tempfile del módulo tempfile.mkdtemp().

Lanza un evento de auditoría os.mkdir con argumentos ruta, modo, dir_fd.

Distinto en la versión 3.3: Se agregó el parámetro dir_fd.

Distinto en la versión 3.6: Acepta un objeto tipo ruta.

Distinto en la versión 3.13: Windows ahora maneja un mode o 0o700.

os.makedirs(name, mode=0o777, exist_ok=False)¶

Función de creación de directorio recursiva. Como mkdir(), pero hace que todos los directorios de nivel intermedio sean necesarios para contener el directorio hoja.

El parámetro mode se pasa a mkdir() para crear el directorio hoja; consulte the mkdir() description para saber cómo se interpreta. Para configurar los bits de permiso de archivo de cualquier directorio principal recién creado, puede configurar umask antes de invocar makedirs(). Los bits de permiso de archivo de los directorios principales existentes no se modifican.

Si exist_ok es False (el valor predeterminado), se genera un FileExistsError si el directorio de destino ya existe.

Nota

makedirs() se confundirá si los elementos de ruta a crear incluyen pardir (por ejemplo, «..» en sistemas UNIX).

Esta función maneja las rutas UNC correctamente.

Lanza un evento de auditoría os.mkdir con argumentos ruta, modo, dir_fd.

Distinto en la versión 3.2: Se agregó el parámetro exist_ok.

Distinto en la versión 3.4.1: Antes de Python 3.4.1, si exist_ok era True y el directorio existía, makedirs() aún generaría un error si mode no coincidía con el modo del directorio existente. Como este comportamiento era imposible de implementar de forma segura, se eliminó en Python 3.4.1. Ver bpo-21082.

Distinto en la versión 3.6: Acepta un objeto tipo ruta.

Distinto en la versión 3.7: El argumento mode ya no afecta los bits de permiso de archivo de los directorios de nivel intermedio recién creados.

os.mkfifo(path, mode=0o666, *, dir_fd=None)¶

Cree una FIFO (una tubería con nombre) llamada path con modo numérico modo. El valor actual de umask se enmascara primero del modo.

Esta función también puede admitir rutas relativas a descriptores de directorio.

Los FIFO son tuberías a las que se puede acceder como archivos normales. Los FIFO existen hasta que se eliminan (por ejemplo con os.unlink()). En general, los FIFO se utilizan como punto de encuentro entre los procesos de tipo «cliente» y «servidor»: el servidor abre el FIFO para leer y el cliente lo abre para escribir. Tenga en cuenta que mkfifo() no abre el FIFO — solo crea el punto de encuentro.

Availability: Unix, not WASI.

Distinto en la versión 3.3: Se agregó el parámetro dir_fd.

Distinto en la versión 3.6: Acepta un objeto tipo ruta.

os.mknod(path, mode=0o600, device=0, *, dir_fd=None)¶

Cree un nodo del sistema de archivos (archivo, archivo especial del dispositivo o canalización con nombre) llamado path. mode especifica tanto los permisos para usar como el tipo de nodo que se creará, combinándose (OR bit a bit) con uno de stat.S_IFREG, stat.S_IFCHR, stat.S_IFBLK , y stat.S_IFIFO (esas constantes están disponibles en stat). Para stat.S_IFCHR y stat.S_IFBLK, device define el archivo especial del dispositivo recién creado (probablemente usando os.makedev()), de lo contrario se ignora.

Esta función también puede admitir rutas relativas a descriptores de directorio.

Availability: Unix, not WASI.

Distinto en la versión 3.3: Se agregó el parámetro dir_fd.

Distinto en la versión 3.6: Acepta un objeto tipo ruta.

os.major(device, /)¶

Extrae el número principal del dispositivo de un número de dispositivo sin procesar (generalmente el campo st_dev o st_rdev de stat).

os.minor(device, /)¶

Extrae el número menor del dispositivo de un número de dispositivo sin procesar (generalmente el campo st_dev o st_rdev de stat).

os.makedev(major, minor, /)¶

Compone un número de dispositivo sin procesar a partir de los números de dispositivo mayor y menor.

os.pathconf(path, name)¶

Retorna información de configuración del sistema relevante para un archivo con nombre. name especifica el valor de configuración para recuperar; puede ser una cadena que es el nombre de un valor de sistema definido; Estos nombres se especifican en varios estándares (POSIX.1, Unix 95, Unix 98 y otros). Algunas plataformas también definen nombres adicionales. Los nombres conocidos por el sistema operativo host se dan en el diccionario pathconf_names. Para las variables de configuración no incluidas en esa asignación, también se acepta pasar un número entero para name.

Si name es una cadena y no se conoce, se lanza un ValueError. Si el sistema anfitrión no admite un valor específico para name, incluso si está incluido en pathconf_names, se genera un OSError con errno.EINVAL para el número de error.

Esta función puede soportar especificando un descriptor de archivo.

Availability: Unix.

Distinto en la versión 3.6: Acepta un objeto tipo ruta.

os.pathconf_names¶

Nombres de mapeo de diccionario aceptados por pathconf() y fpathconf() a los valores enteros definidos para esos nombres por el sistema operativo host. Esto se puede usar para determinar el conjunto de nombres conocidos por el sistema.

Availability: Unix.

os.readlink(path, *, dir_fd=None)¶

Retorna una cadena que representa la ruta a la que apunta el enlace simbólico. El resultado puede ser un nombre de ruta absoluto o relativo; si es relativo, se puede convertir a un nombre de ruta absoluto usando os.path.join(os.path.dirname(path), result).

Si la path es un objeto de cadena (directa o indirectamente a través de una interfaz PathLike), el resultado también será un objeto de cadena y la llamada puede generar un UnicodeDecodeError. Si la path es un objeto de bytes (directa o indirectamente), el resultado será un objeto de bytes.

Esta función también puede admitir rutas relativas a descriptores de directorio.

Cuando intente resolver una ruta que puede contener enlaces, use realpath() para manejar adecuadamente la recurrencia y las diferencias de plataforma.

Availability: Unix, Windows.

Distinto en la versión 3.2: Se agregó soporte para enlaces simbólicos de Windows 6.0 (Vista).

Distinto en la versión 3.3: Se agregó el parámetro dir_fd.

Distinto en la versión 3.6: Acepta un path-like object en Unix.

Distinto en la versión 3.8: Acepta un path-like object y un objeto de bytes en Windows.

Se agregó soporte para uniones de directorio y se modificó para retornar la ruta de sustitución (que generalmente incluye el prefijo \\?\) En lugar del campo opcional «nombre de impresión» que se retornó anteriormente.

os.remove(path, *, dir_fd=None)¶

Eliminar (borrar) el archivo path. Si path es un directorio, se genera un error OSError. Utilice rmdir() para eliminar directorios. Si el archivo no existe, se genera un error FileNotFoundError.

Esta función puede admitir rutas relativas a descriptores de directorio.

En Windows, intentar eliminar un archivo que está en uso provoca una excepción; en Unix, la entrada del directorio se elimina pero el almacenamiento asignado al archivo no está disponible hasta que el archivo original ya no esté en uso.

Esta función es semánticamente idéntica a unlink().

Lanza un evento de auditoría os.remove con argumentos ruta, dir_fd.

Distinto en la versión 3.3: Se agregó el parámetro dir_fd.

Distinto en la versión 3.6: Acepta un objeto tipo ruta.

os.removedirs(name)¶

Eliminar directorios de forma recursiva. Funciona como rmdir() excepto que, si el directorio hoja se elimina con éxito, removeirs() intenta eliminar sucesivamente cada directorio principal mencionado en path hasta que se genere un error (que se ignora, porque generalmente significa que un directorio padre no está vacío). Por ejemplo, os.removedirs('foo/bar/baz') primero eliminará el directorio 'foo/bar/baz', y luego eliminará 'foo/bar' y 'foo' si están vacíos. Genera OSError si el directorio hoja no se pudo eliminar con éxito.

Lanza un evento de auditoría os.remove con argumentos ruta, dir_fd.

Distinto en la versión 3.6: Acepta un objeto tipo ruta.

os.rename(src, dst, *, src_dir_fd=None, dst_dir_fd=None)¶

Cambia el nombre del archivo o directorio src a dst. Si dst existe, la operación fallará con una subclase OSError en varios casos:

En Windows, si existe dst, siempre se genera un FileExistsError. La operación puede fallar si src y dst están en sistemas de archivos diferentes. Utilice shutil.move() para admitir movimientos a un sistema de archivos diferente.

En Unix, si src es un archivo y dst es un directorio o viceversa, se generará un IsADirectoryError o un NotADirectoryError respectivamente. Si ambos son directorios y dst está vacío, dst se reemplazará silenciosamente. Si dst no es un directorio vacío, se genera un OSError. Si ambos son archivos, dst se reemplazará silenciosamente si el usuario tiene permiso. La operación puede fallar en algunos tipos de Unix si src y dst están en sistemas de archivos diferentes. Si tiene éxito, el cambio de nombre será una operación atómica (este es un requisito POSIX).

Esta función puede admitir la especificación de src_dir_fd o dst_dir_fd para proporcionar rutas relativas a los descriptores de directorio.

Si desea sobrescribir multiplataforma del destino, use replace().

Lanza un evento de auditoría os.rename con argumentos src, dst, src_dir_fd, dst_dir_fd.

Distinto en la versión 3.3: Se agregaron los parámetros src_dir_fd y dst_dir_fd.

Distinto en la versión 3.6: Acepta un path-like object para src y dst.

os.renames(old, new)¶

Directorio recursivo o función de cambio de nombre de archivo. Funciona como rename(), excepto que primero se intenta crear cualquier directorio intermedio necesario para que el nuevo nombre de ruta sea bueno. Después del cambio de nombre, los directorios correspondientes a los segmentos de ruta más a la derecha del nombre anterior se eliminarán usando removeirs().

Nota

Esta función puede fallar con la nueva estructura de directorios realizada si carece de los permisos necesarios para eliminar el directorio o archivo hoja.

Lanza un evento de auditoría os.rename con argumentos src, dst, src_dir_fd, dst_dir_fd.

Distinto en la versión 3.6: Acepta un path-like object para old y new.

os.replace(src, dst, *, src_dir_fd=None, dst_dir_fd=None)¶

Cambie el nombre del archivo o directorio src a dst. Si dst no es un directorio vacío, se generará OSError. Si dst existe y es un archivo, se reemplazará de forma silenciosa si el usuario tiene permiso. La operación puede fallar si src y dst están en sistemas de archivos diferentes. Si tiene éxito, el cambio de nombre será una operación atómica (este es un requisito POSIX).

Esta función puede admitir la especificación de src_dir_fd o dst_dir_fd para proporcionar rutas relativas a los descriptores de directorio.

Lanza un evento de auditoría os.rename con argumentos src, dst, src_dir_fd, dst_dir_fd.

Added in version 3.3.

Distinto en la versión 3.6: Acepta un path-like object para src y dst.

os.rmdir(path, *, dir_fd=None)¶

Suprime (elimina) el directorio path. Si el directorio no existe o no está vacío, se genera un FileNotFoundError o un OSError respectivamente. Para eliminar árboles de directorios completos, se puede utilizar shutil.rmtree().

Esta función puede admitir rutas relativas a descriptores de directorio.

Lanza un evento de auditoría os.rmdir con argumentos ruta, dir_fd.

Distinto en la versión 3.3: Se agregó el parámetro dir_fd.

Distinto en la versión 3.6: Acepta un objeto tipo ruta.

os.scandir(path='.')¶

Retorna un iterador de objetos os.DirEntry correspondientes a las entradas en el directorio dado por path. Las entradas se entregan en orden arbitrario, y las entradas especiales '.' Y '..' no están incluidas. Si un archivo es removido de o añadido al directorio después de crear el iterador, no se especifica si una entrada para el archivo será incluido.

El uso de scandir() en lugar de listdir() puede aumentar significativamente el rendimiento del código que también necesita información de tipo de archivo o atributo de archivo, porque: los objetos os.DirEntry exponen esta información si el sistema operativo proporciona cuando escanea un directorio. Todos los métodos os.DirEntry pueden realizar una llamada al sistema, pero is_dir() y is_file() generalmente solo requieren una llamada al sistema para enlaces simbólicos; os.DirEntry.stat() siempre requiere una llamada al sistema en Unix, pero solo requiere una para enlaces simbólicos en Windows.

path puede ser un path-like object. Si path es de tipo bytes (directa o indirectamente a través de la interfaz PathLike), el tipo de name y los atributos path de cada os.DirEntry serán bytes; en todas las demás circunstancias, serán del tipo str.

Esta función también puede admitir especificando un descriptor de archivo; el descriptor de archivo debe hacer referencia a un directorio.

Lanza un evento de auditoría os.scandir con argumento ruta.

El iterador scandir() admite el protocolo context manager y tiene el siguiente método:

scandir.close()¶

Cierre el iterador y libere los recursos adquiridos.

Esto se llama automáticamente cuando el iterador se agota o se recolecta basura, o cuando ocurre un error durante la iteración. Sin embargo, es aconsejable llamarlo explícitamente o utilizar la palabra clave with.

Added in version 3.6.

El siguiente ejemplo muestra un uso simple de scandir() para mostrar todos los archivos (excepto los directorios) en la path dada que no comienzan con '.'. La llamada entry.is_file() generalmente no realizará una llamada adicional al sistema:

with os.scandir(path) as it:
    for entry in it:
        if not entry.name.startswith('.') and entry.is_file():
            print(entry.name)

Nota

En los sistemas basados ​​en Unix, scandir() usa las funciones opendir() y readdir() del sistema. En Windows, utiliza las funciones Win32 FindFirstFileW y FindNextFileW.

Added in version 3.5.

Distinto en la versión 3.6: Se agregó compatibilidad con el protocolo context manager y el método close(). Si un iterador scandir() no se agota ni se cierra explícitamente, se emitirá un ResourceWarning en su destructor.

La función acepta un path-like object.

Distinto en la versión 3.7: Soporte agregado para descriptores de archivo en Unix.

class os.DirEntry¶

Objeto generado por scandir() para exponer la ruta del archivo y otros atributos de archivo de una entrada de directorio.

scandir() proporcionará tanta información como sea posible sin hacer llamadas adicionales al sistema. Cuando se realiza una llamada al sistema stat() o lstat(), el objeto os.DirEntry almacenará en caché el resultado.

Las instancias os.DirEntry no están destinadas a ser almacenadas en estructuras de datos de larga duración; si sabe que los metadatos del archivo han cambiado o si ha transcurrido mucho tiempo desde la llamada scandir(), llame a os.stat(entry.path) para obtener información actualizada.

Debido a que los métodos os.DirEntry pueden hacer llamadas al sistema operativo, también pueden generar OSError. Si necesita un control muy preciso sobre los errores, puede detectar OSError cuando llame a uno de los métodos os.DirEntry y maneje según corresponda.

Para ser directamente utilizable como path-like object, os.DirEntry implementa la interfaz PathLike.

Los atributos y métodos en una instancia de os.DirEntry son los siguientes:

name¶

El nombre de archivo base de la entrada, relativo al argumento scandir() path.

El atributo name será bytes si el argumento scandir() path es de tipo bytes y str de lo contrario. Utilice fsdecode() para decodificar los nombres de archivo de bytes.

path¶

El nombre completo de la ruta de entrada: equivalente a os.path.join(scandir_path, entry.name) donde scandir_path es el argumento scandir() path. La ruta solo es absoluta si el argumento scandir() path fue absoluto. Si el argumento scandir() path era un descriptor de archivo, el atributo path es el mismo que el atributo name.

El atributo path será bytes si el argumento scandir() path es de tipo bytes y str de lo contrario. Utilice fsdecode() para decodificar los nombres de archivo de bytes.

inode()¶

Retorna el número de inodo de la entrada.

El resultado se almacena en caché en el objeto os.DirEntry. Use os.stat(entry.path, follow_symlinks=False).st_ino para obtener información actualizada.

En la primera llamada no almacenada en caché, se requiere una llamada del sistema en Windows pero no en Unix.

is_dir(*, follow_symlinks=True)¶

Retorna True si esta entrada es un directorio o un enlace simbólico que apunta a un directorio; retorna False si la entrada es o apunta a cualquier otro tipo de archivo, o si ya no existe.

Si follow_symlinks es False, retorna True solo si esta entrada es un directorio (sin seguir los enlaces simbólicos); retorna False si la entrada es cualquier otro tipo de archivo o si ya no existe.

El resultado se almacena en caché en el objeto os.DirEntry, con un caché separado para follow_symlinks True y False. Llame a os.stat() junto con stat.S_ISDIR() para obtener información actualizada.

En la primera llamada no almacenada en caché, no se requiere ninguna llamada al sistema en la mayoría de los casos. Específicamente, para los enlaces no simbólicos, ni Windows ni Unix requieren una llamada al sistema, excepto en ciertos sistemas de archivos Unix, como los sistemas de archivos de red, que retornan dirent.d_type == DT_UNKNOWN. Si la entrada es un enlace simbólico, se requerirá una llamada al sistema para seguir el enlace simbólico a menos que follow_symlinks sea False.

Este método puede generar OSError, como PermissionError, pero FileNotFoundError se captura y no se genera.

is_file(*, follow_symlinks=True)¶

Retorna True si esta entrada es un archivo o un enlace simbólico que apunta a un archivo; retorna False si la entrada es o apunta a un directorio u otra entrada que no sea de archivo, o si ya no existe.

Si follow_symlinks es False, retorna True solo si esta entrada es un archivo (sin los siguientes enlaces simbólicos); retorna False si la entrada es un directorio u otra entrada que no sea de archivo, o si ya no existe.

El resultado se almacena en caché en el objeto os.DirEntry. El almacenamiento en caché, las llamadas realizadas al sistema y las excepciones generadas son las siguientes is_dir().

is_symlink()¶

Retorna True si esta entrada es un enlace simbólico (incluso si está roto); retorna False si la entrada apunta a un directorio o cualquier tipo de archivo, o si ya no existe.

El resultado se almacena en caché en el objeto os.DirEntry. Llame a os.path.islink() para obtener información actualizada.

En la primera llamada no almacenada en caché, no se requiere ninguna llamada al sistema en la mayoría de los casos. Específicamente, ni Windows ni Unix requieren una llamada al sistema, excepto en ciertos sistemas de archivos Unix, como los sistemas de archivos de red, que retornan dirent.d_type == DT_UNKNOWN.

Este método puede generar OSError, como PermissionError, pero FileNotFoundError se captura y no se genera.

is_junction()¶

Devuelve True si esta entrada es una unión (incluso si está rota); devuelve False si la entrada apunta a un directorio normal, cualquier tipo de archivo, un enlace simbólico o si ya no existe.

El resultado se almacena en caché en el objeto os.DirEntry. Llame a os.path.isjunction() para obtener información actualizada.

Added in version 3.12.

stat(*, follow_symlinks=True)¶

Retorna un objeto a stat_result para esta entrada. Este método sigue enlaces simbólicos por defecto; para crear un enlace simbólico agregue el argumento follow_symlinks=False.

En Unix, este método siempre requiere una llamada al sistema. En Windows, solo requiere una llamada al sistema si follow_symlinks es True y la entrada es un punto de análisis (por ejemplo, un enlace simbólico o una unión de directorio).

En Windows, los atributos st_ino, st_dev y st_nlink de stat_result siempre se establecen en cero. Llame a os.stat() para obtener estos atributos.

El resultado se almacena en caché en el objeto os.DirEntry, con un caché separado para follow_symlinks True y False. Llame a os.stat() para obtener información actualizada.

Tenga en cuenta que existe una buena correspondencia entre varios atributos y métodos de os.DirEntry y pathlib.Path. En particular, el atributo name tiene el mismo significado, al igual que los métodos is_dir(), is_file(), is_symlink(), is_junction() y stat().

Added in version 3.5.

Distinto en la versión 3.6: Se agregó soporte para la interfaz PathLike. Se agregó soporte para rutas de bytes en Windows.

Distinto en la versión 3.12: El atributo st_ctime de un resultado estadístico está obsoleto en Windows. La hora de creación del archivo está disponible correctamente como st_birthtime y, en el futuro, st_ctime puede cambiarse para que devuelva cero o la hora de cambio de metadatos, si está disponible.

os.stat(path, *, dir_fd=None, follow_symlinks=True)¶

Obtener el estado de un archivo o un descriptor de archivo. Realice el equivalente de a llamada del sistema stat() en la ruta dada. path puede especificarse como una cadena o bytes, directa o indirectamente a través de la interfaz PathLike, o como un descriptor de archivo abierto. Retorna un objeto stat_result.

Esta función normalmente sigue enlaces simbólicos; para crear un enlace simbólico agregue el argumento follow_symlinks=False, o use lstat().

Esta función puede soportar especificando un descriptor de archivo y no siguen enlaces simbólicos.

En Windows, pasar follow_symlinks=False deshabilitará el seguimiento de todos los puntos de análisis sustitutos de nombre, que incluyen enlaces simbólicos y uniones de directorio. Se abrirán directamente otros tipos de puntos de análisis que no se parecen a los enlaces o que el sistema operativo no puede seguir. Al seguir una cadena de enlaces múltiples, esto puede dar como resultado que se retorna el enlace original en lugar del no enlace que impidió el recorrido completo. Para obtener resultados estadísticos para la ruta final en este caso, use la función os.path.realpath() para resolver el nombre de la ruta lo más posible y llame a lstat() en el resultado. Esto no se aplica a enlaces simbólicos o puntos de unión colgantes, lo que lanzará las excepciones habituales.

Ejemplo:

>>> import os
>>> statinfo = os.stat('somefile.txt')
>>> statinfo
os.stat_result(st_mode=33188, st_ino=7876932, st_dev=234881026,
st_nlink=1, st_uid=501, st_gid=501, st_size=264, st_atime=1297230295,
st_mtime=1297230027, st_ctime=1297230027)
>>> statinfo.st_size
264

Ver también

fstat() y funciones lstat().

Distinto en la versión 3.3: Se agregaron los parámetros dir_fd y follow_symlinks, especificando un descriptor de archivo en lugar de una ruta.

Distinto en la versión 3.6: Acepta un objeto tipo ruta.

Distinto en la versión 3.8: En Windows, ahora se siguen todos los puntos de análisis que el sistema operativo puede resolver, y pasar follow_symlinks=False desactiva los siguientes puntos de análisis sustitutos de nombre. Si el sistema operativo alcanza un punto de análisis que no puede seguir, stat ahora retorna la información de la ruta original como si se hubiera especificado follow_symlinks=False en lugar de generar un error.

class os.stat_result¶

Objeto cuyos atributos corresponden aproximadamente a los miembros de la estructura stat. Se utiliza para el resultado de os.stat(), os.fstat() y os.lstat().

Atributos:

st_mode¶

Modo de archivo: tipo de archivo y bits de modo de archivo (permisos).

st_ino¶

Dependiendo de la plataforma, pero si no es cero, identifica de forma exclusiva el archivo para un valor dado de st_dev. Típicamente:

• el número de inodo en Unix,

• el índice del archivo en Windows

st_dev¶

Identificador del dispositivo en el que reside este archivo.

st_nlink¶

Número de enlaces duros.

st_uid¶

Identificador de usuario del propietario del archivo.

st_gid¶

Identificador de grupo del propietario del archivo.

st_size¶

Tamaño del archivo en bytes, si es un archivo normal o un enlace simbólico. El tamaño de un enlace simbólico es la longitud del nombre de ruta que contiene, sin un byte nulo de terminación.

Marcas de tiempo:

st_atime¶

Tiempo de acceso más reciente expresado en segundos.

st_mtime¶

Tiempo de modificación de contenido más reciente expresado en segundos.

st_ctime¶

Hora del cambio de metadatos más reciente expresado en segundos.

Distinto en la versión 3.12: st_ctime está obsoleto en Windows. Utilice st_birthtime para indicar la hora de creación del archivo. En el futuro, st_ctime contendrá la hora del cambio de metadatos más reciente, como en otras plataformas.

st_atime_ns¶

Tiempo de acceso más reciente expresado en nanosegundos como un entero.

Added in version 3.3.

st_mtime_ns¶

Hora de la modificación de contenido más reciente expresada en nanosegundos como un entero.

Added in version 3.3.

st_ctime_ns¶

Hora del cambio de metadatos más reciente expresado en nanosegundos como un número entero.

Added in version 3.3.

Distinto en la versión 3.12: st_ctime_ns está obsoleto en Windows. Utilice st_birthtime_ns para indicar la hora de creación del archivo. En el futuro, st_ctime contendrá la hora del cambio de metadatos más reciente, como en otras plataformas.

st_birthtime¶

Hora de creación del archivo expresada en segundos. Este atributo no siempre está disponible y puede generar el error AttributeError.

Distinto en la versión 3.12: st_birthtime ahora está disponible en Windows.

st_birthtime_ns¶

Hora de creación del archivo expresada en nanosegundos como un número entero. Este atributo no siempre está disponible y puede generar el error AttributeError.

Added in version 3.12.

Nota

El significado y la resolución exactos de los atributos st_atime, st_mtime, st_ctime y st_birthtime dependen del sistema operativo y del sistema de archivos. Por ejemplo, en los sistemas Windows que utilizan sistemas de archivos FAT32, st_mtime tiene una resolución de 2 segundos y st_atime tiene una resolución de solo 1 día. Consulte la documentación de su sistema operativo para obtener más detalles.

De manera similar, aunque st_atime_ns, st_mtime_ns, st_ctime_ns y st_birthtime_ns siempre se expresan en nanosegundos, muchos sistemas no proporcionan precisión en nanosegundos. En los sistemas que sí proporcionan precisión en nanosegundos, el objeto de punto flotante utilizado para almacenar st_atime, st_mtime, st_ctime y st_birthtime no puede conservarlo todo y, por lo tanto, será ligeramente inexacto. Si necesita las marcas de tiempo exactas, siempre debe utilizar st_atime_ns, st_mtime_ns, st_ctime_ns y st_birthtime_ns.

En algunos sistemas Unix (como Linux), los siguientes atributos también pueden estar disponibles:

st_blocks¶

Número de bloques de 512 bytes asignados para el archivo. Esto puede ser más pequeño que st_size / 512 cuando el archivo tiene agujeros.

st_blksize¶

Tamaño de bloque «preferido» para una eficiente E / S del sistema de archivos. Escribir en un archivo en fragmentos más pequeños puede causar una lectura-modificación-reescritura ineficiente.

st_rdev¶

Tipo de dispositivo si es un dispositivo inodo.

st_flags¶

Indicadores definidos por el usuario para el archivo.

En otros sistemas Unix (como FreeBSD), los siguientes atributos pueden estar disponibles (pero solo se pueden completar si la raíz intenta usarlos):

st_gen¶

Número de generación de archivos.

En Solaris y derivados, los siguientes atributos también pueden estar disponibles:

st_fstype¶

Cadena que identifica de forma exclusiva el tipo de sistema de archivos que contiene el archivo.

En los sistemas macOS, los siguientes atributos también pueden estar disponibles:

st_rsize¶

Tamaño real del archivo.

st_creator¶

Creador del archivo.

st_type¶

Tipo de archivo.

En los sistemas Windows, los siguientes atributos también están disponibles:

st_file_attributes¶

Atributos de archivo de Windows: dwFileAttributes miembro de la estructura BY_HANDLE_FILE_INFORMATION devuelta por GetFileInformationByHandle(). Consulte las constantes FILE_ATTRIBUTE_* <stat.FILE_ATTRIBUTE_ARCHIVE> en el módulo stat.

Added in version 3.5.

st_reparse_tag¶

Cuando st_file_attributes tiene FILE_ATTRIBUTE_REPARSE_POINT configurado, este campo contiene la etiqueta que identifica el tipo de punto de análisis. Consulte las constantes IO_REPARSE_TAG_* en el módulo stat.

El módulo estándar stat define funciones y constantes que son útiles para extraer información de una estructura stat. (En Windows, algunos elementos se rellenan con valores ficticios).

Para compatibilidad con versiones anteriores, también se puede acceder a una instancia stat_result como una tupla de al menos 10 números enteros que den los miembros más importantes (y portables) de la estructura stat, en el orden st_mode, st_ino, st_dev, st_nlink, st_uid, st_gid, st_size, st_atime, st_mtime, st_ctime. Algunas implementaciones pueden agregar más elementos al final. Para compatibilidad con versiones anteriores de Python, acceder a stat_result como una tupla siempre devuelve números enteros.

Distinto en la versión 3.5: Windows ahora retorna el índice del archivo como st_ino cuando está disponible.

Distinto en la versión 3.7: Se agregó el miembro st_fstype a Solaris/derivados.

Distinto en la versión 3.8: Se agregó el miembro st_reparse_tag en Windows.

Distinto en la versión 3.8: En Windows, el miembro st_mode ahora identifica archivos especiales como S_IFCHR, S_IFIFO o S_IFBLK según corresponda.

Distinto en la versión 3.12: En Windows, st_ctime está obsoleto. Con el tiempo, contendrá la última hora de cambio de metadatos, para mantener la coherencia con otras plataformas, pero por ahora aún contiene la hora de creación. Utilice st_birthtime para la hora de creación.

En Windows, st_ino puede tener hasta 128 bits, según el sistema de archivos. Antes no superaba los 64 bits y los identificadores de archivos más grandes se empaquetaban de forma arbitraria.

En Windows, st_rdev ya no devuelve un valor. Antes contenía el mismo valor que st_dev, lo cual era incorrecto.

Se agregó el miembro st_birthtime en Windows.