1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
|
// Copyright 2014 Canonical Ltd.
// Licensed under the AGPLv3, see LICENCE file for details.
package state
import (
"fmt"
"labix.org/v2/mgo/bson"
"launchpad.net/juju-core/environs/network"
"launchpad.net/juju-core/names"
)
// Network represents the state of a network.
type Network struct {
st *State
doc networkDoc
}
// NetworkInfo describes a single network.
type NetworkInfo struct {
// Name is juju-internal name of the network.
Name string
// ProviderId is a provider-specific network id.
ProviderId network.Id
// CIDR of the network, in 123.45.67.89/24 format.
CIDR string
// VLANTag needs to be between 1 and 4094 for VLANs and 0 for
// normal networks. It's defined by IEEE 802.1Q standard.
VLANTag int
}
// networkDoc represents a configured network that a machine can be a
// part of.
type networkDoc struct {
// Name is the network's name. It should be one of the machine's
// included networks.
Name string `bson:"_id"`
ProviderId network.Id
CIDR string
VLANTag int
}
func newNetwork(st *State, doc *networkDoc) *Network {
return &Network{st, *doc}
}
func newNetworkDoc(args NetworkInfo) *networkDoc {
return &networkDoc{
Name: args.Name,
ProviderId: args.ProviderId,
CIDR: args.CIDR,
VLANTag: args.VLANTag,
}
}
// GoString implements fmt.GoStringer.
func (n *Network) GoString() string {
return fmt.Sprintf(
"&state.Network{name: %q, providerId: %q, cidr: %q, vlanTag: %v}",
n.Name(), n.ProviderId(), n.CIDR(), n.VLANTag())
}
// Name returns the network name.
func (n *Network) Name() string {
return n.doc.Name
}
// ProviderId returns the provider-specific id of the network.
func (n *Network) ProviderId() network.Id {
return n.doc.ProviderId
}
// Tag returns the network tag.
func (n *Network) Tag() string {
return names.NetworkTag(n.doc.Name)
}
// CIDR returns the network CIDR (e.g. 192.168.50.0/24).
func (n *Network) CIDR() string {
return n.doc.CIDR
}
// VLANTag returns the network VLAN tag. It's a number between 1 and
// 4094 for VLANs and 0 if the network is not a VLAN.
func (n *Network) VLANTag() int {
return n.doc.VLANTag
}
// IsVLAN returns whether the network is a VLAN (has tag > 0) or a
// normal network.
func (n *Network) IsVLAN() bool {
return n.doc.VLANTag > 0
}
// Interfaces returns all network interfaces on the network.
func (n *Network) Interfaces() ([]*NetworkInterface, error) {
docs := []networkInterfaceDoc{}
sel := bson.D{{"networkname", n.doc.Name}}
err := n.st.networkInterfaces.Find(sel).All(&docs)
if err != nil {
return nil, err
}
ifaces := make([]*NetworkInterface, len(docs))
for i, doc := range docs {
ifaces[i] = newNetworkInterface(n.st, &doc)
}
return ifaces, nil
}
|