Obtener ayuda e información de versión

Traducción automática provisional, sin revisar. En caso de duda, consulte la versión en inglés, que es la versión de referencia.

Kent responde a dos preguntas sin tocar ninguna base de datos: qué sabe hacer y qué versión es.

kent help y kent --help

Ambos listan todos los comandos y opciones con una descripción de una línea de lo que hacen, y la salida es idéntica en los dos casos. Escriba el que le resulte más natural.

$ kent help
kent works with Cordelia databases from the command line.

Usage:

    kent <command> [arguments]

The commands are:

    help
        print this message
    createdb <dbfilename>
        create an empty database, stamped with the schema version this build expects
    info <dbfilename>
        report the schema version and a row count for each table that holds rows
    details <dbfilename>
        as info, plus the tables it leaves out and the file's own attributes
    files <dbfilename>
        list the .FIT files the database was built from
    activities <dbfilename>
        list each recorded activity with its dates and sport
    sports <dbfilename>
        list the distinct sports and sub-sports present in the database
    verify <dbfilename>
        check the database's structure against the schema this build creates
    sqldump --in <dbfilename> [--out <outfile>] [--schema-only]
        write the database out as SQL that recreates it when replayed
    archive --in <dbfilename> --out <archive>
        write the database to a .kent archive, for other tools to read
    restore --in <archive> --out <dbfilename>
        rebuild a database from a .kent archive

The flags are:

    --version
        print kent's version, and the version of each library it was built against
    --devinfo
        the same, with each build's commit hash; quote this in a defect report
    --help
        print this message
    --license
        print the licence kent is distributed under
    --privacy
        print kent's privacy policy

See "man kent" for the full description of any command.

Ese listado es todo lo que Kent sabe hacer. Cualquier cosa que no aparezca ahí no es un comando que Kent entienda; véase Mensajes de error y códigos de salida para saber qué ocurre cuando lo intenta, y el Plan de producto para lo que pueda añadirse más adelante.

Es también el listado en el que confiar por encima de esta página. Kent lo genera a partir de su propia tabla de comandos, así que no puede describir un comando que Kent no tenga.

kent --version

Imprime la versión del propio Kent y después una línea por cada biblioteca incluida en él. Kent usa el código de base de datos de Cordelia, una capa SQLite compartida, la biblioteca de archivado que usan sus archivos .kent y una biblioteca base compartida. Dos de ellas incluyen bibliotecas externas, y cada una aparece justo después de la biblioteca que la incluye: SQLite después de la capa SQLite, y las dos bibliotecas de compresión después de la biblioteca de archivado.

$ kent --version
kent version 1.3.4 uses
    cordelia 1.3.3
    curan 1.0.0
    SQLite 3.53.4
    regan 1.1.0
    zlib-ng 2.3.3
    minizip-ng 4.2.2
    goneril 1.4.1

Cada número procede de la compilación de su propio componente, así que se mueven de forma independiente. Un Kent compilado contra una Cordelia más nueva informa aquí de esa Cordelia más nueva sin que cambie la versión del propio Kent.

kent --devinfo

Imprime la misma lista con un identificador de compilación tras cada versión, que indica exactamente qué compilación de cada componente tiene. Las bibliotecas externas muestran las mismas versiones que arriba, porque cada una es una versión publicada fija.

$ kent --devinfo
kent version 1.3.4-d9c6caf76b uses
    cordelia 1.3.3-1f754c95d6
    curan 1.0.0-200cf6264e
    SQLite 3.53.4
    regan 1.1.0-4b4934c37f
    zlib-ng 2.3.3
    minizip-ng 4.2.2
    goneril 1.4.1-06a94fe891

Esta es la salida que citar al informar de un problema; véase Informes de errores y solicitudes de funciones.

kent --license y kent --privacy

Estas dos imprimen un documento y salen. --license imprime los términos bajo los que se distribuye Kent; --privacy imprime su política de privacidad, que en resumen dice que Kent no realiza conexiones de red, no recopila nada y solo lee y escribe las rutas que usted indique en su propia línea de comandos.

$ kent --license | less
$ kent --privacy | less

Ambos textos se compilan dentro del programa a partir de los mismos archivos que publica el proyecto, de modo que la copia que imprime Kent no puede desviarse de la copia de este sitio; véase la Licencia y la Política de privacidad.

Su texto va a la salida estándar y no a la salida de error, porque es la salida que usted ha pedido y no un diagnóstico. Eso es lo que hace que funcione la tubería hacia less de arriba.

A dónde va la salida

La mayoría de los comandos de Kent lo imprimen todo por la salida estándar, mensajes de error incluidos, así que redirigir la salida estándar a un archivo captura una transcripción completa:

$ kent info mydata.sqlite > report.txt

sqldump y archive son distintos, deliberadamente: todo lo que imprimen, errores y avisos por igual, va a la salida de error. Para sqldump eso es esencial, porque si se omite --out el propio script exportado ocupa la salida estándar, y un mensaje impreso ahí quedaría intercalado en él sin avisar.

$ kent sqldump --in old.sqlite > old.sql   # only the script lands in the file
$ kent sqldump --in old.sqlite 2> errors.txt   # only the messages land here