fam.h

/*
 * Copyright regify
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
 * in the Software without restriction, including without limitation the rights
 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 * copies of the Software, and to permit persons to whom the Software is
 * furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in
 * all copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 * SOFTWARE.
 */
#ifndef REGIFY_UTIL_FAM_H
#define REGIFY_UTIL_FAM_H
 
/* Only need to export C interface if used by C++ source code */
#ifdef __cplusplus
extern "C" {
#endif /* __cplusplus */
 
 
#define RU_FAM_CREATED     0x001
#define RU_FAM_DELETED     0x002
#define RU_FAM_MODIFIED    0x004
#define RU_FAM_MOVED       0x008
#define RU_FAM_ATTRIB      0x010
 
#define RU_FAM_KILL_TIMEOUT    5
#define RU_FAM_POLL_TIMEOUT    250
#define RU_FAM_QUEUE_TIMEOUT   50
 
typedef struct ruFamEvent_ ruFamEvent;
struct ruFamEvent_ {
    int eventType;          // type of event #fam_*
    perm_chars srcPath;     // object file path
    perm_chars dstPath;     // destination path for #RU_FAM_MOVED
};
 
typedef void (*ruFamHandler) (ruFamEvent* fe, perm_ptr ctx);
 
typedef void* ruFamCtx;
 
 
RUAPI ruFamCtx ruFamMonitorFilePath(trans_chars filePath, trans_chars threadName,
                                    ruFamHandler eventCallBack, perm_ptr ctx);
 
RUAPI ruFamCtx ruFamKillMonitor(ruFamCtx o);
 
RUAPI bool ruFamQuit(ruFamCtx o);
 
RUAPI const char* ruFamEventTypeString(int32_t action);
 
RUAPI void ruFamLogEventFunc(uint32_t loglevel, trans_chars file, trans_chars func,
                             int32_t line, ruFamEvent *fe, trans_chars prefix);
 
#define ruFamEventLog(lvl, fe, prefix) ruMacStart { \
    if(ruDoesLog(lvl)) { \
        ruFamLogEventFunc(lvl, __FILE__, __func__, __LINE__, fe, prefix); \
    } \
} ruMacEnd
 
RUAPI char* ruFamEventString(ruFamEvent* fe);
 
RUAPI ruFamEvent* ruFamEventNew(int eventType, trans_chars filePath, trans_chars destPath);
 
RUAPI ptr ruFamEventFree(ptr o);
 
#ifdef __cplusplus
}
#endif /* __cplusplus */
#endif //REGIFY_UTIL_FAM_H