TRUNCATE

Section: Manual del programador de Linux (2)
Updated: 21 diciembre 1998
Index Return to Main Contents

NOMBRE

truncate, ftruncate - trunca un fichero a una longitud especificada

SINOPSIS

#include <unistd.h>

int truncate(const char *path, off_t length);
int ftruncate(int fd, off_t length);

DESCRIPCIÓN

truncate

hace que el fichero nombrado por path o referido por fd sea truncado a una longitud máxima de length bytes. Si el fichero era mayor que dicha longitud, los datos extra se perderán. Con ftruncate, el fichero debe estar abierto para escritura.

VALOR DEVUELTO

En caso de éxito, se devuelve cero. En caso de error, se devuelve -1 y se establece el errno apropiado.

ERRORES

Para truncate:

ENOTDIR: Un componente de la ruta no es un directorio.
ENAMETOOLONG: Un componente de la ruta excede los 255 caracteres, o la ruta completa excede los 1023 caracteres.
ENOENT: El fichero no existe.
EACCES: No se tiene permiso de búsqueda para algún componente de la ruta.
EACCES: El usuario no tiene permiso de escritura sobre el fichero.
ELOOP: Se encontraron demasiados enlaces simbólicos al traducir la ruta.
EISDIR: El fichero es en realidad un directorio.
EROFS: El fichero reside en un sistema de ficheros de sólo lectura.
ETXTBSY: El fichero es un fichero de procedimientos puros (código compartido) que se está ejecutando.
EIO: Ocurrió un error de E/S al actualizar el inodo.
EFAULT: path apunta fuera del espacio de direcciones asignado al proceso.

Para ftruncate:

EBADF: fd no es un descriptor válido.
EINVAL: fd hace referencia a un socket, no a un fichero.
EINVAL: fd no está abierto para escritura.

CONFORME A

4.4BSD, SVr4 (estas funciones aparecieron por primera vez en BSD 4.2). SVr4 documenta las condiciones de error adicionales EINTR, EMFILE, EMULTIHP, ENAMETOOLONG, ENFILE, ENOLINK y ENOTDIR para truncate. SVr4 documenta las condiciones de error adicionales EAGAIN y EINTR para ftruncate. POSIX posee ftruncate pero no truncate.

FALLOS

Estas llamadas deberían ser ampliadas para permitir descartar rangos de bytes de un fichero.

VÉASE TAMBIÉN

open

(2)

This document was created by man2html, using the manual pages.
Time: 06:16:20 GMT, January 22, 2005