This file is indexed.

/usr/include/dovecot/push-notification-drivers.h is in dovecot-dev 1:2.2.22-1ubuntu2.

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
/* Copyright (c) 2015-2016 Dovecot authors, see the included COPYING file */

#ifndef PUSH_NOTIFICATION_DRIVERS_H
#define PUSH_NOTIFICATION_DRIVERS_H


#include "mail-user.h"
#include "push-notification-triggers.h"

struct mail_user;
struct push_notification_driver_config;
struct push_notification_driver_txn;
struct push_notification_driver_user;
struct push_notification_txn_mbox;
struct push_notification_txn_msg;


HASH_TABLE_DEFINE_TYPE(push_notification_config, const char *, const char *);
HASH_TABLE_DEFINE_TYPE(push_notification_msgs, void *,
                       struct push_notification_txn_msg *);


struct push_notification_driver_vfuncs {
    /* Init driver. Config (from plugin configuration) is parsed once (no
     * user variable substitutions). Return 0 on success, or -1 if this
     * driver should be disabled (or on error). */
    int (*init)(struct push_notification_driver_config *config,
                struct mail_user *user, pool_t pool, void **context,
                const char **error_r);
    /* Called at the beginning of a notification transaction. Return TRUE on
     * success, or FALSE if this driver should be ignored for this
     * transaction. */
    bool (*begin_txn)(struct push_notification_driver_txn *dtxn);
    /* Called once for every mailbox processed. */
    void (*process_mbox)(struct push_notification_driver_txn *dtxn,
                         struct push_notification_txn_mbox *mbox);
    /* Called once for every message processed. */
    void (*process_msg)(struct push_notification_driver_txn *dtxn,
                        struct push_notification_txn_msg *msg);
    /* Called at the end of a successful notification transaction. */
    void (*end_txn)(struct push_notification_driver_txn *dtxn, bool success);
    /* Called when plugin is deinitialized. */
    void (*deinit)(struct push_notification_driver_user *duser);
    /* Called to cleanup any global resources used in plugin. */
    void (*cleanup)(void);
};

struct push_notification_driver {
    const char *name;
    struct push_notification_driver_vfuncs v;
};

struct push_notification_driver_config {
    HASH_TABLE_TYPE(push_notification_config) config;
    const char *raw_config;
};

struct push_notification_driver_user {
    const struct push_notification_driver *driver;
    void *context;
};

struct push_notification_driver_txn {
    const struct push_notification_driver_user *duser;
    struct push_notification_txn *ptxn;

    /* Transaction context. */
    void *context;
};

struct push_notification_driver_list {
    ARRAY(struct push_notification_driver_user *) drivers;
};

struct push_notification_user {
    union mail_user_module_context module_ctx;
    struct push_notification_driver_list *driverlist;
};

struct push_notification_trigger_ctx {
    const char *name;
    void *context;
};

struct push_notification_txn {
    pool_t pool;

    struct mailbox *mbox;
    struct mail_user *muser;
    struct push_notification_user *puser;
    bool initialized;

    enum push_notification_event_trigger trigger;
    struct push_notification_trigger_ctx *trigger_ctx;
    ARRAY(struct push_notification_driver_txn *) drivers;
    ARRAY(struct push_notification_event_config *) events;

    /* Used with mailbox events. */
    struct push_notification_txn_mbox *mbox_txn;

    /* Used with mailbox events. */
    HASH_TABLE_TYPE(push_notification_msgs) messages;

    /* Private (used with message events). */
    struct mailbox_transaction_context *t;
};


int
push_notification_driver_init(struct mail_user *user, const char *config_in,
                              pool_t pool,
                              struct push_notification_driver_user **duser_r);
void push_notification_driver_cleanup_all(void);

void ATTR_FORMAT(3, 4)
push_notification_driver_debug(const char *label, struct mail_user *user,
                               const char *fmt, ...);

void push_notification_driver_register
(const struct push_notification_driver *driver);
void push_notification_driver_unregister
(const struct push_notification_driver *driver);


#endif /* PUSH_NOTIFICATION_DRIVERS_H */