SBOPKG.CONF(5)

NOMBRE
sbopkg.conf - archivo de configuración para sbopkg

DESCRIPCION
El archivo sbopkg.conf contiene los ajustes de configuración para sbopkg(8), una herramienta para interactuar con el repositorio de SlackBuilds.org ("SBo"), una colección de scripts SlackBuild de terceros para construir paquetes para Slackware. El archivo de configuración por defecto esta instalado en /etc/sbopkg/sbopkg.conf. El usuario puede sobreescribir cualquier configuración creando el archivo ~/.sbopkg.conf.

Por favor lea la sección NOTAS para mas información sobre las variables, incluyendo la sección ARCH.

Todas las opciones booleanas necesitan un YES o un NO sin tener en cuenta si son mayúsculas o minúsculas. Todos los valores de la variables que contengan directorios deben ser absolutas.

Las opciones de configuración por defecto son:

ALLOW_MULTI
    Booleano.

    Cuando se establece en YES, esta opcion permite al usuario iniciar varias veces sbopkg simultaneamente.

    Por favor comprenda que esta opción es provehí­da por comodidad, pero puede generar un número potencial de problemas que deberá encarar cuando habilite ésta opción (y no vamos a trabajar con usuarios haciendo tonterias), debe considerar que ésta es una característica EXPERIMENTAL NO SOPORTADA. Si encuentra problemas, por favor asegúrese que no es causado por usted realizando cosas inadecuadas.

    Por ejemplo, algunas de estas cosas, no deberían utilizarse con estas opciones activadas:

    •   inicia instancias con una mezcla de configuraciones YES y NO

    •   sincronizar un repositorio, cuando otra instancia lo esta utilizando

    •   cambiar la rama de un repositorio git, cuando otra instancia lo esta usando (esta advertencia no se utiliza para sincronizar los repositorios)

    •   construir o instalar el mismo paquete a la vez desde diferentes instancias

    •   guardar un archivo de colas mientras se esta usando desde otra instancia

    Puede haber mas situaciones inseguras de las que nosotros pensamos. Tenga cuidado.

    La configuración por defecto es:

    ALLOW_MULTI=${ALLOW_MULTI:-NO}

CLEANUP
    Booleano.

    Cuando se establece como YES, los archivos fuente desempaquetados y el árbol de paquetes situados en $TMP son eliminados inmediatamente después de la construcción, tanto el archivo descargado como el paquete que han sido colocados en $SRCDIR y $OUTPUT.

    Un efecto colateral de configurar CLEANUP con YES es que TMP esta configurada con su propio directorio temporal, en sbopkg, como ($TMPDIR/sbopkg.RANDOM_STRING), por lo tanto cualquier otro TMP será ignorado.

    La configuración por defecto es:

    CLEANUP=${CLEANUP:-NO}

DEBUG_UPDATES
    Enumeración.

    Esta opción debe ser establecida como 0, 1, o 2. DEBUG_UPDATES establece el nivel de depuración (debugging) por defecto para actualizar la lista de funciones de sbopkg. Cuando esta establecido en 0, solo las actualizaciones importantes (o reducciones de version) de paquetes son listados. Cuando esta establecido en 1, se listan actualizaciones importantes mas los paquetes que no están en el repositorio y paquetes mas recientes que los que se encuentran en los listados del repositorio. Cuando esta establecido en 2, todos los paquetes no actualizados son listados. Cambiando DEBUG_UPDATES a 1 o 2 pude ser de utilidad si aparecen paquetes nuevos que pueden obviarse en una actualización.

    La configuración por defecto es:

    DEBUG_UPDATES=${DEBUG_UPDATES:-0}

DIFF
    Comando.

    Esta opción le permite al usuario establecer que programa usar cuando sbopkg muestra diferencias entre archivos editados.

    La configuración por defecto es:

    DIFF=${DIFF:-diff}

DIFFOPTS
    Opciones de comando.

    Esta opción le permite al usuario establecer que opciones serán usadas por el programa $DIFF cuando sbopkg muestre las diferencias entre los archivos editados.

    La configuración por defecto es:

    DIFFOPTS=${DIFFOPTS:--u}

KEEPLOG
    Booleano.

    Esta opción le permite al usuario escoger si mantener un bitácora (log) permanente de todos los paquetes que son construidos con sbopkg para volver a ver el historial de las construcciones o para la solucionar problemas. Ver LOGFILE para la localizar de este bitácora.

    La tarea por defecto es:

    KEEPLOG=${KEEPLOG:-YES}

LOGFILE
    Ruta.

    Esta opción establece el nombre de la bitácora (log) de construcción si KEEPLOG esta establecido como YES.

    La configuración por defecto es:

    LOGFILE=${LOGFILE:-/var/log/sbopkg/sbopkg-build-log}

MKDIR_PROMPT
    Booleano.

    Cuando esta establecido como YES, sbopkg le pedirá la confirmación antes de cambiar el sistema de archivos y crear sus directorios. Si no desea recibir la petición de confirmación (por ejemplo, si tiene parte de los directorios en sistemas de archivos temporales y no deseas recibir la petición de confirmación cada vez que el sistema de archivos es vuelto a iniciar) puedes establecerlo como NO.

    La tarea por defecto es:

    MKDIR_PROMPT=${MKDIR_PROMPT:-YES}

NICE
    Intero.

    este valor es pasado a nice(1) como el argumento -n . Si este valor no esta configurado o se deja con el valor por defecto, sbopkg ejecutará el SlackBuild con el valor por defecto de nice, que es 10. Si no desea que la prioridad tenga efecto, asegúrese de configurar el valor a 0. Note que ésto solo afecta a la ejecución del SlackBuild y no afecta a la prioridad de sbopkg por completo.

    La configuración por defecto es:

    NICE=${NICE:-10}

OUTPUT
    Ruta.

    Esta opción establece el directorio por defecto donde los paquetes son compilados y guardados. OUTPUT debe ser exportado como si fuera usado por los SlackBuilds de SBo. Cabe destacar que el valor por defecto de OUTPUT es el mismo que el utilizado en los SlackBuilds de SBo.

    La configuración por defecto es:

    export OUTPUT=${OUTPUT:-/tmp}

QUEUEDIR
    Ruta.

    Esta opción define el directorio bajo el que los archivos de cola seran mantenidos.

    La asignación por defecto es:

    QUEUEDIR=${QUEUEDIR:-/var/lib/sbopkg/queues}

REPO_BRANCH
    Enumeración.

    Esta opción le permite al usuario establecer el principal repositorio activo por defecto. Los valores estándar actuales son listados por defecto en los archivos repos.d/* y también pueden ser listados al publicarlos.

        # sbopkg -V ?

    La asignación por defecto es:

    REPO_BRANCH=${REPO_BRANCH:-13.1}

REPO_NAME
    Enumeración.

    Esta opción le permite al usuario escoger que repositorio usar. Ver REPO_BRANCH para saber como conseguir los valores estándar para ésta enumeración. La opción "local" corresponde al un repositorio mantenido por el usuario, que debe tener la misma estructura que la que es usada por SBo, usando la jerarquía category/package/files . Nota: todas las variables REPO_* son afectadas por los archivos mantenidos en en los repositorios /etc/sbopkg/repos.d. Por favor vea el documento README-repos en el directorio de documentación de sbopkg .

    La asignación por defecto es:

    REPO_NAME=${REPO_NAME:-SBo}

REPO_ROOT
    Ruta.

    Esta opción le permite al usuario establecer los espejos (mirrors) de los repositorios remotos. Actualmente, el tamaño de una copia local del repositorio SBo es de alrededor de 250MB.

    La asignación por defecto es:

    REPO_ROOT=${REPO_ROOT:-/var/lib/sbopkg}

RSYNCFLAGS
    Opciones del comando.

    Rsync es usado por sbopkg para crear un espejo (mirror) el repositorio SBo. Esta opción permite al usuario ajustar manualmente las banderas (opciones) de rsync que seran usadas por sbopkg. Los usuarios deben ser cautelosos al realizar cualquier cambio a los valores por defecto ya que nuevas banderas u opciones pueden o nó funcionar adecuadamente. Nota: el comando rsync en sbopkg ya utiliza las banderas --archive, --delete, --no-owner, y --exclude así que no es necesario añadirlas a las opciones de RSYNCFLAGS . Cambiar las opciones internas por defecto no es recomendado. Sin embargo, --timeout es una opción útil para jugar si hay errores de sincronización.

    La asignación por defecto es:

    RSYNCFLAGS="${RSYNCFLAGS:---verbose --timeout=30}"

SBOPKGTMP
    Ruta.

    Esta opción establece el directorio por defecto donde algunos archivos especificos de sbopkg son guardados de forma temporal.

    La asignación por defecto es:

    xxxSBOPKGTMPxxx

SRCDIR
    Ruta.

    Esta opción contiene la localización del directorio de cache, donde las descargas de archivos fuente son guardados.

    La asignación por defecto es:

    SRCDIR=${SRCDIR:-/var/cache/sbopkg}

TMP Ruta.

    Esta opción establece el directorio por defecto donde los paquetes construidos son guradados. TMP debe ser exportado como lo és en los SlackBuilds de SBo. Nótese que el valor por defecto de TMP es además el mismo que el de los SlackBuilds de SBo.

    También nótese que si la variable CLEANUP esta establecida como YES, cualquier opción personalizada de TMP es ignorada.

    La asignación por defecto es:

    export TMP=${TMP:-/tmp/SBo}

WGETFLAGS
    Opciones de comando.

    Wget es usado por sbopkg para descargar los archivos fuentes y construir el paquete. Esta opción permite al usuario ajustar las banderas (opciones) de wget que son usadas por sbopkg. Los usuarios deben ser cautelosos al realizar cualquier cambio a los valores por defecto ya que nuevas banderas u opciones pueden o nó funcionar adecuadamente. Sin embargo, --timeout es una opción útil para jugar si hay errores de descarga.

    La asignación por defecto es:

    WGETFLAGS="${WGETFLAGS:--c --progress=bar:force --timeout=30 --tries=5}"

NOTAS

  Sobreescribiendo Variables de Entorno
Es posible establecer o sobreescribir variables de entorno y pasarlas a los SlackBuilds cuando es construido sin sbopkg. Ésto está demostrado en la siguiente línea de ejemplo (y otras como ella) en el archivo sbopkg.conf :

    export TMP=${TMP:-/tmp/SBo}

Esto establece TMP a /tmp/SBo para construir los paquetes SBo sin sbopkg (el cual es aun actualmente el predeterminado para los SlackBuilds de SBo). Ya que ésta variable es exportada, puede cambiar a sbopkg y a los paquetes construidos de SBo sin sbopkg. Por ejemplo, cambiar esta linea, por lo que siguiente:

    export TMP=${TMP:-/home/sbo/tmp}

entonces se establecerá TMP a /home/sbo/tmp para construir paquetes de SBo y también permitir la sobreescritura en tiempo de ejecución invocando sbopkg como

    # export TMP=foo; sbopkg

OUTPUT puede también cambiar el guardado de paquetes compilados en otra localización en lugar de la predeterminada /tmp.

También puedes exportar variables en sbopkg.conf que no son usadas por sbopkg .

  Sobre la variable ARCH
Quiza te preguntes porque ARCH no es una opción de configuración por defecto en el archivo sbopkg.conf . La razón es que no lo tiene que serlo. Si ARCH no esta establecida, sbopkg hace una comprobación (utilizando la salida de uname -m) para determinar que arquitectura de sistema es. Si la arquitectura es x86, x86_64, o arm*, entonces sbopkg automáticamente establecerá ARCH a i486, x86_64, o arm, respectivamente. Si ARCH esta establecida, sbopkg heredara esa configuración. Esto significa que cada usuario puede añadir, por ejemplo, export ARCH=i686 en su .bashrc o archivo similar, u otro usuario puede también ejecutar algo como si pareciera la terminal de root

    # export ARCH=i686; sbopkg

El usuario puede también añadir manualmente su archivo sbopkg.conf si desea. Finalmente, si ARCH no esta establecida por el usuario y sbopkg no detectara una de las arquitecturas previamente mencionadas, entonces ARCH sera establecida por cualquiera que este en los SlackBuilds. Nótese que un SlackBuild puede, en algunas ocasiones, descartar o sobreescribir las anteriores configuraciones de ARCH si es requerido para la construcción del paquete.

ARCHIVOS

/etc/sbopkg/sbopkg.conf
    Archivo que especifica opciones de configuración.

~/.sbopkg.conf
    Archivo que sobreescribe las opciones del sistema.

/etc/sbopkg/renames.d/*.renames
    Archivo por defecto que lista software en el repositorio SBo que ha sido renombrado. Ver el documento README-renames en el directorio de documentación de sbopkg para mas información.

/etc/sbopkg/repos.d/*.repo
    Archivos para varios tipos de repositorios de sbopkg . Ver el documento README-repos en el directorio de documentación de sbopkg para mas información.

AUTORES
Willy Sudiarto Raharjo <willysr@sbopkg.org> Chess Griffin <chess@chessgriffin.com>

Mauro Giachero <mauro.giachero@gmail.com>

slakmagik <slakmagik@gmail.com>

SEE ALSO
diff(1), rsync(1), sbopkg(8), uname(1), wget(1), /usr/doc/sbopkg-xxxVERSIONxxx/*

TRADUCCION
Esta traducción ha sido realizada por Pablo Castaño Fernández <waruto@hurricane-project.org> el 17 de Enero de 2011.

Actualizado por Dhaby Xiloj <slack.dhabyx@gmail.com> el 06 de Enero de 2016.