Elencare i file importati con files

Traduzione automatica provvisoria, non revisionata. In caso di dubbio, consultare la versione inglese, che fa fede.

kent files elenca i file .FIT registrati in un database: una riga per ogni file mai importato in esso, nell'ordine in cui sono stati importati.

È di sola lettura e non tocca mai i file .FIT stessi. Legge soltanto ciò che il database ha registrato su di essi, il che significa che funziona anche quando i file originali sono spariti dalla macchina da tempo.

Sintassi

kent files <dbfilename>

Cosa mostra

$ kent files mydata.sqlite
Database:  mydata.sqlite

#  Imported              Created               Path
1  2026-08-12T09:14:03Z  2026-08-11T17:22:41Z  /home/user/rides/morning.fit  (Forerunner 965)
2  2026-08-14T20:41:55Z  2026-08-14T06:02:10Z  /home/user/rides/evening.fit
3  2026-08-15T11:00:00Z  -                     /home/user/rides/hike.fit

Colonna	Che cos'è
`#`	Il numero del file in questo database. Ogni attività, sessione e record del database rimanda a uno di questi, quindi è anche il numero da citare quando si vuole identificare un file. Viene assegnato in ordine di importazione.
`Imported`	Quando Cordelia ha importato il file. Sempre presente.
`Created`	Quando il dispositivo stesso ha scritto il file. Mostrato come `-` quando il file non lo riportava: non tutti i dispositivi lo registrano.
`Path`	Il file `.FIT` da cui è stato importato. È dove si trovava il file al momento dell'importazione; non viene verificato e potrebbe non essere più lì.

Un nome di dispositivo tra parentesi dopo il percorso compare solo quando il file ne portava uno. La maggior parte non lo fa, e una coppia di parentesi vuota su ogni riga sarebbe rumore.

La larghezza delle colonne segue il valore più lungo realmente presente, così un database di percorsi brevi non si ritrova con una colonna larga e quasi vuota.

Un database senza file

Un database creato ma mai importato stampa una semplice constatazione e riesce. Nessun file è una risposta, non un fallimento, e il codice di uscita è 0:

$ kent createdb mydata.sqlite
$ kent files mydata.sqlite
Database:  mydata.sqlite

No files recorded.
$ echo $?
0

In uno script questo conta: verificate il codice di uscita per sapere se Kent è riuscito a leggere il database, non se ha trovato qualcosa.

Un percorso che non esiste viene segnalato come mancante e non viene creato:

$ kent files nope.sqlite
kent files: nope.sqlite does not exist
$ echo $?
1

Un database più vecchio viene rifiutato

files rifiuta un database scritto da una Cordelia più vecchia di quella attesa da questa build, allo stesso modo di info e details. Legge colonne specifiche per nome, quindi un database vecchio che non le ha mai avute fallirebbe altrimenti con un errore SQLite grezzo anziché con una spiegazione.

kent sqldump e kent archive sono i due comandi che leggono comunque un database del genere: si veda Messaggi di errore e codici di uscita.

Cosa non è

files elenca i file che sono stati importati. Non elenca le attività al loro interno e non mostra nessuno dei dati registrati. Per i conteggi di ciò che contiene un database, si veda kent info e kent details; per leggere i dati stessi, si veda kent archive oppure Visualizzare i dati importati.