1/*
2 * Copyright (c) 2002-2005 The Regents of The University of Michigan
3 * All rights reserved.
4 *
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions are
7 * met: redistributions of source code must retain the above copyright
8 * notice, this list of conditions and the following disclaimer;
9 * redistributions in binary form must reproduce the above copyright
10 * notice, this list of conditions and the following disclaimer in the
11 * documentation and/or other materials provided with the distribution;
12 * neither the name of the copyright holders nor the names of its
13 * contributors may be used to endorse or promote products derived from
14 * this software without specific prior written permission.
15 *
16 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
17 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
18 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
19 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
20 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
21 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
22 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
23 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
24 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
25 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
26 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
27 *
28 * Authors: Nathan Binkert
29 *          Lisa Hsu
30 */
31
32/* @file
33 * Reference counted class containing ethernet packet data
34 */
35
36#ifndef __DEV_NET_ETHERPKT_HH__
37#define __DEV_NET_ETHERPKT_HH__
38
39#include <cassert>
40#include <iosfwd>
41#include <memory>
42
43#include "base/types.hh"
44#include "sim/serialize.hh"
45
46/*
47 * Reference counted class containing ethernet packet data
48 */
49class EthPacketData
50{
51  public:
52    /**
53     * Pointer to packet data will be deleted
54     */
55    uint8_t *data;
56
57    /**
58     * Total size of the allocated data buffer.
59     */
60    unsigned bufLength;
61
62    /**
63     * Amount of space occupied by the payload in the data buffer
64     */
65    unsigned length;
66
67    /**
68     * Effective length, used for modeling timing in the simulator.
69     * This could be different from length if the packets are assumed
70     * to use a tightly packed or compressed format, but it's not worth
71     * the performance/complexity hit to perform that packing or compression
72     * in the simulation.
73     */
74    unsigned simLength;
75
76    EthPacketData()
77        : data(nullptr), bufLength(0), length(0), simLength(0)
78    { }
79
80    explicit EthPacketData(unsigned size)
81        : data(new uint8_t[size]), bufLength(size), length(0), simLength(0)
82    { }
83
84    ~EthPacketData() { if (data) delete [] data; }
85
86    void serialize(const std::string &base, CheckpointOut &cp) const;
87    void unserialize(const std::string &base, CheckpointIn &cp);
88};
89
90typedef std::shared_ptr<EthPacketData> EthPacketPtr;
91
92#endif // __DEV_NET_ETHERPKT_HH__
93