Package: fakeroot
Version: 1.3
Severity: wishlist
Tags: patch l10n
Hello, this is a new version of the fakeroot manpage, I'd like you to upload a
new package into testing with this manpage in order to ship Sarge with an up to
date translation.
Thanks.
-- System Information:
Debian Release: 3.1
APT prefers unstable
APT policy: (500, 'unstable'), (101, 'experimental')
Architecture: i386 (i686)
Shell: /bin/sh linked to /bin/bash
Kernel: Linux 2.6.11-1-686
Locale: [EMAIL PROTECTED], [EMAIL PROTECTED] (charmap=UTF-8)
Versions of packages fakeroot depends on:
ii libc6 2.3.2.ds1-22 GNU C Library: Shared libraries an
-- no debconf information
.\" Process this file with
.\" groff -man -Tascii foo.1
.\"
.\" "verbatim" environment (from strace.1)
.de CW
.sp
.nf
.ft CW
..
.de CE
.ft
.fi
.sp
..
.\"
.\" (c) 2003 Software in the Public Interest
.\" Esta traducci�n ha sido realizada por Rub�n Porras Campo <[EMAIL PROTECTED]>
.\" Est� basada en la p�gina de manual original:
.\" versi�n 1.10 del CVS de
.\" /cvs/debian-doc/manpages/english/fakeroot/fakeroot.1
.TH fakeroot 1 "6 de agosto de 2004" "Proyecto Debian" "Manual de Debian"
.\" Manpage by J.H.M. Dassen <[EMAIL PROTECTED]>
.\" and Clint Adams <[EMAIL PROTECTED]>
.SH NOMBRE
fakeroot \- ejecuta una orden en un entorno que falsea privilegios de
superusuario para la manipulaci�n de ficheros
.SH SINOPSIS
.B fakeroot
.B [\-l|\-\-lib
.IB biblioteca]
.B [\-\-faked
.IB binario-faked ]
.B [\-i
.IB fichero-a-cargar ]
.B [\-s
.IB fichero-salvado ]
.B [\-u|\-\-unknown\-is\-real ]
.B [\-b|\-\-fd\-base ]
.B [\-h|\-\-help ]
.B [\-v|\-\-version ]
.BI [\-\-]
.BI [orden]
.SH DESCRIPCI�N
.B fakeroot
ejecuta una orden en un entorno donde parece que se tiene permisos de
superusuario para la manipulaci�n de ficheros. �til para permitir a usuarios
crear archivos (tar, ar, .deb etc.) con ficheros con permisos/propietarios de
superusuario.
Sin
.B fakeroot
uno necesitar�a privilegios de superusuario para crear los ficheros
constituyentes del archivo con los permisos y propietario correctos, y despu�s
empaquetarlos, o uno tendr�a que construir los archivos directamente, sin usar
el archivador.
.B fakeroot
reemplaza las funciones de la biblioteca de manipulaci�n de ficheros (chmod(2),
stat(2) etc.) por otras que simulan el efecto real que hubiesen tenido dichas
funciones, si el usuario hubiese sido realmente el superusuario. Estas funciones
envoltorio se encuentran en la biblioteca compartida
.B /usr/lib/libfakeroot.so*
que se carga mediante el mecanismo
.B LD_PRELOAD
del cargador din�mico. (Consulte
.BR ld.so (8))
Si pretende construir paquetes usando
.BR fakeroot ,
es aconsejable construir primero el paquete fakeroot: la etapa "debian/rules
build" tiene algunas comprobaciones (la mayor�a de ellas buscan fallos de
versiones viejas de fakeroot). Si estas pruebas fallan (por ejemplo, porque
tiene ciertos programas libc5 en el sistema), tambi�n fallar� la construcci�n de
otros paquetes mediante fakeroot, pero de formas mucho m�s sutiles.
Adem�s, dese cuenta que es mejor no realizar la compilaci�n de los binarios bajo
fakeroot. Especialmente configure y dem�s programas del estilo no se comportan
bien cuando el sistema se comporta de forma diferente a la esperada. (o, de
forma aleatoria, estos programas eliminan algunas variables de entorno, algunas
de las cuales necesita fakeroot).
.SH OPCIONES
.TP
\fB\-l\fR \fIbiblioteca\fR, \fB\-\-lib\fR \fIbiblioteca\fR
Especifica una biblioteca envoltorio.
.TP
.BI \-\-faked \ binario
Especifica un binario alternativo a usar en vez de faked.
.TP
.BI [\-\-] \ orden
Cualquier orden que quieras ejecutar bajo fakeroot. Use \(oq\-\-\(cq si en la
orden tiene otras opciones que puedan confundir el an�lisis de las opciones de
fakeroot.
.TP
.BI \-s \ fichero-salvado
Guarda el entorno fakeroot en fichero-salvado al salir. Este fichero puede
usarse para restaurar el entorno m�s tarde usando \-i. Sin embargo, este fichero
fallar� y fakeroot se comportar� de forma extra�a a menos que no modifique los
ficheros creados (N.T. del ingl�s touched, haciendo referencia a la orden touch,
con la que fakeroot crea algunos ficheros vac�os para simular algunas
situaciones) dentro del entorno fakeroot cuando est� fuera del entorno. Aun as�,
esto puede ser �til. Por ejemplo, puede usarse con rsync(1) para guardar y
restaurar el �rbol de directorios completo con la informaci�n de usuarios,
grupos y dispositivos completa sin necesidad de ser superusuario. Consulte
.I /usr/share/doc/fakeroot/README.saving
para m�s detalles.
.TP
.BI \-i \ fichero-a-cargar
Carga un entorno fakeroot de fichero-a-cargar previamente salvado usando \-s.
Note que esto no salva impl�citamente el fichero, use tambi�n \-s para conseguir
esto. Es seguro usar el mismo fichero para \-i y \-s en una misma invocaci�n de
.BR fakeroot.
.TP
\fB\-u\fR, \fB\-\-unknown\-is\-real\fR
Usa el propietario real para ficheros desconocidos previamente por fakeroot en
vez de suponer que pertenecen a root:root.
.TP
.BI \-b \ fd
Especifica el descriptor de fichero base (s�lo en modo TCP). Fd es el n�mero
m�nimo de descriptor de fichero a usar para las conexiones TCP, puede ser
importante para evitar conflictos con los descriptores de ficheros usados por
programas ejecut�ndose dentro de
.B fakeroot.
.TP
.BI \-h
Muestra la ayuda.
.TP
.BI \-v
Muestra la versi�n.
.SH EJEMPLOS
Aqu� hay un ejemplo de una sesi�n con
.BR fakeroot .
Dese cuenta que dentro de un entorno fakeroot la manipulaci�n de ficheros que
requiere privilegios de superusuario se realiza con �xito, pero realmente no se
lleva a cabo.
.CW
$ whoami
joost
$ fakeroot /bin/bash
# whoami
root
# mknod hda3 b 3 1
# ls \-ld hda3
brw\-r\-\-r\-\- 1 root root 3, 1 Jul 2 22:58 hda3
# chown joost:root hda3
# ls \-ld hda3
brw\-r\-\-r\-\- 1 joost root 3, 1 Jul 2 22:58 hda3
# ls \-ld /
drwxr\-xr\-x 20 root root 1024 Jun 17 21:50 /
# chown joost:users /
# chmod a+w /
# ls \-ld /
drwxrwxrwx 20 joost users 1024 Jun 17 21:50 /
# exit
$ ls \-ld /
drwxr\-xr\-x 20 root root 1024 Jun 17 21:50 //
$ ls \-ld hda3
\-rw\-r\-\-r\-\- 1 joost users 0 Jul 2 22:58 hda3
.CE
S�lo las operaciones que el usuario
.B joost
puede hacer se llevan a cabo realmente.
.B fakeroot
se escribi� espec�ficamente para permitir que los usuario pudiesen crear
paquetes (en el formato
.BR deb(5)
) sin tener privilegios de superusuario.
Esto puede hacerse con �rdenes como
.B dpkg-buildpackage \-rfakeroot
o
.B debuild \-rfakeroot
(realmente, \-rfakeroot es predeterminado en debuild en estos momentos, as� que
no necesita el argumento).
.SH ASPECTOS DE SEGURIDAD
.B fakeroot
es un programa normal, sin el bit setuid. No aumenta los privilegios de un
usuario ni disminuye la seguridad del sistema.
.SH FICHEROS
.I /usr/lib/libfakeroot/libfakeroot.so*
La biblioteca compartida que contiene las funciones envoltorio.
.SH ENTORNO
.B
.IP FAKEROOTKEY
La llave usada para comunicarse con el demonio fakeroot. Cualquier programa
comenzado con el
.B LD_PRELOAD
correcto y la
.B FAKEROOTKEY
de un demonio en ejecuci�n conectar� autom�ticamente con ese demonio, y tendr�
la misma visi�n "falsa" de los permisos/propietarios de los ficheros del
sistema. (sumiendo que el demonio y el programa que se conecta los ejecute el
mismo usuario).
.B
.IP LD_LIBRARY_PATH
.B
.IP LD_PRELOAD
Fakeroot est� implementado envolviendo las llamadas al sistema. Esto se realiza
modificando las variables de entorno de forma que queden como
LD_LIBRARY_PATH=/usr/lib/fakeroot y LD_PRELOAD=libfakeroot.so.0. Esa biblioteca
se carga antes que la biblioteca de C del sistema, y de esa forma se interceptan
gran parte de las llamadas al sistema. Si necesita modificar
.B LD_LIBRARY_PATH
o
.B LD_PRELOAD
dentro de un entorno fakeroot, deber�n quedar establecidos de forma relativa,
como en
.B LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/foo/bar/
.SH LIMITACIONES
.B
.IP "Versiones de la biblioteca"
Toda orden ejecutada con
.B fakeroot
necesita enlazarse con la misma versi�n de la biblioteca de C del mismo
.B fakeroot.
.B
.IP open()/create()
fakeroot no envuelve open(), create(), etc. As�, que si el usuario
.B joost
hace
.CW
touch tal
fakeroot
ls \-al tal
.CE
o del otro modo,
.CW
fakeroot
touch tal
ls \-al tal
.CE
fakeroot no puede saber en el primer caso que, el propietario de tal realmente
debe ser
.B joost
mientras que en el segundo debe ser
.BR root .
Para los paquetes Debian, dar a todos los ficheros "desconocidos" uid=gid=0 por
omisi�n, est� siempre bien. La forma real de solucionar esto es envolver
.B open()
y
.BR create() ,
pero esto crea otros problemas, como demuestra el paquete libtricks. Este
paquete envuelve m�s funciones, e intenta hacer m�s cosas que
.B fakeroot .
Se vio que una peque�a actualizaci�n de libc (de una donde la funci�n
.BR stat()
no usaba
.BR open()
a otra en la que
.BR stat()
usaba (en algunas ocasiones)
.BR open() ),
causaba violaciones de segmento inexplicables (esto es, el
.BR stat()
de libc6 llamaba el
.BR open()
envuelto, que luego llamaba al
.BR stat()
de libc6, etc). Arreglarlo no fue tan dif�cil, pero una vez arreglado, es
cuesti�n de tiempo antes de que otra funci�n empiece a usar open(), ni hablar de
portarlo a otro sistema operativo. As� que decid� reducir al m�ximo el n�mero de
funciones envuelta por fakeroot, para limitar la probabilidad de
\(oqcolisiones\(cq.
.B
.IP "GNU configure (y otros programas por el estilo)"
fakeroot, en efecto, cambia el comportamiento del sistema. Los programas que
prueban el sistema, como GNU configure, pueden verse confundidos por esto (o si
no lo hacen, llevar�n a fakeroot tan al l�mite que ser� este el que se
confunda). As� que es aconsejable no ejecutar el objetivo "configure" en un
entorno fakeroot. Como configure debe ejecutarse en "debian/rules build",
"dpkg\-buildpackage \-rfakeroot" tiene cuidado de esto, haci�ndolo
correctamente.
.SH FALLOS
No envuelve open(). Esto no es malo por si mismo, pero si un programa hace
open("fichero", O_WRONLY, 000), escribe en "fichero", lo cierra, y trata de
abrirlo de nuevo para leer el fichero, entonces falla al abrirlo, ya que el modo
del fichero ser� 000. El fallo es que si el superusuario hace lo mismo, open()
ser� satisfactorio, ya que los permisos del fichero no se comprueban para el
superusuario. Eleg� no envolver open(), ya que open() se usa en muchas otras
funciones de libc (incluso en aquellas que ya est�n envueltas), de forma que se
crean bucles (o posibles bucles futuros, cuando la implementaci�n de varias
funciones de libc cambie ligeramente).
.SH COPIA
.B fakeroot
se distribuye bajo la Licencia P�blica General de GNU.
(GPL 2.0 o posterior).
.SH AUTORES
.TP
joost witteveen
.RI < [EMAIL PROTECTED] >
.TP
Clint Adams
.RI < [EMAIL PROTECTED] >
.TP
Timo Savola
.SH P�GINA DEL MANUAL
la mayor parte de J.H.M. Dassen
.RI <[EMAIL PROTECTED]>
con muchas modificaciones y a�adiduras de joost y Clint.
.SH "V�ASE ADEM�S"
.BR faked (1)
.BR dpkg\-buildpackage (1),
.BR debuild (1)
.BR /usr/share/doc/fakeroot/DEBUG
.SH TRADUCTOR
Traducci�n de Rub�n Porras Campo <[EMAIL PROTECTED]>
