1 /*------------------------------------------------------------------------- 2 * 3 * dsm.h 4 * manage dynamic shared memory segments 5 * 6 * Portions Copyright (c) 1996-2016, PostgreSQL Global Development Group 7 * Portions Copyright (c) 1994, Regents of the University of California 8 * 9 * src/include/storage/dsm.h 10 * 11 *------------------------------------------------------------------------- 12 */ 13 #ifndef DSM_H 14 #define DSM_H 15 16 #include "storage/dsm_impl.h" 17 18 typedef struct dsm_segment dsm_segment; 19 20 #define DSM_CREATE_NULL_IF_MAXSEGMENTS 0x0001 21 22 /* Startup and shutdown functions. */ 23 struct PGShmemHeader; /* avoid including pg_shmem.h */ 24 extern void dsm_cleanup_using_control_segment(dsm_handle old_control_handle); 25 extern void dsm_postmaster_startup(struct PGShmemHeader *); 26 extern void dsm_backend_shutdown(void); 27 extern void dsm_detach_all(void); 28 29 #ifdef EXEC_BACKEND 30 extern void dsm_set_control_handle(dsm_handle h); 31 #endif 32 33 /* Functions that create, update, or remove mappings. */ 34 extern dsm_segment *dsm_create(Size size, int flags); 35 extern dsm_segment *dsm_attach(dsm_handle h); 36 extern void *dsm_resize(dsm_segment *seg, Size size); 37 extern void *dsm_remap(dsm_segment *seg); 38 extern void dsm_detach(dsm_segment *seg); 39 40 /* Resource management functions. */ 41 extern void dsm_pin_mapping(dsm_segment *seg); 42 extern void dsm_unpin_mapping(dsm_segment *seg); 43 extern void dsm_pin_segment(dsm_segment *seg); 44 extern dsm_segment *dsm_find_mapping(dsm_handle h); 45 46 /* Informational functions. */ 47 extern void *dsm_segment_address(dsm_segment *seg); 48 extern Size dsm_segment_map_length(dsm_segment *seg); 49 extern dsm_handle dsm_segment_handle(dsm_segment *seg); 50 51 /* Cleanup hooks. */ 52 typedef void (*on_dsm_detach_callback) (dsm_segment *, Datum arg); 53 extern void on_dsm_detach(dsm_segment *seg, 54 on_dsm_detach_callback function, Datum arg); 55 extern void cancel_on_dsm_detach(dsm_segment *seg, 56 on_dsm_detach_callback function, Datum arg); 57 extern void reset_on_dsm_detach(void); 58 59 #endif /* DSM_H */ 60