rclone/rclone

add ability to signal rclone to finish current partial task and exit

Open

#966 opened on Dec 20, 2016

View on GitHub
 (9 comments) (28 reactions) (0 assignees)Go (57,185 stars) (5,090 forks)batch import
API / Remote Control / RCOS: Unixenhancementfsnotify / eventshelp wantedintegration

Description

It'd be convenient to be able to signal rclone (perhaps via a SIGUSR1 or SIGUSR2?) to finish up working on the current transfers and then exit so uploads aren't left in a half state. Or perhaps SIGINT? One ctrl-c on the terminal or from external source could tell it to finish up and exit while a second SIGINT would instruct it to exit immediately.

Contributor guide

Tech stack
go
Domain
clibackend
Issue type
feature
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
3
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
1-2 days
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
stale
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
clear
Prerequisites
Go programmingsignal handling in Gobasic CLI design
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
30
Research direction
Investigate Go's os/signal package to catch SIGINT, SIGTERM, and possibly SIGUSR1/SIGUSR2. Identify where rclone's main transfer loop runs (likely in command/ operations). Implement a graceful shutdown that waits for current transfers to finish before exiting. Add documentation for the new behavior. Consider using a context with cancellation or a channel to signal the main loop.