dhcp/dhcp/messages.scm

335 lines
11 KiB
Scheme

;;; GNU Guix DHCP Client.
;;;
;;; Copyright © 2015 Rohan Prinja <rohan.prinja@gmail.com>
;;;
;;; This program is free software; you can redistribute it and/or modify it
;;; under the terms of the GNU General Public License as published by
;;; the Free Software Foundation; either version 3 of the License, or (at
;;; your option) any later version.
;;;
;;; This program is distributed in the hope that it will be useful, but
;;; WITHOUT ANY WARRANTY; without even the implied warranty of
;;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
;;; GNU General Public License for more details.
;;;
;;; You should have received a copy of the GNU General Public License
;;; along with this program. If not, see <http://www.gnu.org/licenses/>.
;; Module for constructing and parsing DHCP messages
(define-module (dhcp messages)
#:use-module (dhcp interfaces)
#:use-module (dhcp dhcp)
#:use-module (dhcp options base)
#:use-module (dhcp options names)
#:use-module (srfi srfi-9)
#:use-module (rnrs base)
#:use-module (rnrs bytevectors)
#:use-module (rnrs enums)
#:export (<dhcp-msg>
make-dhcp-msg
dhcp-msg?
dhcp-msg-op set-dhcp-msg-op!
dhcp-msg-htype set-dhcp-msg-htype!
dhcp-msg-hlen set-dhcp-msg-hlen!
dhcp-msg-hops set-dhcp-msg-hops!
dhcp-msg-xid set-dhcp-msg-xid!
dhcp-msg-secs set-dhcp-msg-secs!
dhcp-msg-flags set-dhcp-msg-flags!
dhcp-msg-ciaddr set-dhcp-msg-ciaddr!
dhcp-msg-yiaddr set-dhcp-msg-yiaddr!
dhcp-msg-siaddr set-dhcp-msg-siaddr!
dhcp-msg-giaddr set-dhcp-msg-giaddr!
dhcp-msg-chaddr set-dhcp-msg-chaddr!
dhcp-msg-sname set-dhcp-msg-sname!
dhcp-msg-file set-dhcp-msg-file!
dhcp-msg-options set-dhcp-msg-options
set-broadcast-bit
unset-broadcast-bit
option-value
serialize-dhcp-message
deserialize-dhcp-message
message-type
make-dhcpdiscover
map-type-to-code))
;; Magic cookie that starts off the 'options' field
;; in a DHCP message packet.
(define *magic-cookie* #vu8(99 130 83 99))
;; Valid types for a DHCP message.
(define *dhcp-msg-types*
(make-enumeration '(DHCPDISCOVER
DHCPOFFER
DHCPREQUEST
DHCPDECLINE
DHCPACK
DHCPNAK
DHCPRELEASE
DHCPINFORM)))
;; DHCP message object.
;; See page 8, RFC 2131 for the message format.
(define-record-type <dhcp-msg>
(make-dhcp-msg op
htype hlen
hops
xid
secs
flags
ciaddr
yiaddr siaddr giaddr
chaddr
sname
file
options)
dhcp-msg?
(op dhcp-msg-op set-dhcp-msg-op!)
(htype dhcp-msg-htype set-dhcp-msg-htype!)
(hlen dhcp-msg-hlen set-dhcp-msg-hlen!)
(hops dhcp-msg-hops set-dhcp-msg-hops!)
(xid dhcp-msg-xid set-dhcp-msg-xid!)
(secs dhcp-msg-secs set-dhcp-msg-secs!)
(flags dhcp-msg-flags set-dhcp-msg-flags!)
(ciaddr dhcp-msg-ciaddr set-dhcp-msg-ciaddr!)
(yiaddr dhcp-msg-yiaddr set-dhcp-msg-yiaddr!)
(siaddr dhcp-msg-siaddr set-dhcp-msg-siaddr!)
(giaddr dhcp-msg-giaddr set-dhcp-msg-giaddr!)
(chaddr dhcp-msg-chaddr set-dhcp-msg-chaddr!)
(sname dhcp-msg-sname set-dhcp-msg-sname!)
(file dhcp-msg-file set-dhcp-msg-file!)
;; Options are represented as a fixed-length
;; vector in which each element is either a
;; <dhcp-option> object or #nil.
(options dhcp-msg-options set-dhcp-msg-options))
;; Note: client initializes #hops to 0.
;; Note: yiaddr, siaddr, giaddr are always 0 for
;; client->server DHCP messages. See Page 32, RFC 2131.
;; Set/unset the BROADCAST bit in the 'flags' field. The
;; remaining bits are always zero, see Figure 2, RFC 2131.
(define-syntax-rule (set-broadcast-bit msg)
(set-dhcp-msg-flags #x8000))
(define-syntax-rule (unset-broadcast-bit msg)
(set-dhcp-msg-flags 0))
#;(define (serialize-options! opts dst idx)
"Copy the options field OPTS from a <dhcp-message> into a
bytevector. OPTS is a vector, DST is a bytevector.
Copying starts at index IDX in DST. This function mutates DST.
If an option is #nil, it means it does not exist, so it is
simply ignored whilst serializing."
(let loop ((i 0))
(if (< i 256)
(let* ((opt (vector-ref opts i)))
(if (eq? #nil opt)
(loop (1+ i))
(let ((code i)
(len (dhcp-option-len opt))
(val (dhcp-option-val opt)))
(begin
(if (zero? len)
(bytevector-u8-set! dst idx code)
(begin
(bytevector-u8-set! dst idx code)
(bytevector-u8-set! dst (1+ idx) len)
(bytevector-copy! val 0 dst (+ idx 2) len)))
(loop (1+ i)))))))))
; Serialize a <dhcp-message> object into a bytevector.
#;(define-method (serialize-dhcp-message (msg <dhcp-message>))
(let* ((res (make-bytevector 576 0))
(chaddr (slot-ref msg 'chaddr))
(chaddr-len (bytevector-length chaddr))
(padded-chaddr (make-bytevector 16 0))
(_ (bytevector-copy! chaddr 0
padded-chaddr (- 16 chaddr-len)
chaddr-len)))
(bytevector-u8-set! res 0 (slot-ref msg 'op))
(bytevector-u8-set! res 1 (slot-ref msg 'htype))
(bytevector-u8-set! res 2 (slot-ref msg 'hlen))
(bytevector-u8-set! res 3 (slot-ref msg 'hops))
(bytevector-u32-set! res 4 (slot-ref msg 'xid) (endianness big))
(bytevector-u16-set! res 8 (slot-ref msg 'secs) (endianness big))
(bytevector-u16-set! res 10 (slot-ref msg 'flags) (endianness big))
(bytevector-copy! (slot-ref msg 'ciaddr) 0 res 12 4)
(bytevector-copy! (slot-ref msg 'yiaddr) 0 res 16 4)
(bytevector-copy! (slot-ref msg 'siaddr) 0 res 20 4)
(bytevector-copy! (slot-ref msg 'giaddr) 0 res 24 4)
(bytevector-copy! padded-chaddr 0 res 28 16)
(bytevector-copy! (slot-ref msg 'sname) 0 res 44 64)
(bytevector-copy! (slot-ref msg 'file) 0 res 108 128)
(bytevector-copy! *magic-cookie* 0 res 236 4)
(serialize-options! (slot-ref msg 'options) res 240)
res))
; Read options from a bytevector 'src' starting at index
; 'idx' and returns a vector of <dhcp-option> objects.
#;(define (deserialize-options src idx)
(define (helper src i res)
(if (= i (bytevector-length src))
res ; nothing more to read from 'src'
(let* ((code (bytevector-u8-ref src i)))
(if (or (= code 0) (code 255))
(begin
(slot-set! res code (make-dhcp-option code 0 #nil))
(helper src (+ i 1) res))
(let* ((len (bytevector-u8-ref src (+ i 1)))
(val (make-bytevector len))
(_ (bytevector-copy! src (+ i 2) val 0 len)))
(begin
(slot-set! res code (make-dhcp-option code len val))
(helper src (+ i 2 len) res)))))))
(helper src idx (make-vector 256 #nil)))
;; 'Pad' and 'End' are the only zero-length options.
;; In RFC 4039, 'Rapid Commit' (also zero-length) was introduced.
;; This is not yet supported in this client implementation.
(define (bytevector-slice bv start len)
"Return a new bytevector with LEN elements sliced
from BV starting at index START"
(let ((res (make-bytevector len)))
(bytevector-copy! bv start res 0 len)
res))
#;(define (deserialize-dhcp-message msg)
(make <dhcp-message>
#:op (bytevector-u8-ref msg 0)
#:htype (bytevector-u8-ref msg 1)
#:hops (bytevector-u8-ref msg 2)
#:xid (bytevector-u32-ref msg 4 (endianness big))
#:secs (bytevector-u16-ref msg 8 (endianness big))
#:flags (bytevector-u16-ref msg 10 (endianness big))
#:ciaddr (bytevector-u32-ref msg 12 (endianness big))
#:yiaddr (bytevector-u32-ref msg 16 (endianness big))
#:siaddr (bytevector-u32-ref msg 20 (endianness big))
#:giaddr (bytevector-u32-ref msg 24 (endianness big))
; TODO: chaddr
#:options (deserialize-options msg 240)))
;; Set an <option> in a <dhcp-msg>.
(define-syntax-rule (set-option! msg opt)
(let ((opts (dhcp-msg-options msg)))
(vector-set! opts
(dhcp-option-code opt)
opt)))
;; Retrieve an option's value from a <dhcp-msg>
;; record MSG given its code CODE.
(define-syntax-rule (option-value msg code)
(let* ((opts (slot-ref msg 'options))
(opt (vector-ref opts code))
(val (dhcp-option-val opt)))
val))
;; Get the DHCP message type. See Section 9.6, RFC 2132.
(define-syntax-rule (message-type msg)
(option-value msg 53))
;; Map a DHCP message type to its single-digit code.
;; See Section 9.6, RFC 2132.
(define-syntax-rule (map-type-to-code type)
(begin
(assert (enum-set-member? type *dhcp-msg-types*))
(1+ ((enum-set-indexer *dhcp-msg-types*) type))))
;; Map a DHCP message type TYPE to its op.
;; 1 = BOOTREQUEST, 2 = BOOTREPLY. See Pages 9, 27, 36 of
;; RFC 2131.
(define-syntax-rule (map-type-to-op type)
(begin
(assert (enum-set-member? type *dhcp-msg-types*))
(cond ((eq? 'DHCPOFFER type) 2)
((eq? 'DHCPACK type) 2)
((eq? 'DHCPNAK type) 2)
(else 1))))
(define (make-dhcp-msg netif type opts)
"Make an instance of <dhcp-msg> for interface NETIF
with message type TYPE and options initialized to OPTS"
(let* ((pair (net-iface-hwaddr netif))
(chaddr (car pair))
(htype (cdr pair))
(hlen (bytevector-length chaddr))
(op (map-type-to-op type))
(dhcp (net-iface-dhcp netif))
(msg-type-code (map-name-to-code
'DHCP-MSG-TYPE)))
(begin
(vector-set! opts
msg-type-code ; 53
(make-dhcp-option
msg-type-code
1
(make-bytevector 1 (map-type-to-code type))))
(make-dhcp-msg
op
htype hlen
0
(retrieve-xid netif)
(retrieve-secs netif type)
0
(retrieve-ciaddr netif type)
#vu8(0 0 0 0) #vu8(0 0 0 0) #vu8(0 0 0 0)
chaddr
(make-bytevector 64 0)
(make-bytevector 128 0)
opts))))
(define (retrieve-xid netif)
"Given a <net-interface> NETIF, return the
its current transaction ID, unless it has just
started out, in which give it a new transaction
ID and return that"
(let* ((dhcp (net-iface-dhcp netif))
(state (dhcp-state dhcp)))
(if (eq? state 'DHCP-INIT)
(let* ((new-xid (generate-random-xid))
(_ (set-dhcp-xid! dhcp new-xid)))
new-xid)
(dhcp-xid dhcp))))
(define (retrieve-ciaddr netif type)
"Given a <net-interface> NETIF and the message
type TYPE, return the appropriate value for the
ciaddr field in a <dhcp-msg> object."
(let* ((dhcp (net-iface-dhcp netif))
(state (dhcp-state dhcp))
(zeroaddr (make-bytevector 4 0))
(ipaddr (net-iface-ipaddr netif)))
(cond ((or (eq? type 'DHCPDISCOVER)
(eq? type 'DHCPDECLINE))
zeroaddr)
((or (eq? type 'DHCPINFORM)
(eq? type 'DHCPRELEASE))
ipaddr)
((eq? type 'DHCPREQUEST)
(if (or (eq? state 'DHCP-BOUND)
(eq? state 'DHCP-RENEW)
(eq? state 'DHCP-REBIND))
ipaddr
zeroaddr)))))
;; TODO: figure out from 2131 exactly when to
;; return secs since config and when to return 0
(define (retrieve-secs netif type)
"Given a <net-interface> NETIF and the message
type TYPE, return the appropriate value for the
secs field in a <dhcp-msg> object."
(let ((dhcp (net-iface-dhcp netif)))
(cond ((or (eq? type 'DHCPDECLINE)
(eq? type 'DHCPRELEASE))
0)
(else (- (current-time) ; might need to change
(dhcp-config-start dhcp))))))
(define-syntax-rule (make-dhcpdiscover netif opts)
(make-dhcp-msg netif 'DHCPDISCOVER opts))