This file is indexed.

/usr/src/open-vm-tools-10.0.7/vsock/linux/notify.h is in open-vm-tools-dkms 2:10.0.7-3227872-2ubuntu1.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  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
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
/*********************************************************
 * Copyright (C) 2009-2014 VMware, Inc. All rights reserved.
 *
 * 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 version 2 and no 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, write to the Free Software Foundation, Inc.,
 * 51 Franklin St, Fifth Floor, Boston, MA  02110-1301 USA
 *
 *********************************************************/

/*
 * notify.h --
 *
 *      Notify functions for Linux VSocket module.
 */

#ifndef __NOTIFY_H__
#define __NOTIFY_H__

#include "driver-config.h"
#include "vsockCommon.h"
#include "vsockPacket.h"

/* Comment this out to compare with old protocol. */
#define VSOCK_OPTIMIZATION_WAITING_NOTIFY 1
#if defined(VSOCK_OPTIMIZATION_WAITING_NOTIFY)
/* Comment this out to remove flow control for "new" protocol */
#  define VSOCK_OPTIMIZATION_FLOW_CONTROL 1
#endif

#define VSOCK_MAX_DGRAM_RESENDS       10

#define NOTIFYCALLRET(vsk, rv, mod_fn, args...)                     \
do {                                                                \
  if (vsk->notifyOps &&                                             \
      vsk->notifyOps->mod_fn != NULL) {                             \
        rv = (vsk->notifyOps->mod_fn)(args);                        \
  } else {                                                          \
        rv = 0;                                                     \
  }                                                                 \
} while (0)

#define NOTIFYCALL(vsk, mod_fn, args...)                            \
do {                                                                \
  if (vsk->notifyOps &&                                             \
      vsk->notifyOps->mod_fn != NULL) {                             \
        (vsk->notifyOps->mod_fn)(args);                             \
  }                                                                 \
} while (0)

typedef struct VSockVmciNotifyPkt {
   uint64 writeNotifyWindow;
   uint64 writeNotifyMinWindow;
   Bool peerWaitingRead;
   Bool peerWaitingWrite;
   Bool peerWaitingWriteDetected;
   Bool sentWaitingRead;
   Bool sentWaitingWrite;
   VSockWaitingInfo peerWaitingReadInfo;
   VSockWaitingInfo peerWaitingWriteInfo;
   uint64 produceQGeneration;
   uint64 consumeQGeneration;
} VSockVmciNotifyPkt;

typedef struct VSockVmciNotifyPktQState {
   uint64 writeNotifyWindow;
   uint64 writeNotifyMinWindow;
   Bool peerWaitingWrite;
   Bool peerWaitingWriteDetected;
} VSockVmciNotifyPktQState;

typedef union VSockVmciNotify {
   VSockVmciNotifyPkt pkt;
   VSockVmciNotifyPktQState pktQState;
} VSockVmciNotify;

typedef struct VSockVmciRecvNotifyData {
   uint64 consumeHead;
   uint64 produceTail;
   Bool notifyOnBlock;
} VSockVmciRecvNotifyData;

typedef struct VSockVmciSendNotifyData {
   uint64 consumeHead;
   uint64 produceTail;
} VSockVmciSendNotifyData;

/* Socket notification callbacks. */
typedef struct VSockVmciNotifyOps {
   void  (*socketInit)(struct sock *sk);
   void  (*socketDestruct)(struct sock *sk);
   int32 (*pollIn)(struct sock *sk, size_t target, Bool *dataReadyNow);
   int32 (*pollOut)(struct sock *sk, size_t target, Bool *spaceAvailNow);
   void  (*handleNotifyPkt)(struct sock *sk, VSockPacket *pkt,
                            Bool bottomHalf, struct sockaddr_vm *dst,
                            struct sockaddr_vm *src, Bool *pktProcessed);
   int32 (*recvInit)(struct sock *sk, size_t target,
                     VSockVmciRecvNotifyData *data);
   int32 (*recvPreBlock)(struct sock *sk, size_t target,
                         VSockVmciRecvNotifyData *data);
   int32 (*recvPreDequeue)(struct sock *sk, size_t target,
                           VSockVmciRecvNotifyData *data);
   int32 (*recvPostDequeue)(struct sock *sk, size_t target, ssize_t copied,
                            Bool dataRead, VSockVmciRecvNotifyData *data);
   int32 (*sendInit)(struct sock *sk,
                     VSockVmciSendNotifyData *data);
   int32 (*sendPreBlock)(struct sock *sk,
                         VSockVmciSendNotifyData *data);
   int32 (*sendPreEnqueue)(struct sock *sk,
                           VSockVmciSendNotifyData *data);
   int32 (*sendPostEnqueue)(struct sock *sk,
                            ssize_t written,
                            VSockVmciSendNotifyData *data);
   void  (*processRequest)(struct sock *sk);
   void  (*processNegotiate)(struct sock *sk);
} VSockVmciNotifyOps;

extern VSockVmciNotifyOps vSockVmciNotifyPktOps;
extern VSockVmciNotifyOps vSockVmciNotifyPktQStateOps;

#endif /* __NOTIFY_H__ */