kdesrc-build: en línea en la nube

PROGRAMA:

NOMBRE

kdesrc-build: descarga, compila e instala el software KDE.

SINOPSIS

kdesrc-construir [CAMPUS...] [Módulo nombre | Módulo set nombre ...]

DESCRIPCIÓN

El kdesrc-construir El comando se utiliza para construir software KDE directamente desde su fuente.
repositorios. Puede descargar desde repositorios de Subversion o Git, interfaces con KDE
base de datos del proyecto, y admite el control de las opciones que se pasan a para lograr(1) y
cmake(1). La operación de kdesrc-construir es manejado por un archivo de configuración, típicamente
~ / .kdesrc-buildrc.

El módulo nombre or módulo set nombre como se indica en la línea de comando debe ser como esos nombres
se definieron en el archivo de configuración (ya sea en una definición de módulo o módulos de uso
declaración, o en una conjunto de módulos definición). Además, puede ser el nombre de un KDE
módulo listado en la base de datos del proyecto de KDE (y puede preceder el nombre del módulo con + para
forzar esto).

kdesrc-construir está diseñado para ser completamente descabezado (sin embargo, consulte MEDIO AMBIENTE),
por lo que normalmente ignora su entrada por completo. La salida del comando se registra en lugar de
que se muestra en la salida de kdesrc-build.

Los módulos se construyen uno tras otro. Si un módulo no se actualiza, entonces no está construido.
kdesrc-construir no abortará solo por una falla del módulo, sino que seguirá intentándolo
para actualizar y construir módulos posteriores. Por defecto, kdesrc-construir comenzará a construir un
módulo tan pronto como se complete la actualización del código fuente para ese módulo, incluso si otros
las actualizaciones se están produciendo al mismo tiempo.

Al final kdesrc-construir mostrará qué módulos no se pudieron construir y dónde estaban los registros
guardado para esa ejecución de compilación.

CAMPUS

NOTA: Algunas opciones tienen formas cortas, pero el kdesrc-construir el analizador de opciones no es compatible
combinando opciones cortas en una en este punto. (Por ejemplo, correr kdesrc-construir -pv no lo haría
ser el mismo que kdesrc-construir --pretender --verboso).

-h, --ayuda
Muestra una breve sinopsis y opciones de línea de comandos de uso frecuente.

-pag, --pretender
Opere en un modo de "funcionamiento en seco". No se realizan accesos a la red, no se crean archivos de registro,
no se construyen módulos y no se realizan otros cambios permanentes en el disco. Uno importante
excepción es que si intentas construir un módulo que provenga del proyecto KDE
base de datos, y la base de datos aún no se ha descargado, la base de datos se descargará
ya que la salida del modo de simulación puede cambiar significativamente en función de los resultados de la base de datos.

--Instalar en pc
Omite la fase de actualización y compilación e inmediatamente intenta instalar los módulos
dado.

--desinstalar
Omite la fase de actualización y compilación e inmediatamente intenta desinstalar los módulos
dado. NOTA: Esto solo es compatible con los sistemas de compilación que admiten el para lograr Desinstalar
comando (por ejemplo, basado en KDE CMake).

--no-src
Omite la fase de actualización de la fuente. Otras fases se incluyen normalmente. --no-svn es un
alias obsoleto para esta opción y se eliminará en una versión futura.

--no-instalar
Omite la fase de instalación de la compilación. Otras fases se incluyen normalmente.

--no construir
Omite la fase de construcción de la construcción. Internamente, la fase de instalación depende de la compilación.
finalización de la fase, por lo que esto es efectivamente equivalente a --src-solo, pero la semántica
puede cambiar en el futuro (por ejemplo, cuando los conjuntos de pruebas se mueven a su propia fase).

--no pruebas
Desactiva la ejecución del conjunto de pruebas para módulos basados ​​en CMake. Para ser completamente efectivo esto
requiere volver a ejecutar CMake, que se puede forzar utilizando el - reconfigurar or
--actualizar-construir .

--src-solo
Solo realiza la fase de actualización de la fuente, no construye ni instala. --svn-solo es un
alias obsoleto para esta opción y se eliminará en una versión futura.

--construir solo
Obliga a que el proceso de compilación se realice sin actualizar primero el código fuente. En
Además, no se realiza la instalación. (Las pruebas aún se realizan si corresponde,
pero esto cambiará en una versión futura)

--actualizar-construir
Elimina el directorio de compilación de un módulo antes de que comience la fase de compilación. Esto tiene el
efecto secundario deseado de forzar kdesrc-construir para reconfigurar el módulo y construirlo
desde un estado "prístino" sin archivos de salida intermedios o temporales existentes. Usar
esta opción si tiene problemas para construir un módulo pero se da cuenta de que se necesitará
más tiempo (posiblemente mucho más) para que la compilación se complete como resultado. En caso de duda, utilice
esta opción para todo kdesrc-construir huye.

- reconfigurar
Obligar a que se vuelva a ejecutar CMake, pero sin eliminar el directorio de compilación. Usualmente tu
realmente quiero --actualizar-construir, pero si está 100% seguro de que cambia a opciones de cmake
no invalidará su salida intermedia actual, entonces esto puede ahorrar algo de tiempo.

--construir-sistema-solo
Interrumpe el proceso de construcción para cada módulo construido: El proceso de construcción consiste en
configuración normal hasta e incluyendo ejecución cmake or configurar (según corresponda), pero para lograr
no se ejecuta y no se intenta la instalación. En su mayoría, esto solo es útil para obtener cosas
como configurar --ayuda y cmake-gui trabajar. Normalmente quieres - reconfigurar or
--actualizar-construir.

--resume-from =foo
Utilice esta opción para omitir el procesamiento del módulo hasta que el módulo foo se encuentra foo
y todos los módulos posteriores se procesarán normalmente como si se hubieran especificado en
la línea de comando. Si usa esta opción debido a un error de compilación, es posible que desee
Considere usar --no-src además de omitir la fase de actualización de la fuente resultante.

--resume-after =foo
Esto es como - reanudar desde, excepto que el módulo foo is no incluido en el
lista de módulos a considerar. Puede usar esto si ha construido / instalado manualmente foo
después de arreglar la compilación y solo quiero reanudar desde allí.

- ignorar-módulos
Fuerzas TODAS módulos que siguen esta opción para ser excluidos de la consideración por
kdesrc-construir. Esto puede resultar útil si sabe que desea procesar todos los módulos excepto
para excepciones específicas.

--rc-file =foo
Usa el archivo dado, foo, para la configuración en lugar de ~ / .kdesrc-buildrc or
./kdesrc-buildrc. El archivo puede estar vacío, pero debe existir.

--prefix =foo
Anula el kdedir configuración para ser foo para esta carrera. Además, implica
- reconfigurar. Lo sí no Realmente realiza la acción que crees que hace.
(anulando el prefijo opción de cambiar dónde están instalados los módulos), aunque por
los módulos predeterminados están instalados en el kdedir configurando si prefijo no está configurado.

--nice =foo
Cambia la prioridad de la CPU dada a kdesrc-construir (y todos los procesos utilizados por kdesrc-construir
p.ej para lograr(1)). foo debe ser un número entero entre -20 y 19. Valores positivos
son "más agradables" para el resto del sistema (es decir, de menor prioridad).

Tenga en cuenta que las posibles prioridades disponibles en su sistema pueden ser diferentes a las
enumerados aquí, ver agradable(2) para obtener más información. Tenga en cuenta también que esto solo cambia CPU
prioridad, a menudo quieres cambiar I / O prioridad en los sistemas en los que se admite.
No hay una opción de línea de comandos para el ajuste de prioridad de E / S, pero hay una
opción de archivo de configuración: uso-inactivo-io-prioridad (aunque como todas las opciones, hay una
forma genérica de configurar esto desde la línea de comando).

--run =foo
Ejecuta el programa nombrado por foo usando kdesrc-construirentorno de construcción normal. Todos
los argumentos de la línea de comando presentes después de esta opción se pasan a foo mientras se ejecuta.

--color
Habilita la "salida colorida". (Habilitado de forma predeterminada).

--sin color
Desactiva la "salida colorida". Esto se puede hacer permanente configurando el salida colorida
opción a falso (o 0) en su archivo de configuración.

--asíncrono
Tienen kdesrc-construir iniciar el proceso de compilación de un módulo tan pronto como el código fuente haya
terminado de descargar. Sin esta opcion kdesrc-construir realiza todas las actualizaciones de la fuente en
una vez y solo entonces comienza con el proceso de construcción. Esta opción está activada de forma predeterminada.

--no-asincrónico
Desactiva la construcción asincrónica de módulos. Ver --asíncrono para un más detallado
descripción. Tenga en cuenta que kdesrc-construirLa salida será ligeramente diferente en este modo.

-v, --verboso
Aumenta el nivel de verbosidad de kdesrc-construir salida (que ya es bastante
¡verboso!)

-q, --tranquilo
Hace kdesrc-construir Menos ruidoso. Solo se muestran los mensajes importantes.

- realmente silencioso
Hace kdesrc-construir incluso menos ruidoso. Solo se muestran advertencias / errores.

--depurar
Esto llenará su terminal con descripciones y resultados de depuración, generalmente
ininteligible, describiendo lo que kdesrc-construir está haciendo (y cree que debería estar haciendo).
La bandera está incluida ya que la salida a veces puede resultar útil para la depuración.

--forzar-construir
Normalmente cuando kdesrc-construir advierte que no hay una actualización de la fuente en un módulo que
se instaló previamente con éxito, no intenta compilar o instalar ese
módulo. Puede pasar esta bandera para deshabilitar ese comportamiento y siempre ejecutar para lograr.

--no-instantáneas
Normalmente kdesrc-construir admite el uso de instantáneas de tarball del repositorio de origen para reducir
cargar en la infraestructura de KDE para clones de git para algunos módulos de KDE. Pasando esta opción
desactiva esta función.

- eliminar-mis-parches
Esta opción debe pasarse para permitir kdesrc-construir para eliminar la fuente conflictiva
directorios. Actualmente, incluso esto solo sucede cuando se intenta clonar un módulo basado en git
si hay un directorio fuente existente. Nunca especifique esta opción a menos que sea
sugerido por kdesrc-construir, y solo si no le importan los directorios de origen que están
se hace referencia a ser eliminado y vuelto a clonar.

--foo=de caramelos
Cualquier opción que no esté en la lista anterior se marca para ver si coincide con la lista de posibles
opciones del archivo de configuración. Si es así, la opción del archivo de configuración foo es temporalmente
establecido en de caramelos durante la duración de esta ejecución.

--módulo,foo=de caramelos
Como arriba, pero opción foo solo está configurado en de caramelos para el módulo módulo. Esto no lo hace
todavía funciona para conjuntos de módulos, debe repetir esto para cada módulo que desee ser
afectado. (Por supuesto, puede simplemente editar su archivo de configuración ...)

SALIR ESTADO

0
éxito

1
Normalmente, esto significa que alguna parte del proceso de actualización, compilación o instalación falló, pero es
También se utiliza para cualquier final de programa anormal que no se cubra a continuación.

5
Se recibió una señal que mató kdesrc-construir, pero intentó funcionar normalmente
cerrar.

8
Se pasó una opción desconocida en la línea de comando.

99
Se planteó una excepción que obligó kdesrc-construir abortar temprano.

MEDIO AMBIENTE

INICIO
Se utiliza para la expansión de tilde de nombres de archivos y es la base predeterminada para la fuente, compilación,
y directorios de instalación.

TRAYECTORIA
Esta variable de entorno controla la ruta de búsqueda predeterminada para ejecutables. Usted puede
utilizar el camino bin opción de archivo de configuración para agregar a esta variable (por ejemplo, para ejecutar
en cron(8)).

LC_*
Las variables de entorno que comienzan con LC_ controlan la configuración regional utilizada por kdesrc-construir.
Aunque kdesrc-construir todavía no es localizable en este punto, muchos de los comandos que
los usos son. kdesrc-construir normalmente establece LC_TODOS= C para comandos que deben examinar el
salida de pero también puede hacerlo manualmente. Si configura LC_TODOS= C corrige un
kdesrc-construir problema, envíe un informe de error.

SSH_AGENT_PID
Esta variable de entorno se comprueba para ver si ssh-agent(1) se está ejecutando, pero solo si
kdesrc-construir determina que está comprobando un módulo que requiere un inicio de sesión SSH
(pero debe saber esto ya que ningún módulo lo requiere de forma predeterminada).

KDESRC_BUILD_USE_TTY
Si se establece, esta variable fuerza kdesrc-construir no cerrar su entrada mientras se ejecuta
procesos del sistema. Normalmente kdesrc-construir cierra stdin desde stdout y stderr para
sus procesos secundarios son redirigidos y, por lo tanto, el usuario nunca verá una entrada
de todos modos.

KDESRC_BUILD_DUMP_CONTEXT
Si se establece, esta variable imprime una descripción de su "contexto de compilación" justo después
leer opciones y argumentos de línea de comando y determinar qué módulos construir. usted
prácticamente nunca quiero configurar esto.

otros
Muchos programas son utilizados por kdesrc-construir en el curso de su ejecución, incluyendo
svn(1) git(1) para lograr(1), y cmake(1). Cada uno de estos programas puede tener su propio
respuesta a las variables de entorno que se establecen. kdesrc-construir pasará el medio ambiente
variables que se establecen cuando se ejecuta en estos procesos. Puede asegurarse de que
variables de entorno (p. ej. CC or CXX) se establecen mediante el conjunto-env configuración
opción de archivo.

Use kdesrc-build en línea usando los servicios de onworks.net