Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

opqueue

package

Go to main page

Versions in this module

v1

v1.13.6

Feb 12, 2026

v1.13.5

Feb 12, 2026

v1.13.4

Feb 12, 2026

v1.13.3

Feb 12, 2026

v1.13.2

Feb 12, 2026

v1.13.1

Feb 12, 2026

Changes in this version

+ func SecureStreamElementsFile(path string, config StreamingBatchConfig, callback BatchCallback) (elementCount int, err error)

+ type BatchCallback func(batch []string, batchNum int) error

+ type BulkJob struct

+ Elements []string

+ SetName string

+ Source string

+ type FastOp struct

+ Op *SetOp

+ SetName string

type OpQueue

+ func (q *OpQueue) EnqueueReplaceFromFile(setName, filePath, source string, batchConfig StreamingBatchConfig) (int, error)

+ type Scheduler struct

+ func NewScheduler(backend NetlinkBackend, config QueueConfig) *Scheduler

+ func (s *Scheduler) EnqueueBulk(setName string, elements []string, source string) error

+ func (s *Scheduler) EnqueueBulkFromFile(ctx context.Context, setName, filePath, source string, ...) (int, error)

+ func (s *Scheduler) EnqueueFast(setName string, op *SetOp) error

+ func (s *Scheduler) SchedulerStats() SchedulerStats

+ func (s *Scheduler) Start(ctx context.Context)

+ func (s *Scheduler) Stop()

+ type SchedulerStats struct

+ BulkPending int64

+ FastPending int64

+ LastBulkFlush time.Time

+ LastFastFlush time.Time

+ TotalApplied uint64

+ TotalDropped uint64

+ type StreamingBatchConfig struct

+ BatchSize int

+ func DefaultStreamingBatchConfig() StreamingBatchConfig

+ type StreamingFileReader struct

+ func SecureOpenElementsFile(path string, config StreamingBatchConfig) (*StreamingFileReader, error)

+ func (r *StreamingFileReader) Close() error

+ func (r *StreamingFileReader) ReadNextBatch() ([]string, error)

+ func (r *StreamingFileReader) Stats() (lineCount, elementCount int)

+ func (r *StreamingFileReader) StreamElements(callback BatchCallback) error

v1.13.0

Feb 11, 2026

Changes in this version

+ var ErrQueueFull = errors.New("operation queue is full")

+ var ErrQueueStopped = errors.New("operation queue is stopped")

+ func GetAllSets() []string

+ func GetSourceConfig(source string) (sourceConfig, bool)

+ func GetTargetSet(source, ip string) string

+ func IsAllowedPath(path string) bool

+ func WithTimeout(ctx context.Context, timeout time.Duration) context.Context

+ type FileReadResult struct

+ Count int

+ Elements []string

+ func SecureReadElementsFile(path string) (*FileReadResult, error)

+ type FlushResult struct

+ Applied int

+ Err error

+ PostBarrier []*SetOp

+ SetName string

+ type IndexEntry struct

+ Element string

+ Set string

+ Sources []string

+ TTL uint32

+ Updated int64

+ type NFTBackendWrapper struct

+ func NewNFTBackendWrapper(nft *nftsync.NFTManager) (*NFTBackendWrapper, error)

+ func (w *NFTBackendWrapper) AddElements(tableName, setName string, elements []SetElement) error

+ func (w *NFTBackendWrapper) Close()

+ func (w *NFTBackendWrapper) DeleteElements(tableName, setName string, elements []SetElement) error

+ func (w *NFTBackendWrapper) FlushSet(tableName, setName string) error

+ func (w *NFTBackendWrapper) GetSetElements(tableName, setName string) ([]string, error)

+ func (w *NFTBackendWrapper) InvalidateCache()

+ type NetlinkBackend interface

+ AddElements func(table, set string, elements []SetElement) error

+ DeleteElements func(table, set string, elements []SetElement) error

+ FlushSet func(table, set string) error

+ GetSetElements func(table, set string) ([]string, error)

+ type OpQueue struct

+ func NewOpQueue(backend NetlinkBackend, config QueueConfig) *OpQueue

+ func (q *OpQueue) EnqueueBan(setName string, element string, ttl uint32, source, reason string) error

+ func (q *OpQueue) EnqueueFlush(setName string) error

+ func (q *OpQueue) EnqueueReplace(setName string, elements []string, source string) error

+ func (q *OpQueue) EnqueueUnban(setName string, element string, source string) error

+ func (q *OpQueue) QueueDepth() int64

+ func (q *OpQueue) Start(ctx context.Context)

+ func (q *OpQueue) Stats() QueueStats

+ func (q *OpQueue) Stop()

+ type OpType int

+ const OpAdd

+ const OpDelete

+ const OpFlushSet

+ const OpReplaceSet

+ func (t OpType) String() string

+ type PendingOp struct

+ CreatedAt time.Time

+ Element string

+ Reason string

+ Source string

+ TTL uint32

+ Type OpType

+ type QueueConfig struct

+ FlushInterval time.Duration

+ FlushThreshold int

+ MaxBatchSize int

+ MaxQueueDepth int64

+ func DefaultQueueConfig() QueueConfig

+ type QueueStats struct

+ LastFlushTime time.Time

+ PendingCount int64

+ TotalApplied uint64

+ TotalDropped uint64

+ TotalQueued uint64

+ type SetBuffer struct

+ type SetElement struct

+ IsIPv6 bool

+ TTL uint32

+ Value string

+ type SetOp struct

+ Element string

+ Elements []string

+ Reason string

+ Source string

+ TTL uint32

+ Type OpType

+ type SourceIndex struct

+ func NewSourceIndex(indexPath string) *SourceIndex

+ func (si *SourceIndex) Add(setName, element, source string)

+ func (si *SourceIndex) ClearSet(setName string)

+ func (si *SourceIndex) GetAllElements(setName string) map[string]bool

+ func (si *SourceIndex) GetElementsBySource(setName, source string) []string

+ func (si *SourceIndex) HasElement(setName, element string) bool

+ func (si *SourceIndex) LoadFromDisk() error

+ func (si *SourceIndex) ReconcileWithBackend(backend NetlinkBackend)

+ func (si *SourceIndex) Remove(setName, element, source string)

+ func (si *SourceIndex) RemoveAll(setName, element string)

+ func (si *SourceIndex) SaveToDisk() error

+ func (si *SourceIndex) ShouldDelete(setName, element string) bool

+ func (si *SourceIndex) StartBackgroundSaver(ctx context.Context)

+ func (si *SourceIndex) Stop()

+ type StandaloneBackend struct

+ func NewStandaloneBackend() (*StandaloneBackend, error)

+ func (s *StandaloneBackend) Close()