granicus.if.org Git - postgresql/blob - src/include/storage/dsm.h

   1 /*-------------------------------------------------------------------------
   2  *
   3  * dsm.h
   4  *        manage dynamic shared memory segments
   5  *
   6  * Portions Copyright (c) 1996-2017, 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 /* A sentinel value for an invalid DSM handle. */
  23 #define DSM_HANDLE_INVALID 0
  24
  25 /* Startup and shutdown functions. */
  26 struct PGShmemHeader;                   /* avoid including pg_shmem.h */
  27 extern void dsm_cleanup_using_control_segment(dsm_handle old_control_handle);
  28 extern void dsm_postmaster_startup(struct PGShmemHeader *);
  29 extern void dsm_backend_shutdown(void);
  30 extern void dsm_detach_all(void);
  31
  32 #ifdef EXEC_BACKEND
  33 extern void dsm_set_control_handle(dsm_handle h);
  34 #endif
  35
  36 /* Functions that create, update, or remove mappings. */
  37 extern dsm_segment *dsm_create(Size size, int flags);
  38 extern dsm_segment *dsm_attach(dsm_handle h);
  39 extern void *dsm_resize(dsm_segment *seg, Size size);
  40 extern void *dsm_remap(dsm_segment *seg);
  41 extern void dsm_detach(dsm_segment *seg);
  42
  43 /* Resource management functions. */
  44 extern void dsm_pin_mapping(dsm_segment *seg);
  45 extern void dsm_unpin_mapping(dsm_segment *seg);
  46 extern void dsm_pin_segment(dsm_segment *seg);
  47 extern void dsm_unpin_segment(dsm_handle h);
  48 extern dsm_segment *dsm_find_mapping(dsm_handle h);
  49
  50 /* Informational functions. */
  51 extern void *dsm_segment_address(dsm_segment *seg);
  52 extern Size dsm_segment_map_length(dsm_segment *seg);
  53 extern dsm_handle dsm_segment_handle(dsm_segment *seg);
  54
  55 /* Cleanup hooks. */
  56 typedef void (*on_dsm_detach_callback) (dsm_segment *, Datum arg);
  57 extern void on_dsm_detach(dsm_segment *seg,
  58                           on_dsm_detach_callback function, Datum arg);
  59 extern void cancel_on_dsm_detach(dsm_segment *seg,
  60                                          on_dsm_detach_callback function, Datum arg);
  61 extern void reset_on_dsm_detach(void);
  62
  63 #endif   /* DSM_H */