mirror of
https://github.com/mjl-/mox.git
synced 2025-06-28 02:28:15 +03:00

the vendored dns resolver code is a copy of the go stdlib dns resolver, with awareness of the "authentic data" (i.e. dnssec secure) added, as well as support for enhanced dns errors, and looking up tlsa records (for dane). ideally it would be upstreamed, but the chances seem slim. dnssec-awareness is added to all packages, e.g. spf, dkim, dmarc, iprev. their dnssec status is added to the Received message headers for incoming email. but the main reason to add dnssec was for implementing dane. with dane, the verification of tls certificates can be done through certificates/public keys published in dns (in the tlsa records). this only makes sense (is trustworthy) if those dns records can be verified to be authentic. mox now applies dane to delivering messages over smtp. mox already implemented mta-sts for webpki/pkix-verification of certificates against the (large) pool of CA's, and still enforces those policies when present. but it now also checks for dane records, and will verify those if present. if dane and mta-sts are both absent, the regular opportunistic tls with starttls is still done. and the fallback to plaintext is also still done. mox also makes it easy to setup dane for incoming deliveries, so other servers can deliver with dane tls certificate verification. the quickstart now generates private keys that are used when requesting certificates with acme. the private keys are pre-generated because they must be static and known during setup, because their public keys must be published in tlsa records in dns. autocert would generate private keys on its own, so had to be forked to add the option to provide the private key when requesting a new certificate. hopefully upstream will accept the change and we can drop the fork. with this change, using the quickstart to setup a new mox instance, the checks at internet.nl result in a 100% score, provided the domain is dnssec-signed and the network doesn't have any issues.
124 lines
3.1 KiB
Go
124 lines
3.1 KiB
Go
// Copyright 2013 The Go Authors. All rights reserved.
|
|
// Use of this source code is governed by a BSD-style
|
|
// license that can be found in the LICENSE file.
|
|
|
|
// Package singleflight provides a duplicate function call suppression
|
|
// mechanism.
|
|
package singleflight
|
|
|
|
import "sync"
|
|
|
|
// call is an in-flight or completed singleflight.Do call
|
|
type call struct {
|
|
wg sync.WaitGroup
|
|
|
|
// These fields are written once before the WaitGroup is done
|
|
// and are only read after the WaitGroup is done.
|
|
val any
|
|
err error
|
|
|
|
// These fields are read and written with the singleflight
|
|
// mutex held before the WaitGroup is done, and are read but
|
|
// not written after the WaitGroup is done.
|
|
dups int
|
|
chans []chan<- Result
|
|
}
|
|
|
|
// Group represents a class of work and forms a namespace in
|
|
// which units of work can be executed with duplicate suppression.
|
|
type Group struct {
|
|
mu sync.Mutex // protects m
|
|
m map[string]*call // lazily initialized
|
|
}
|
|
|
|
// Result holds the results of Do, so they can be passed
|
|
// on a channel.
|
|
type Result struct {
|
|
Val any
|
|
Err error
|
|
Shared bool
|
|
}
|
|
|
|
// Do executes and returns the results of the given function, making
|
|
// sure that only one execution is in-flight for a given key at a
|
|
// time. If a duplicate comes in, the duplicate caller waits for the
|
|
// original to complete and receives the same results.
|
|
// The return value shared indicates whether v was given to multiple callers.
|
|
func (g *Group) Do(key string, fn func() (any, error)) (v any, err error, shared bool) {
|
|
g.mu.Lock()
|
|
if g.m == nil {
|
|
g.m = make(map[string]*call)
|
|
}
|
|
if c, ok := g.m[key]; ok {
|
|
c.dups++
|
|
g.mu.Unlock()
|
|
c.wg.Wait()
|
|
return c.val, c.err, true
|
|
}
|
|
c := new(call)
|
|
c.wg.Add(1)
|
|
g.m[key] = c
|
|
g.mu.Unlock()
|
|
|
|
g.doCall(c, key, fn)
|
|
return c.val, c.err, c.dups > 0
|
|
}
|
|
|
|
// DoChan is like Do but returns a channel that will receive the
|
|
// results when they are ready.
|
|
func (g *Group) DoChan(key string, fn func() (any, error)) <-chan Result {
|
|
ch := make(chan Result, 1)
|
|
g.mu.Lock()
|
|
if g.m == nil {
|
|
g.m = make(map[string]*call)
|
|
}
|
|
if c, ok := g.m[key]; ok {
|
|
c.dups++
|
|
c.chans = append(c.chans, ch)
|
|
g.mu.Unlock()
|
|
return ch
|
|
}
|
|
c := &call{chans: []chan<- Result{ch}}
|
|
c.wg.Add(1)
|
|
g.m[key] = c
|
|
g.mu.Unlock()
|
|
|
|
go g.doCall(c, key, fn)
|
|
|
|
return ch
|
|
}
|
|
|
|
// doCall handles the single call for a key.
|
|
func (g *Group) doCall(c *call, key string, fn func() (any, error)) {
|
|
c.val, c.err = fn()
|
|
|
|
g.mu.Lock()
|
|
c.wg.Done()
|
|
if g.m[key] == c {
|
|
delete(g.m, key)
|
|
}
|
|
for _, ch := range c.chans {
|
|
ch <- Result{c.val, c.err, c.dups > 0}
|
|
}
|
|
g.mu.Unlock()
|
|
}
|
|
|
|
// ForgetUnshared tells the singleflight to forget about a key if it is not
|
|
// shared with any other goroutines. Future calls to Do for a forgotten key
|
|
// will call the function rather than waiting for an earlier call to complete.
|
|
// Returns whether the key was forgotten or unknown--that is, whether no
|
|
// other goroutines are waiting for the result.
|
|
func (g *Group) ForgetUnshared(key string) bool {
|
|
g.mu.Lock()
|
|
defer g.mu.Unlock()
|
|
c, ok := g.m[key]
|
|
if !ok {
|
|
return true
|
|
}
|
|
if c.dups == 0 {
|
|
delete(g.m, key)
|
|
return true
|
|
}
|
|
return false
|
|
}
|