Home
About
Blog
Products
Forum
Support
Contact
Sunbelt Computer Software
PL/B Language Development and Support
Home
About
Blog
Products
Forum
Support
Contact
uMailServer/internal/queue/shutdown_race_test.go at main · uMailServer/uMailServer · GitHub
Skip to content
Navigation Menu
Sign in
Products
Platform
GitHub
Repository hosting, code review, and collaboration
Copilot
AI coding agent for tasks, projects and automated work
Build & Ship
Actions
CI/CD and automation
Code Quality
Quality analysis, fixes, and enforcement
Codespaces
Cloud development environments
Secure
Code Security
Vulnerability detection and remediation
Secret Protection
Secret scanning and leak prevention
All Features
Developers
Learn
Documentation
Training
Certifications
Build
Build with Copilot
Customize Copilot
Integrations
Explore
Trending repos
GitHub Sponsors
Events
Changelog
Changelog
Your source for the latest features, improvements, and fixes across GitHub products, all in one place.
Businesses
By Stage
Enterprises
Team
Startups
Nonprofits
By Industry
Healthcare
Financial services
Manufacturing
Government
See all industries
Evaluate GitHub
Why GitHub
Customer Stories
Business insights
Trust Center
Add-ons
GitHub Advanced Security
Enterprise-grade code security
Copilot for business
Enterprise-grade AI features
Premium Support
Enterprise-grade 24/7 support
Resources
Learn & Connect
Documentation
Resource center
Blog
Events & webinars
Community Forum
Customer Stories
Integrations
Support
Customer support
Training
GitHub Status
Company
About
Partners
Changelog
GitHub Universe
GitHub Universe
The event for developers, by developers — talks, workshops, and what’s next for GitHub.
Pricing
Search
/
Sign in
Sign up
Appearance settings
You signed in with another tab or window.
Reload
to refresh your session.
You signed out in another tab or window.
Reload
to refresh your session.
You switched accounts on another tab or window.
Reload
to refresh your session.
Dismiss alert
{{ message }}
uMailServer
uMailServer
Repository navigation
Code
Issues
1
(1)
Pull requests
Actions
Projects
Security and quality
Insights
More
items
Files
Expand file tree
main
Breadcrumbs
uMailServer
/
internal
/
queue
/
shutdown_race_test.go
Copy path
Blame
More file actions
Blame
More file actions
Latest commit
History
History
History
109 lines (99 loc) · 3.62 KB
main
Breadcrumbs
uMailServer
/
internal
/
queue
/
shutdown_race_test.go
Copy path
Top
File metadata and controls
Code
Blame
109 lines (99 loc) · 3.62 KB
Raw
Copy raw file
Download raw file
Open symbols panel
Edit and raw actions
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
package
queue
// Regression tests for the shutdown race: Manager.Stop() used to close
// deliveryChan while senders were still active — Enqueue (called by
// generateBounce on workers and by mail acceptance), EnqueueWithNotify,
// RetryEntry, and sweepPendingEntries all send on it. A send on a closed
// channel panics even inside select-with-default, so graceful shutdown could
// crash the whole process ("panic: send on closed channel", observed via
// generateBounce→Enqueue during Stop).
//
// Contract: Stop() must be safe at any point; mail accepted around a
// shutdown is kept pending in the queue database and retried on the next
// Start — never lost, never crashing.
import
(
"context"
"errors"
"io"
"log/slog"
"net"
"path/filepath"
"sync"
"testing"
"time"
"github.com/umailserver/umailserver/internal/db"
"github.com/umailserver/umailserver/internal/store"
)
// TestEnqueueAfterStopKeepsMailPending serializes the race deterministically:
// Stop() fully completes, then Enqueue runs. Pre-fix this panicked with
// "send on closed channel"; post-fix the entry is stored pending and picked
// up on the next Start.
func
TestEnqueueAfterStopKeepsMailPending
(
t
*
testing.
T
) {
dir
:=
t
.
TempDir
()
database
,
err
:=
db
.
Open
(
filepath
.
Join
(
dir
,
"q.db"
))
if
err
!=
nil
{
t
.
Fatalf
(
"open db: %v"
,
err
)
}
defer
database
.
Close
()
m
:=
NewManager
(
database
,
store
.
NewMaildirStore
(
dir
),
dir
,
slog
.
New
(
slog
.
NewTextHandler
(
io
.
Discard
,
nil
)))
// Fail every MX connection attempt locally: deterministic, no network.
m
.
dialSMTP
=
func
(
addr
string
) (net.
Conn
,
error
) {
return
nil
,
errors
.
New
(
"connection refused (test)"
)
}
ctx
,
cancel
:=
context
.
WithCancel
(
context
.
Background
())
defer
cancel
()
m
.
Start
(
ctx
)
m
.
Stop
()
id
,
err
:=
m
.
Enqueue
(
"sender@example.com"
, []
string
{
"victim@elsewhere.example"
}, []
byte
(
"Subject: t
\r
\n
\r
\n
b
\r
\n
"
))
if
err
!=
nil
{
t
.
Fatalf
(
"FAIL: Enqueue after Stop = %v — accepted mail must be preserved"
,
err
)
}
// Enqueue stores one entry per recipient, keyed baseID-0, baseID-1, ...
entry
,
err
:=
m
.
GetQueueEntry
(
id
+
"-0"
)
if
err
!=
nil
||
entry
==
nil
{
t
.
Fatalf
(
"FAIL: entry enqueued after Stop not retrievable (err=%v) — accepted mail was lost"
,
err
)
}
}
// TestConcurrentEnqueueRacingStop hammers Enqueue from several goroutines
// across a Stop; post-fix nothing may panic (run under -race for full effect).
func
TestConcurrentEnqueueRacingStop
(
t
*
testing.
T
) {
dir
:=
t
.
TempDir
()
database
,
err
:=
db
.
Open
(
filepath
.
Join
(
dir
,
"q.db"
))
if
err
!=
nil
{
t
.
Fatalf
(
"open db: %v"
,
err
)
}
defer
database
.
Close
()
m
:=
NewManager
(
database
,
store
.
NewMaildirStore
(
dir
),
dir
,
slog
.
New
(
slog
.
NewTextHandler
(
io
.
Discard
,
nil
)))
// Fail every MX connection attempt locally: deterministic, no network.
m
.
dialSMTP
=
func
(
addr
string
) (net.
Conn
,
error
) {
return
nil
,
errors
.
New
(
"connection refused (test)"
)
}
ctx
,
cancel
:=
context
.
WithCancel
(
context
.
Background
())
defer
cancel
()
m
.
Start
(
ctx
)
var
wg
sync.
WaitGroup
stopOnce
:=
sync.
Once
{}
for
g
:=
0
;
g
<
8
;
g
++
{
wg
.
Add
(
1
)
go
func
(
g
int
) {
defer
wg
.
Done
()
for
i
:=
0
;
i
<
25
;
i
++
{
_
,
_
=
m
.
Enqueue
(
"sender@example.com"
, []
string
{
"victim@elsewhere.example"
}, []
byte
(
"Subject: hammer
\r
\n
\r
\n
body
\r
\n
"
))
time
.
Sleep
(
time
.
Millisecond
)
}
stopOnce
.
Do
(
func
() {
m
.
Stop
()
})
}(
g
)
}
wg
.
Wait
()
cancel
()
// The hammer sent at least one entry after Stop; it must be preserved in
// the queue database for the next start.
pending
,
err
:=
m
.
db
.
GetPendingQueue
(
time
.
Now
().
Add
(
time
.
Hour
))
if
err
!=
nil
{
t
.
Fatalf
(
"GetPendingQueue: %v"
,
err
)
}
if
len
(
pending
)
==
0
{
t
.
Fatalf
(
"FAIL: mail accepted around shutdown was lost — no pending entries remain"
)
}
}
You can’t perform that action at this time.