The data in the following directories is organized by days. There is one directory for every day of the trace. There are three files for each access point and for each day. File names start with the name of the access point. The suffix of file names indicates the type of information it contains. On every poll of an access point, we appended data to each of these three files: - File name ending with .snmp => table with data on the access point - File name ending with -interfaces.snmp => table with data on the access point's wireless interface - File name ending with -users.snmp => table with data on users The following describe the format of the data in each type of files and the meaning of that data: * Site names have been anonymized into LBldg, MBldg, and SBldg. * Access point names have been anonymized by computing the SHA-1 hash of their name (concatenated with a secret) and pre-pending the anonymized site name to it. * MAc addresses and IP addresses have been anonymized by computing the SHA-1 of their values (concatenated with a secret) ================================================================= .snmp files with access point data ================================================================= +-------------+------------------+ | Field | Type | +-------------+------------------+ | site | string | anonymized | day | date | | moment | time | | name | string | anonymized | sysUpTime | time | | snmpInPkts | int unsigned | | snmpOutPkts | int unsigned | | ipIn | int unsigned | | ipOut | int unsigned | | ipFwd | int unsigned | | tcpIn | int unsigned | | tcpOut | int unsigned | | udpIn | int unsigned | | udpOut | int unsigned | +-------------+------------------+ site: the building where the access point was located day and moment: timestamp of the poll name: anonymized access point name From the standard MIB-II (RFC1213): Management Information Base for Network Management of TCP/IP-based Internets, we collected the following information for each access point: sysUpTime: The time (in hundredths of a second) since the network management portion of the system was last re-initialized. snmpInPkts: The total number of Messages delivered to the SNMP entity from the transport service. snmpOutPkts: The total number of SNMP Messages which were passed from the SNMP protocol entity to the transport service. ipInReceives: The total number of input datagrams received from interfaces, including those received in error. ipOutRequests: The total number of IP datagrams which local IP user-protocols (including ICMP) supplied to IP in requests for transmission. Note that this counter does not include any datagrams counted in ipForwDatagrams. ipForwDatagrams: The number of input datagrams for which this entity was not their final IP destination, as a result of which an attempt was made to find a route to forward them to that final destination. In entities which do not act as IP Gateways, this counter will include only those packets which were Source-Routed via this entity, and the Source- Route option processing was successful. tcpInSegs: The total number of segments received, including those received in error. This count includes segments received on currently established connections. tcpOutSegs: The total number of segments sent, including those on current connections but excluding those containing only retransmitted octets. udpInDatagrams: The total number of UDP datagrams delivered to UDP users. udpOutDatagrams: The total number of UDP datagrams sent from this entity. ================================================================= -interfaces.snmp files with access point's wireless interface data ================================================================= +----------------+------------------+ | Field | Type | +----------------+------------------+ | site | string | anonymized | day | date | | moment | time | | name | string | anonymized | ifIndex | int | | ifType | string | | ifSpeed | int unsigned | | ifPhysAddress | string | anonymized | ifInOct | int unsigned | | ifInUcastPkts | int unsigned | | ifInErrors | int unsigned | | ifInDiscards | int unsigned | | ifOutOct | int unsigned | | ifOutUcastPkts | int unsigned | | ifOutErrors | int unsigned | | ifOutDiscards | int unsigned | +----------------+------------------+ site: building where access point is located day + moment : timestamp of poll name: name of access point ifIndex and ifType: interface index and type (to recognize the wireless interface) From the standard MIB-II (RFC1213~\cite{rfc1213}: Management Information Base for Network Management of TCP/IP-based Internets, we collected the following information for each access point's wireless interface: ifSpeed: An estimate of the interface's current bandwidth in bits per second. For interfaces which do not vary in bandwidth or for those where no accurate estimation can be made, this object should contain the nominal bandwidth. ifPhysAddress: The interface's address at the protocol layer immediately `below' the network layer in the protocol stack. For interfaces which do not have such an address (e.g., a serial line), this object should contain an octet string of zero length. ifInOctets: The total number of octets received on the interface, including framing characters. ifInUcastPkts: The number of subnetwork-unicast packets delivered to a higher-layer protocol. ifInErrors: The number of inbound packets that contained errors preventing them from being deliverable to a higher-layer protocol. ifInDiscards: The number of inbound packets which were chosen to be discarded even though no errors had been detected to prevent their being deliverable to a higher-layer protocol. One possible reason for discarding such a packet could be to free up buffer space. ifOutOctets: The total number of octets transmitted out of the interface, including framing characters. ifOutUcastPkts: The total number of packets that higher-level protocols requested be transmitted to a subnetwork-unicast address, including those that were discarded or not sent. ifOutErrors: The number of outbound packets that could not be transmitted because of errors. ifOutDiscards: The number of outbound packets which were chosen to be discarded even though no errors had been detected to prevent their being transmitted. One possible reason for discarding such a packet could be to free up buffer space. ================================================================= -users.snmp files with data on associated users ================================================================= +----------------+------------------+ | Field | Type | +----------------+------------------+ | site | string | anonymized | day | date | | moment | time | | parent | string | anonymized | aid | int unsigned | | state | string | only "associated" users recorded | shortRet | int unsigned | | longRet | int unsigned | | strength | int | | quality | int | | mac | string | anonymized | classID | string | only "clientStations" recorded | srcPkts | int unsigned | | srcOct | int unsigned | | srcErrPkts | int unsigned | | srcErrOct | int unsigned | | dstPkts | int unsigned | | dstOct | int unsigned | | dstErrPkts | int unsigned | | dstErrOct | int unsigned | | dstMaxRetryErr | int unsigned | | ip | string | anonymized +----------------+------------------+ site: building where access point is located day + moment : timestamp of poll parent: name of access point From the Cisco Aironet Access Point MIB (AWCVX-MIB.my) we collected information about users: awcDot11TpFdbAID (aid): AID with which the Station is associated with this system, or 2008 if the Station is not currently known to be associated. If the entry is multicast, awcDot11TpFdbAID is 0. Note that the uplink from a Client or Repeater AP to its parent is always AID 1. awcDot11TpFdbClientState: 802.11 Service State of the Station. The state can be one of the following: state0 (station not able to send any frames whatsoever. It is most likely not yet configured), state1 (station can send Class 1 frames. It is Unauthenticated and Unassociated), state2 ( Station can send Class 2 frames. It is Authenticated, but is as yet Unassociated), and state3 (Station can send Class 3 frames. It is both Authenticated and Associated). awcDot11TpFdbTxShortRetries: The total number of 802.11 Short Retries (RTS retries) incurred across all packet Transmission Attempts to this Station. awcDot11TpFdbTxLongRetries: The total number of 802.11 Long Retries (data retries) incurred across all packet Transmission Attempts to this Station. awcDot11TpFdbLatestRxSignalStrength: A device-dependent measure of the signal strength of the most recently received packet from this Station. Might be normalized or unnormalized. awcDot11TpFdbLatestRxSignalQuality: A device-dependent measure of the signal quality of the most recently received packet from this Station. awcDot11TpFdbAddress (mac): MAC address awcTpFdbSrcPktsImmed: Number of observed packets for which this station was the source. awcTpFdbSrcOctetsImmed: Number of observed octets for which this station was the source. awcTpFdbSrcErrorPktsImmed: Number of observed error packets for which this station was the source. awcTpFdbSrcErrorOctetsImmed: Number of observed error octets for which this entry was the source. awcTpFdbDestPktsImmed: Number of observed packets for which this station was the destination. awcTpFdbDestOctetsImmed: Number of observed octets for which this station was the destination. awcTpFdbDestErrorPktsImmed: Number of observed error packets for which this station was the destination. This count includes awcTpFdbDestMaxRetryErrorsImmed. awcTpFdbDestErrorOctetsImmed: Number of observed error octets for which this station was the destination. awcTpFdbDestMaxRetryErrorsImmed: Number of observed max-retry error packets for which this station was the destination. awcTpFdbIPv4Addr: IPv4 network address of the station.