e3ab15417c
This adds an Exists() interface to detect when the container is dead. Before reporting an update error we check is Exists() is true. Some documentation was added as well.
76 lines
2.3 KiB
Go
76 lines
2.3 KiB
Go
// Copyright 2014 Google Inc. All Rights Reserved.
|
|
//
|
|
// Licensed under the Apache License, Version 2.0 (the "License");
|
|
// you may not use this file except in compliance with the License.
|
|
// You may obtain a copy of the License at
|
|
//
|
|
// http://www.apache.org/licenses/LICENSE-2.0
|
|
//
|
|
// Unless required by applicable law or agreed to in writing, software
|
|
// distributed under the License is distributed on an "AS IS" BASIS,
|
|
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
// See the License for the specific language governing permissions and
|
|
// limitations under the License.
|
|
|
|
// Package container defines types for sub-container events and also
|
|
// defines an interface for container operation handlers.
|
|
package container
|
|
|
|
import "github.com/google/cadvisor/info"
|
|
|
|
// ListType describes whether listing should be just for a
|
|
// specific container or performed recursively.
|
|
type ListType int
|
|
|
|
const (
|
|
ListSelf ListType = iota
|
|
ListRecursive
|
|
)
|
|
|
|
// SubcontainerEventType indicates an addition or deletion event.
|
|
type SubcontainerEventType int
|
|
|
|
const (
|
|
SubcontainerAdd SubcontainerEventType = iota
|
|
SubcontainerDelete
|
|
)
|
|
|
|
// SubcontainerEvent represents a
|
|
type SubcontainerEvent struct {
|
|
// The type of event that occurred.
|
|
EventType SubcontainerEventType
|
|
|
|
// The full container name of the container where the event occurred.
|
|
Name string
|
|
}
|
|
|
|
// Interface for container operation handlers.
|
|
type ContainerHandler interface {
|
|
// Returns the ContainerReference
|
|
ContainerReference() (info.ContainerReference, error)
|
|
|
|
// Returns container's isolation spec.
|
|
GetSpec() (info.ContainerSpec, error)
|
|
|
|
// Returns the current stats values of the container.
|
|
GetStats() (*info.ContainerStats, error)
|
|
|
|
// Returns the subcontainers of this container.
|
|
ListContainers(listType ListType) ([]info.ContainerReference, error)
|
|
|
|
// Returns the threads inside this container.
|
|
ListThreads(listType ListType) ([]int, error)
|
|
|
|
// Returns the processes inside this container.
|
|
ListProcesses(listType ListType) ([]int, error)
|
|
|
|
// Registers a channel to listen for events affecting subcontainers (recursively).
|
|
WatchSubcontainers(events chan SubcontainerEvent) error
|
|
|
|
// Stops watching for subcontainer changes.
|
|
StopWatchingSubcontainers() error
|
|
|
|
// Returns whether the container still exists.
|
|
Exists() bool
|
|
}
|