Help us shape the future of Go! Take the 2026 Go Developer Survey

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
- API
  
  Reference documentation for the pkg.go.dev API
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

process

package

Go to main page

Versions in this module

v3

v3.0.36

Oct 20, 2026

v3.0.35

Oct 7, 2026

Changes in this version

type Owner

+ ChannelScope string

+ SessionScope string

type Supervisor

+ func (s *Supervisor) List(owner Owner) ([]Status, error)

+ func (s *Supervisor) ReadStderr(ctx context.Context, owner Owner, handle string, request ReadRequest) (ReadResult, error)

+ func (s *Supervisor) ReadStdout(ctx context.Context, owner Owner, handle string, request ReadRequest) (ReadResult, error)

v3.0.34

Oct 7, 2026

Changes in this version

+ const MaxArgumentBytes

+ const MaxArguments

+ const MaxClientKeyBytes

+ const MaxEnvironmentBytes

+ const MaxEnvironmentEntries

+ const MaxOutputBufferBytes

+ const MaxOwnerFieldBytes

+ const MaxRuntimeMilliseconds

+ const MaxStdinBytes

+ var ErrClosed = errors.New("PROCESS_SUPERVISOR_CLOSED")

+ var ErrInvalidRequest = errors.New("PROCESS_INVALID_REQUEST")

+ var ErrLaunchConflict = errors.New("PROCESS_LAUNCH_CONFLICT")

+ var ErrNotFound = errors.New("PROCESS_NOT_FOUND")

+ var ErrPermissionDenied = errors.New("PROCESS_PERMISSION_DENIED")

+ var ErrRevoked = errors.New("PROCESS_OWNER_REVOKED")

+ var ErrSecretUnavailable = errors.New("PROCESS_SECRET_UNAVAILABLE")

+ type ExitResult struct

+ ExitCode *int

+ TerminationReason string

+ type Options struct

+ BaseEnvironment []string

+ GracePeriod time.Duration

+ Permission func(context.Context, Owner) error

+ Secrets SecretResolver

+ type Owner struct

+ EnvironmentScope string

+ PluginInstanceID string

+ UserScope string

+ func (o Owner) ValidForHost() bool

+ type ReadRequest struct

+ Cursor uint64

+ MaxBytes int

+ type ReadResult struct

+ Cursor uint64

+ Data []byte

+ DroppedBytes uint64

+ EOF bool

+ ProcessExit bool

+ StreamGap bool

+ type ResourceLimits struct

+ MaxRuntimeMS int

+ OutputBufferBytes int

+ type SecretResolver func(context.Context, Owner, string) (string, error)

+ type StartRequest struct

+ Argv []string

+ ClientKey string

+ Cwd string

+ Environment map[string]string

+ EnvironmentRemovals []string

+ Limits ResourceLimits

+ Program string

+ SecretReferences map[string]string

+ type Status struct

+ ClientKey string

+ ExitCode *int

+ Handle string

+ State string

+ TerminationReason string

+ type Stream string

+ const Stderr

+ const Stdout

+ type Supervisor struct

+ func NewSupervisor(options Options) (*Supervisor, error)

+ func (s *Supervisor) Attach(owner Owner, clientKey string) (Status, error)

+ func (s *Supervisor) Close(ctx context.Context, owner Owner, handle string) error

+ func (s *Supervisor) CloseStdin(owner Owner, handle string) error

+ func (s *Supervisor) GetStatus(owner Owner, handle string) (Status, error)

+ func (s *Supervisor) Kill(owner Owner, handle string) error

+ func (s *Supervisor) Read(ctx context.Context, owner Owner, handle string, stream Stream, ...) (ReadResult, error)

+ func (s *Supervisor) RestorePlugin(pluginInstanceID, environmentScope string) error

+ func (s *Supervisor) Revoke(ctx context.Context, owner Owner) error

+ func (s *Supervisor) RevokePlugin(ctx context.Context, pluginInstanceID, environmentScope string) error

+ func (s *Supervisor) Shutdown(ctx context.Context) error

+ func (s *Supervisor) Start(ctx context.Context, owner Owner, request StartRequest) (Status, error)

+ func (s *Supervisor) Terminate(ctx context.Context, owner Owner, handle string) error

+ func (s *Supervisor) Wait(ctx context.Context, owner Owner, handle string) (ExitResult, error)

+ func (s *Supervisor) WriteStdin(ctx context.Context, owner Owner, handle string, data []byte) (int, error)