commit 635cf79ace10cd6cf23193199f31df23acb119d1 Author: manudocker Date: Wed Sep 14 10:58:18 2022 +0200 Traduccion manual comandos onedrive diff --git a/README.md b/README.md new file mode 100644 index 0000000..a48ac0a --- /dev/null +++ b/README.md @@ -0,0 +1,304 @@ +# onedrive - Página de manual +***Sincronización de carpetas con OneDrive*** + +--- + + +## Sinopsis +`onedrive [OPCIÓN] --sincronizar`
+`onedrive [OPCIÓN] --monitor`
+`onedrive [OPCIÓN] --display-config`
+`onedrive [OPCIÓN] --mostrar-estado-de-sincronización` + +--- + +## Descripción +Herramienta CLI para interactuar con OneDrive desde la terminal Linux. + +--- +## Opciones +Si no se da ninguna opción, no se realiza ninguna sincronización y el programa se cierra. + +`--auth-files ARG`
+Realiza la autorización a través de dos archivos pasados como ARG en el formato authUrl:responseUrl. La URL de autorización se escribe en authUrl, luego onedrive espera que el archivo responseUrl esté presente, y lee la respuesta de ese archivo. + +`--auth-response ARG`
+Realiza la autenticación no a través de un diálogo interactivo, sino proporcionando la url de respuesta directamente. + +`--check-for-nomount`
+Comprueba la presencia de .nosync en la raíz de syncdir. Si se encuentra, no realiza la sincronización. +Clave del archivo de configuración: check_nomount (por defecto: false) + +`--check-for-nosync`
+Comprueba la presencia de .nosync en cada directorio. Si se encuentra, omite el directorio de la sincronización. +Clave del archivo de configuración: check_nosync (por defecto: false) + +`--classify-as-big-delete`
+Número de hijos de una ruta que se elimina localmente y que se clasificará como un "gran borrado de datos +Clave del archivo de configuración: classify_as_big_delete (por defecto: 1000) + +`--confdir ARG`
+Establece el directorio utilizado para almacenar los archivos de configuración + +`--create-directory ARG`
+Crea un directorio en OneDrive - no se realizará ninguna sincronización. + +`--create-share-link ARG`
+Crea un enlace compartible para un archivo existente en OneDrive + +`--debug-https`
+Depurar la comunicación HTTPS de OneDrive.
+Clave del archivo de configuración: debug_https (por defecto: false) + +`--destination-directory ARG`
+Directorio de destino para renombrar o mover en OneDrive - no se realizará ninguna sincronización. + +`--disable-download-validation`
+Desactivar la validación de descargas cuando se descargan desde OneDrive
+Clave del archivo de configuración: disable_download_validation (por defecto: false) + +`--disable-notifications`
+No utilizar las notificaciones del escritorio en el modo de monitorización
+Clave del archivo de configuración: disable_notifications (por defecto: false) + +`--disable-upload-validation`
+Desactivar la validación de la carga cuando se sube a OneDrive +Clave del archivo de configuración: disable_upload_validation (por defecto: false) + +`--display-config`
+Muestra las opciones que el cliente utilizará tal y como están configuradas actualmente; no se realizará ninguna sincronización. + +`--display-sync-status`
+Muestra el estado de sincronización del cliente - no se realizará ninguna sincronización. + +`--download-only`
+Replica el estado en línea de OneDrive localmente, descargando sólo los cambios de OneDrive. No subir los cambios locales a OneDrive.
+Clave del archivo de configuración: download_only (por defecto: false) + +`--dry-run`
+Realiza una sincronización de prueba sin realizar cambios. Sólo puede utilizarse con `--synchronize`. Se ignorará para `--monitor`
+Clave del archivo de configuración: dry_run (por defecto: false) + +`--enable-logging`
+Habilitar la actividad del cliente en un archivo de registro separado
+Clave del archivo de configuración: enable_logging (por defecto: false) + +`--force`
+Forzar el borrado de datos cuando se detecta un 'big delete' + +`--force-http-11`
+Forzar el uso de HTTP 1.1 para todas las operaciones
+Clave del archivo de configuración: force_http_11 (por defecto: false) + +`--force-sync`
+Forzar la sincronización de una carpeta específica, sólo cuando se utiliza `--synchronize --single-directory` e ignorar +todas las reglas skip_dir y skip_file no predeterminadas + +`--get-O365-drive-id ARG`
+Consulta y devuelve el ID de unidad de Office 365 para una determinada biblioteca compartida de SharePoint de Office 365 + +`--get-file-link ARG`
+Muestra el enlace de un archivo sincronizado + +`--list-shared-folders`
+Lista de carpetas compartidas de OneDrive Business + +`--local-first`
+Sincronizar primero desde el origen del directorio local, antes de descargar los cambios desde OneDrive.
+Clave del archivo de configuración: local_first (por defecto: false) + +`--logout`
+Cerrar la sesión del usuario actual + +`--log-dir ARG`
+define el directorio donde se guarda la salida del registro, debe terminar con una barra
+Clave del archivo de configuración: log_dir (por defecto: /var/log/onedrive/) + +`--min-notify-changes`
+el número mínimo de cambios entrantes pendientes necesarios para activar una notificación en el escritorio
+Clave del archivo de configuración: min_notify_changes (por defecto: 5) + +'-m --modified-by ARG`
+Muestra los detalles de la última modificación por de una ruta determinada + +`-m --monitor`
+Mantener la monitorización de los cambios locales y remotos + +`--monitor-interval ARG`
+El número de segundos por el que se realiza cada operación de sincronización cuando está inactivo en el modo de monitorización
+Clave del archivo de configuración: monitor_interval (por defecto: 300) + +`--monitor-fullscan-frequency ARG`
+Número de ejecuciones de sincronización antes de realizar un escaneo local completo del directorio sincronizado
+Clave del archivo de configuración: monitor_fullscan_frequency (por defecto: 10) + +`--monitor-log-frequency ARG`
+Frecuencia de registro en el modo de monitorización
+Clave del archivo de configuración: monitor_log_frequency (por defecto: 5) + +`--no-remote-delete`
+No eliminar los archivos locales 'borrados' de OneDrive cuando se utiliza `--upload-only`
+Clave del archivo de configuración: no_remote_delete (por defecto: false) + +`--operation-timeout ARG`
+Establece la cantidad máxima de tiempo (segundos) que puede durar una operación de archivo. Esto incluye la resolución de DNS, la conexión, la transferencia de datos, etc.
+Clave del archivo de configuración: operation_timeout (por defecto: 3600) + +`--print-token`
+Imprime el token de acceso, útil para la depuración + +`--reauth`
+Reautenticar el cliente con OneDrive + +`--remove-directory ARG`
+Elimina un directorio en OneDrive - no se realizará ninguna sincronización. + +`--remove-source-files`
+Eliminar el archivo de origen después de la transferencia exitosa a OneDrive cuando se utiliza `--upload-only`
+Clave del archivo de configuración: remove_source_files (por defecto: false) + +`--resync`
+Olvida el último estado guardado, realiza una sincronización completa + +`--resync-auth`
+Aprueba el uso de realizar una acción `--resync` sin necesidad de autorización de la CLI + +`--single-directory ARG`
+Especificar un único directorio local dentro de la raíz de OneDrive para sincronizar. + +`--skip-dir ARG`
+Omite la sincronización de cualquier directorio que coincida con este patrón + +`--skip-dir-strict-match`
+Cuando se comparan los directorios de skip_dir, sólo coinciden las coincidencias explícitas
+Clave del archivo de configuración: skip_dir_strict_match (por defecto: false) + +`--skip-dot-files`
+Omitir la sincronización de archivos y carpetas de puntos
+Clave del archivo de configuración: skip_dotfiles (por defecto: false) + +`--skip-file`
+Omitir la sincronización de cualquier archivo que coincida con este patrón
+Clave del archivo de configuración: skip_file (por defecto: ~*|.~*|*.tmp) + +`--skip-tamaño ARG`
+Omitir los archivos nuevos que superen este tamaño (en MB) + +`--skip-symlinks`
+Omitir la sincronización de los enlaces simbólicos
+Clave del archivo de configuración: skip_symlinks (por defecto: false) + +`--source-directory ARG`
+Directorio de origen para renombrar o mover en OneDrive - no se realizará ninguna sincronización. + +`--reservación de espacio ARG`
+La cantidad de espacio en disco a reservar (en MB) para evitar la utilización del 100% del espacio en disco + +`--sync-root-files`
+Sincroniza todos los archivos en sync_dir root cuando se utiliza sync_list. + +`--sync-shared-folders`
+Sincronizar las carpetas compartidas de OneDrive Business
+Clave del archivo de configuración: sync_business_shared_folders (por defecto: false) + +`--syncdir ARG`
+Establecer el directorio utilizado para sincronizar los archivos que se sincronizan
+Clave del archivo de configuración: sync_dir (por defecto: ~/OneDrive) + +`--sincronizar`
+Realiza una sincronización + +`--solo-carga`
+Replica el estado de sync_dir configurado localmente a OneDrive, subiendo sólo los cambios locales a OneDrive. No descargue los cambios de OneDrive.
+Clave del archivo de configuración: upload_only (por defecto: false) + +`--user-agent ARG`
+Establece el identificador de agente de usuario utilizado
+Clave del archivo de configuración: user_agent (por defecto: no cambiar) + +`-v --verbose`
+Imprime más detalles, útiles para la depuración. Si se da dos veces (o más), se pueden obtener declaraciones de depuración aún más detalladas. + +`--versión`
+Imprime la versión y sale + +`-h --help`
+Esta información de ayuda. + +--- +## Características +- Caché de estado +- Monitorización de archivos en tiempo real con Inotify +- Validación de carga/descarga de archivos para garantizar la integridad de los datos +- Cargas reanudables +- Compatibilidad con OneDrive for Business (parte de Office 365) +- Soporte de carpetas compartidas para cuentas de OneDrive Personal y OneDrive Business +- Bibliotecas compartidas de SharePoint / Office365 +- Notificaciones de escritorio a través de libnotify +- Capacidad de ejecución en seco para probar los cambios de configuración +- Prevención de la eliminación accidental de datos de OneDrive tras un cambio de configuración +- Compatibilidad con implementaciones en la nube nacional (Microsoft Cloud para el Gobierno de los Estados Unidos, Microsoft Cloud Alemania, Azure y Office 365 operado por 21Vianet en China) + +--- +## Configuración +Debe copiar el archivo de configuración por defecto en su directorio principal antes de realizar cambios: +``` +mkdir -p ~/.config/onedrive +cp @DOCDIR@/config ~/.config/onedrive/config +``` +Para ver las opciones soportadas, consulte la lista anterior de opciones de línea de comandos para la disponibilidad de una clave de configuración. + +Los patrones no distinguen entre mayúsculas y minúsculas. Se admiten los caracteres comodín `*` y `?` Utilice | para separar varios patrones. + +Después de cambiar los filtros (`skip_file` o `skip_dir` en sus configuraciones) debe ejecutar: +``` +onedrive --synchronize --resync +``` + +--- +## Primera ejecución +Después de instalar la aplicación debes ejecutarla al menos una vez desde la terminal para autorizarla. + +Se te pedirá que abras un enlace específico usando tu navegador web donde tendrás que iniciar sesión en tu cuenta de Microsoft y darle a la aplicación el permiso para acceder a tus archivos. Después de dar el permiso, serás redirigido a una página en blanco. Copie el URI de la página en blanco en la aplicación. + +--- +## Integración de Systemd +Los archivos de servicio se instalan en los directorios del usuario y del sistema. + +### El servicio OneDrive se ejecuta como usuario root +Para habilitar este modo, ejecute como usuario root +``` +systemctl enable onedrive +systemctl start onedrive +``` +### El servicio OneDrive se ejecuta como usuario root para un usuario no root +Este modo permite iniciar el servicio OneDrive automáticamente con el inicio del sistema para varios usuarios. Para cada `` ejecute +``` +systemctl enable onedrive@ +systemctl start onedrive@ +``` +### Servicio OneDrive ejecutado como usuario no root +En este modo, el servicio se iniciará cuando el usuario inicie sesión. Ejecutar como usuario +``` +systemctl --user enable onedrive +systemctl --user start onedrive +``` +--- +## Registro de resultados +Cuando se ejecuta onedrive, todas las acciones pueden ser registradas en un archivo de registro separado. Esto se puede habilitar utilizando la bandera `--enable-logging`. Por defecto, los archivos de registro se escribirán en `/var/log/onedrive`. + +Todos los archivos de registro tendrán el formato de `%nombredeusuario%.onedrive.log`, donde `%nombredeusuario%` representa el usuario que ejecutó el cliente. + +--- +## Notificaciones +Si OneDrive ha sido compilado con soporte para notificaciones, un onedrive en funcionamiento en modo monitor enviará notificaciones sobre la inicialización y los errores a través de libnotify al dbus. + +Tenga en cuenta que esto no funciona si onedrive se inicia como root para un usuario a través del servicio `onedrive@`. + +--- +## Vea también +Más ejemplos y documentación en [yannisdran/onedrive](https://github.com/yannisdran/onedrive) + +--- +## Información +*Julio 2022 v2.4.20* \ No newline at end of file