Feature #15599

Improve known issues about clock going backwards

Added by sajolida 2018-05-09 07:44:32 . Updated 2019-08-11 17:00:39 .

Status:
Resolved
Priority:
Elevated
Assignee:
Category:
Time synchronization
Target version:
Start date:
2018-05-09
Due date:
% Done:

0%

Feature Branch:
doc/15599-known-issue-clock-backwards
Type of work:
End-user documentation
Blueprint:

Starter:
Affected tool:
Deliverable for:

Description

We already have:

“Problems when the system clock goes backwards” in https://tails.boum.org/support/known_issues/#index21h2

We should improve it to:

  • Add an HTML anchor (‘’).
  • Add Bug #15548 to the list of symptoms.

Subtasks


Related issues

Related to Tails - Bug #15548: Tails can't establish a connection with obfs4 bridges and a hardware clock too far away from UTC Confirmed 2018-05-09
Related to Tails - Bug #17525: obfs4 documentation does not mention the need for a hardware clock set to UTC Confirmed
Blocks Tails - Feature #15941: Core work 2018Q4 → 2019Q2: Technical writing Resolved 2018-09-11

History

#1 Updated by sajolida 2018-05-09 07:44:43

  • blocks Feature #15411: Core work 2018Q2 → 2018Q3: Technical writing added

#2 Updated by intrigeri 2018-06-26 16:28:06

  • Target version changed from Tails_3.8 to Tails_3.9

#3 Updated by sajolida 2018-07-19 08:44:09

  • Description updated

#4 Updated by cbrownstein 2018-08-05 07:48:46

  • Status changed from Confirmed to In Progress

#5 Updated by cbrownstein 2018-08-05 08:25:03

  • Assignee changed from cbrownstein to sajolida
  • QA Check set to Info Needed

sajolida wrote:
> We already have:
>
> “Problems when the system clock goes backwards” in https://tails.boum.org/support/known_issues/#index21h2
>
> At least:
>
> * Add an HTML anchor (‘’).
> * Build a list of symptoms and add Bug #15548 to it.

Do you know of, or do you know where I can find a list of, symptoms other than obfs4 bridges not working (Bug #15548)? Should I add just that for right now?

#6 Updated by sajolida 2018-08-11 08:21:23

> Do you know of, or do you know where I can find a list of, symptoms other than obfs4 bridges not working (Bug #15548)? Should I add just that for right now?

Sorry but I don’t :(

I’d make it so the list is easily expandable (bullet list?) and, for
now, only mention obfs4 bridges not working and the Applications menu
sometimes stops working (see /support/known_issues/#index21h2).

And ask intrigeri :)

#7 Updated by sajolida 2018-08-11 08:21:49

  • Assignee changed from sajolida to cbrownstein
  • QA Check deleted (Info Needed)

#8 Updated by intrigeri 2018-09-05 16:27:01

  • Target version changed from Tails_3.9 to Tails_3.10.1

#9 Updated by sajolida 2018-09-11 18:07:52

  • blocks Feature #15941: Core work 2018Q4 → 2019Q2: Technical writing added

#10 Updated by sajolida 2018-09-11 18:07:57

  • blocked by deleted (Feature #15411: Core work 2018Q2 → 2018Q3: Technical writing)

#11 Updated by intrigeri 2018-10-24 17:03:46

  • Target version changed from Tails_3.10.1 to Tails_3.11

#12 Updated by sajolida 2018-11-18 17:31:48

  • Assignee changed from cbrownstein to intrigeri
  • QA Check set to Info Needed

intrigeri: Would you mind enlightening Cody on the possible symptoms and consequences of a system clock going backwards (on top of broken obfs4 bridges)?

#13 Updated by sajolida 2018-11-18 17:32:01

  • Target version deleted (Tails_3.11)

#14 Updated by intrigeri 2018-11-19 16:13:09

  • Assignee changed from intrigeri to cbrownstein
  • QA Check changed from Info Needed to Dev Needed

> intrigeri: Would you mind enlightening Cody on the possible symptoms and consequences of a system clock going backwards (on top of broken obfs4 bridges)?

This is about a very generic class of problems: any software that relies on the system clock (as opposed to a monotonic time source) and makes decision based on time differences is potentially affected. This affects primarily time going backwards: much software is not prepared for this sort of events (granted, I’m not well prepared either :) and can simply crash. I’m afraid I have no specific example in mind except those referenced on this ticket and the one that made us add this to the list of known issues (Bug #14250). It seems there are quite a few there: https://github.com/search?q=when+time+goes+backwards&type=Issues. So it’s more of a generic “don’t do that, unspecified bad things will happen” kind of thing. If that’s not good enough, I can try to find a couple more specific examples that might speak to our intended audience, but it’ll take me quite some time so I’m not sure it’s worth it.

In passing, iime going forward can also be an issue in theory, but I expect that most software we run on a desktop these days expects sudden jumps into the future, simply because sleep & hibernation have become so common. So I don’t think it’s worth mentioning it.

#15 Updated by sajolida 2018-12-13 15:39:48

  • Description updated

The problem here is that changing the clock backwards is not something that people decide to do. So we can’t tell them “don’t do that”. Anyway, it seems like we won’t be able to provide very helpful instructions anyway so I’d like to close this ticket as cheaply as possible.

Cody, I think you should do only what’s described in the ticket description:

  • Add an HTML anchor (‘’).
  • Add Bug #15548 to the list of symptoms.

Updating it accordingly…

#16 Updated by intrigeri 2018-12-17 16:06:07

> The problem here is that changing the clock backwards is not something that people decide to do. So we can’t tell them “don’t do that”.

Clarification: I was not suggesting we should tell them to users (“people”). This was about “any software that relies on the system clock (as opposed to a monotonic time source) and makes decision based on time differences is potentially affected” i.e. software developers. I was asked about symptoms so please don’t try to find solutions in my answer :)

> Anyway, it seems like we won’t be able to provide very helpful instructions anyway so I’d like to close this ticket as cheaply as possible.

Absolutely: we’ve already documented how to set the RTC to UTC (which solves the problem) and the next step is clear (Bug #15168).

#17 Updated by sajolida 2019-02-21 07:46:14

I’ll send you a branch today! :)

#18 Updated by sajolida 2019-02-21 09:01:03

  • QA Check changed from Dev Needed to Ready for QA
  • Feature Branch set to doc/15599-known-issue-clock-backwards

Here you go.

#19 Updated by cbrownstein 2019-02-22 10:01:07

  • Assignee changed from cbrownstein to sajolida
  • QA Check changed from Ready for QA to Pass

Looks good!

#20 Updated by sajolida 2019-03-04 11:31:15

  • Status changed from In Progress to Resolved
  • Assignee deleted (sajolida)

Merged

#21 Updated by intrigeri 2019-08-11 17:00:39

#22 Updated by intrigeri 2019-08-11 17:01:09

  • related to Bug #15548: Tails can't establish a connection with obfs4 bridges and a hardware clock too far away from UTC added

#23 Updated by intrigeri 2020-03-15 10:24:21

  • related to Bug #17525: obfs4 documentation does not mention the need for a hardware clock set to UTC added