summaryrefslogtreecommitdiffhomepage
path: root/dhcpv4/option_string.go
blob: eb0cc2b0d61fcb2152e612578fb29e8bff50fcd7 (plain)
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
package dhcpv4

// String represents an option encapsulating a string in IPv4 DHCP.
//
// This representation is shared by multiple options specified by RFC 2132,
// Sections 3.14, 3.16, 3.17, 3.19, and 3.20.
type String string

// ToBytes returns a serialized stream of bytes for this option.
func (o String) ToBytes() []byte {
	return []byte(o)
}

// String returns a human-readable string.
func (o String) String() string {
	return string(o)
}

// FromBytes parses a serialized stream of bytes into o.
func (o *String) FromBytes(data []byte) error {
	*o = String(string(data))
	return nil
}

// GetString parses an RFC 2132 string from o[code].
func GetString(code OptionCode, o Options) string {
	v := o.Get(code)
	if v == nil {
		return ""
	}
	return string(v)
}

// OptDomainName returns a new DHCPv4 Domain Name option.
//
// The Domain Name option is described by RFC 2132, Section 3.17.
func OptDomainName(name string) Option {
	return Option{Code: OptionDomainName, Value: String(name)}
}

// OptHostName returns a new DHCPv4 Host Name option.
//
// The Host Name option is described by RFC 2132, Section 3.14.
func OptHostName(name string) Option {
	return Option{Code: OptionHostName, Value: String(name)}
}

// OptRootPath returns a new DHCPv4 Root Path option.
//
// The Root Path option is described by RFC 2132, Section 3.19.
func OptRootPath(name string) Option {
	return Option{Code: OptionRootPath, Value: String(name)}
}

// OptBootFileName returns a new DHCPv4 Boot File Name option.
//
// The Bootfile Name option is described by RFC 2132, Section 9.5.
func OptBootFileName(name string) Option {
	return Option{Code: OptionBootfileName, Value: String(name)}
}

// OptTFTPServerName returns a new DHCPv4 TFTP Server Name option.
//
// The TFTP Server Name option is described by RFC 2132, Section 9.4.
func OptTFTPServerName(name string) Option {
	return Option{Code: OptionTFTPServerName, Value: String(name)}
}

// OptClassIdentifier returns a new DHCPv4 Class Identifier option.
//
// The Vendor Class Identifier option is described by RFC 2132, Section 9.13.
func OptClassIdentifier(name string) Option {
	return Option{Code: OptionClassIdentifier, Value: String(name)}
}

// OptUserClass returns a new DHCPv4 User Class option.
func OptUserClass(name string) Option {
	return Option{Code: OptionUserClassInformation, Value: String(name)}
}

// OptMessage returns a new DHCPv4 (Error) Message option.
func OptMessage(msg string) Option {
	return Option{Code: OptionMessage, Value: String(msg)}
}