1
0
Fork 0
mirror of https://github.com/moby/moby.git synced 2022-11-09 12:21:53 -05:00

libnetwork: fix some linting issues

- fix incorrectly formatted GoDoc and comments
- rename a variable that collided with the `cap` built-in

Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
This commit is contained in:
Sebastiaan van Stijn 2021-08-26 10:02:04 +02:00
parent 085c6a98d5
commit 92ea7df3d1
No known key found for this signature in database
GPG key ID: 76698F39D527CE8C

View file

@ -26,16 +26,16 @@ import (
// A Network represents a logical connectivity zone that containers may // A Network represents a logical connectivity zone that containers may
// join using the Link method. A Network is managed by a specific driver. // join using the Link method. A Network is managed by a specific driver.
type Network interface { type Network interface {
// A user chosen name for this network. // Name returns a user chosen name for this network.
Name() string Name() string
// A system generated id for this network. // ID returns a system generated id for this network.
ID() string ID() string
// The type of network, which corresponds to its managing driver. // Type returns the type of network, which corresponds to its managing driver.
Type() string Type() string
// Create a new endpoint to this network symbolically identified by the // CreateEndpoint creates a new endpoint to this network symbolically identified by the
// specified unique name. The options parameter carries driver specific options. // specified unique name. The options parameter carries driver specific options.
CreateEndpoint(name string, options ...EndpointOption) (Endpoint, error) CreateEndpoint(name string, options ...EndpointOption) (Endpoint, error)
@ -45,7 +45,7 @@ type Network interface {
// Endpoints returns the list of Endpoint(s) in this network. // Endpoints returns the list of Endpoint(s) in this network.
Endpoints() []Endpoint Endpoints() []Endpoint
// WalkEndpoints uses the provided function to walk the Endpoints // WalkEndpoints uses the provided function to walk the Endpoints.
WalkEndpoints(walker EndpointWalker) WalkEndpoints(walker EndpointWalker)
// EndpointByName returns the Endpoint which has the passed name. If not found, the error ErrNoSuchEndpoint is returned. // EndpointByName returns the Endpoint which has the passed name. If not found, the error ErrNoSuchEndpoint is returned.
@ -54,7 +54,7 @@ type Network interface {
// EndpointByID returns the Endpoint which has the passed id. If not found, the error ErrNoSuchEndpoint is returned. // EndpointByID returns the Endpoint which has the passed id. If not found, the error ErrNoSuchEndpoint is returned.
EndpointByID(id string) (Endpoint, error) EndpointByID(id string) (Endpoint, error)
// Return certain operational data belonging to this network // Info returns certain operational data belonging to this network.
Info() NetworkInfo Info() NetworkInfo
} }
@ -89,7 +89,7 @@ type EndpointWalker func(ep Endpoint) bool
// ipInfo is the reverse mapping from IP to service name to serve the PTR query. // ipInfo is the reverse mapping from IP to service name to serve the PTR query.
// extResolver is set if an external server resolves a service name to this IP. // extResolver is set if an external server resolves a service name to this IP.
// Its an indication to defer PTR queries also to that external server. // It's an indication to defer PTR queries also to that external server.
type ipInfo struct { type ipInfo struct {
name string name string
serviceID string serviceID string
@ -130,15 +130,15 @@ type networkDBTable struct {
// IpamConf contains all the ipam related configurations for a network // IpamConf contains all the ipam related configurations for a network
type IpamConf struct { type IpamConf struct {
// The master address pool for containers and network interfaces // PreferredPool is the master address pool for containers and network interfaces.
PreferredPool string PreferredPool string
// A subset of the master pool. If specified, // SubPool is a subset of the master pool. If specified,
// this becomes the container pool // this becomes the container pool.
SubPool string SubPool string
// Preferred Network Gateway address (optional) // Gateway is the preferred Network Gateway address (optional).
Gateway string Gateway string
// Auxiliary addresses for network driver. Must be within the master pool. // AuxAddresses contains auxiliary addresses for network driver. Must be within the master pool.
// libnetwork will reserve them if they fall into the container pool // libnetwork will reserve them if they fall into the container pool.
AuxAddresses map[string]string AuxAddresses map[string]string
} }
@ -415,7 +415,7 @@ func (n *network) validateConfiguration() error {
return nil return nil
} }
// Applies network specific configurations // applyConfigurationTo applies network specific configurations.
func (n *network) applyConfigurationTo(to *network) error { func (n *network) applyConfigurationTo(to *network) error {
to.enableIPv6 = n.enableIPv6 to.enableIPv6 = n.enableIPv6
if len(n.labels) > 0 { if len(n.labels) > 0 {
@ -1197,12 +1197,12 @@ func (n *network) createEndpoint(name string, options ...EndpointOption) (Endpoi
} }
} }
ipam, cap, err := n.getController().getIPAMDriver(n.ipamType) ipam, capability, err := n.getController().getIPAMDriver(n.ipamType)
if err != nil { if err != nil {
return nil, err return nil, err
} }
if cap.RequiresMACAddress { if capability.RequiresMACAddress {
if ep.iface.mac == nil { if ep.iface.mac == nil {
ep.iface.mac = netutils.GenerateRandomMAC() ep.iface.mac = netutils.GenerateRandomMAC()
} }