Interface between ccmkkernel and the Operating-System … More...

#include <LibMkKernel_mk.h>

Collaboration diagram for libmkkernel::MkLalS:

Public Attributes
MkSysCallocF	SysCalloc
	calloc syscall …

MkSysMallocF	SysMalloc
	malloc syscall …

MkSysReallocF	SysRealloc
	realloc syscall …

MkSysStrNDupF	SysStrNDup
	strndup syscall …

MkSysStrDupF	SysStrDup
	strdup syscall …

MkSysStrNCpyF	SysStrNCpy
	strdup strncpy …

MkSysFreeF	SysFree
	free syscall …

MkSysForkF	SysFork
	fork syscall …

MK_PTR	SysForkData

MkSysWaitF	MkSysWaitForProcessCB
	wait for process to finish syscall with ccmkkernel error plugin

MkSysWaitF	MkSysWaitForThreadCB
	wait for process to finish syscall with ccmkkernel error plugin

enum MkErrorE(*	SysUSleep )(MK_OBJN const obj, unsigned int const usec)
	usleep syscall with ccmkkernel error plugin

enum MkErrorE(*	SysSleep )(MK_OBJN const obj, unsigned int const sec)
	sleep syscall with ccmkkernel error plugin

enum MkErrorE(*	SysDaemonize )(MK_RT mkrt, MK_OBJN const obj, MK_STRN pidfile)
	demonize the current process and save the resulting PID into the pidfile …

MkSysExitF	MkSysExitCB

void(*	SysAbort )(void) MK_NO_RETURN
	abort syscall …

enum MkErrorE(*	SysIgnorSIGCHLD )(MK_RT mkrt, MK_OBJ const obj)

enum MkErrorE(*	SysAllowSIGCHLD )(MK_RT mkrt, MK_OBJ const obj)

Detailed Description

Interface between ccmkkernel and the Operating-System …

Definition at line 2583 of file LibMkKernel_mk.h.

Member Data Documentation

◆ MkSysExitCB

MkSysExitF libmkkernel::MkLalS::MkSysExitCB

Example:

static int SysExit (
  MK_RT_ARGS
  int isThread,                     
  int num                           
) {
  if (isThread) {
#if META_HAS_THREAD
# if defined(HAVE_PTHREAD)
 
/*
already detached thread
// BUG-FIX-pthread_detach
// "pthread_detach" disable "pthread_join" (calling thread!!) and create a "random-crash" in "MkSysWait" called by "pIoDelete"
 
    int state, retI;
    pthread_t tid = pthread_self();
    pthread_attr_t attr;
    retI = pthread_getattr_np(tid, &attr);
      if (retI != 0) { perror("SysExit-pthread_getattr_np: "); goto exit; }
    retI = pthread_attr_getdetachstate(&attr, &state);
      if (retI != 0) { perror("SysExit-pthread_attr_getdetachstate: "); goto exit; }
    retI = pthread_attr_destroy(&attr);
      if (retI != 0) { perror("SysExit-pthread_attr_destroy: "); goto exit; }
    if (state == PTHREAD_CREATE_DETACHED) {
      retI = pthread_detach(tid);
        if (retI != 0) { perror("SysExit-pthread_detach: "); goto exit; }
    }
exit:
*/
    pthread_exit(NULL);
# elif defined(META_IS_WINDOWS)
   _endthreadex(num);
# endif
#endif   /* META_HAS_THREAD */
#if 1
  }
  exit(num);
#else
  } else {
    exit(num);
  }
#endif
  return num;
}

Attention: no MK_NO_RETURN besause the MkSysExitF can be an overload with MkLalS::MkSysExitCB

Definition at line 2648 of file LibMkKernel_mk.h.

◆ MkSysWaitForProcessCB

MkSysWaitF libmkkernel::MkLalS::MkSysWaitForProcessCB

wait for process to finish syscall with ccmkkernel error plugin

Parameters

[in]	fmtobj	managed object used to format the log-message (default=`MK_NULL` → use default-format)
[in]	id	process handle

Exceptions

MkExceptionC → The default-exception from the Programming-Language-Micro-Kernel (PLMK)

See also: MkSysWaitForProcess, MkSysWaitForThread

Definition at line 2602 of file LibMkKernel_mk.h.

◆ MkSysWaitForThreadCB

MkSysWaitF libmkkernel::MkLalS::MkSysWaitForThreadCB

wait for process to finish syscall with ccmkkernel error plugin

Parameters

[in]	fmtobj	managed object used to format the log-message (default=`MK_NULL` → use default-format)
[in]	id	process handle

Exceptions

MkExceptionC → The default-exception from the Programming-Language-Micro-Kernel (PLMK)

See also: MkSysWaitForProcess, MkSysWaitForThread

Definition at line 2604 of file LibMkKernel_mk.h.

◆ SysAbort

void(* libmkkernel::MkLalS::SysAbort) (void) MK_NO_RETURN

abort syscall …

additional info: man abort

Exceptions

MkExceptionC → The default-exception from the Programming-Language-Micro-Kernel (PLMK)

Example:

MK_NO_RETURN static void SysAbort (void) {
  abort();
}

Definition at line 2659 of file LibMkKernel_mk.h.

◆ SysAllowSIGCHLD

enum MkErrorE(* libmkkernel::MkLalS::SysAllowSIGCHLD) (MK_RT mkrt, MK_OBJ const obj)

Definition at line 2659 of file LibMkKernel_mk.h.

◆ SysCalloc

MkSysCallocF libmkkernel::MkLalS::SysCalloc

calloc syscall …

additional info: man calloc

Definition at line 2585 of file LibMkKernel_mk.h.

◆ SysDaemonize

enum MkErrorE(* libmkkernel::MkLalS::SysDaemonize) (MK_RT mkrt, MK_OBJN const obj, MK_STRN pidfile)

demonize the current process and save the resulting PID into the pidfile …

Parameters

[in]	obj	...
[in]	pidfile	file to save the process identifier, can be used to kill the process later

Exceptions

MkExceptionC → The default-exception from the Programming-Language-Micro-Kernel (PLMK)

Example:

static enum MkErrorE SysDaemonize (
  MK_RT_ARGS
  MK_OBJN const errobj,
  MK_STRN pidfile
) {
#if defined(META_IS_POSIX) && !defined(__CYGWIN__)
  int fd, fpid;
  struct MkIdS id;
 
  // step 0 -> open the pidfile
  if ((fpid = open(pidfile, O_WRONLY|O_CREAT|O_TRUNC, S_IRUSR|S_IWUSR|S_IRGRP|S_IROTH)) == -1) 
    return MkErrorSysOS (open);
 
  // step 1 -> delete initial process
  MkErrorCheck(pMkSysFork(MK_RT_CALL errobj, &id));
  if (id.val != 0UL)
    _exit(0);
 
  // step 2 -> create a new session
  if (setsid() == -1)
    return MkErrorSysOS (setsid);
 
  // step 3 -> fork the new process, parent write the pid
  MkErrorCheck(pMkSysFork(MK_RT_CALL errobj, &id));
  if (id.val != 0UL) {
    char buf[40];
    int num = snprintf(buf, 40, "%lu", (long unsigned)id.val);
    write(fpid,buf,(size_t)num);
    _exit(0);
  }
 
  // step 4 -> close the fpid after writing
  if (close(fpid) == -1)
    return MkErrorSys (close);
 
  // step 5 -> close default io
  fd = open("/dev/null", O_RDONLY);
  if (fd != 0) {
    dup2(fd, 0);
    close(fd);
  }
  fd = open("/dev/null", O_WRONLY);
  if (fd != 1) {
    dup2(fd, 1);
    close(fd);
  }
  fd = open("/dev/null", O_WRONLY);
  if (fd != 2) {
    dup2(fd, 2);
    close(fd);
  }
 
  return MK_OK;
error:
  return MkErrorStack_1M(errobj);
#else
  return MkErrorDbV_1_OS(MK_ERROR_NOT_SUPPORTED, "SysDaemonize");
#endif
}

Definition at line 2604 of file LibMkKernel_mk.h.

◆ SysFork

MkSysForkF libmkkernel::MkLalS::SysFork

fork syscall …

additional info: man fork

Returns: the process identifier of the new child (in the parent process) or 0 (in the child process)

Definition at line 2599 of file LibMkKernel_mk.h.

◆ SysForkData

MK_PTR libmkkernel::MkLalS::SysForkData

Definition at line 2600 of file LibMkKernel_mk.h.

◆ SysFree

MkSysFreeF libmkkernel::MkLalS::SysFree

free syscall …

additional info: man free

Definition at line 2597 of file LibMkKernel_mk.h.

◆ SysIgnorSIGCHLD

enum MkErrorE(* libmkkernel::MkLalS::SysIgnorSIGCHLD) (MK_RT mkrt, MK_OBJ const obj)

Definition at line 2659 of file LibMkKernel_mk.h.

◆ SysMalloc

MkSysMallocF libmkkernel::MkLalS::SysMalloc

malloc syscall …

additional info: man malloc

Definition at line 2587 of file LibMkKernel_mk.h.

◆ SysRealloc

MkSysReallocF libmkkernel::MkLalS::SysRealloc

realloc syscall …

additional info: man realloc

Definition at line 2589 of file LibMkKernel_mk.h.

◆ SysSleep

enum MkErrorE(* libmkkernel::MkLalS::SysSleep) (MK_OBJN const obj, unsigned int const sec)

sleep syscall with ccmkkernel error plugin

Parameters

[in]	fmtobj	managed object used to format the log-message (default=`MK_NULL` → use default-format)
[in]	sec	the seconds to sleep

Exceptions

MkExceptionC → The default-exception from the Programming-Language-Micro-Kernel (PLMK)

Example:

static enum MkErrorE SysSleep (
  MK_OBJN const errobj,
  unsigned int const sec
) {
#if defined(META_IS_POSIX)
  if (sleep (sec) != 0) {
    return MkErrorSys (sleep);
  }
#elif defined (META_IS_WINDOWS)
  Sleep (sec * 1000);
#else
#   error not supported
#endif
  return MK_OK;
}

Definition at line 2604 of file LibMkKernel_mk.h.

◆ SysStrDup

MkSysStrDupF libmkkernel::MkLalS::SysStrDup

strdup syscall …

additional info: man strdup

Definition at line 2593 of file LibMkKernel_mk.h.

◆ SysStrNCpy

MkSysStrNCpyF libmkkernel::MkLalS::SysStrNCpy

strdup strncpy …

additional info: man strncpy

Definition at line 2595 of file LibMkKernel_mk.h.

◆ SysStrNDup

MkSysStrNDupF libmkkernel::MkLalS::SysStrNDup

strndup syscall …

additional info: man strndup

Definition at line 2591 of file LibMkKernel_mk.h.

◆ SysUSleep

enum MkErrorE(* libmkkernel::MkLalS::SysUSleep) (MK_OBJN const obj, unsigned int const usec)

usleep syscall with ccmkkernel error plugin

Parameters

[in]	fmtobj	managed object used to format the log-message (default=`MK_NULL` → use default-format)
[in]	usec	the micro (10^-6) seconds to sleep

Exceptions

MkExceptionC → The default-exception from the Programming-Language-Micro-Kernel (PLMK)

Example:

static enum MkErrorE SysUSleep (
  MK_OBJN const errobj,
  unsigned int const usec
) {
#if defined(META_IS_POSIX)
  usleep (usec);
#elif defined (META_IS_WINDOWS)
  Sleep ((usec + 500) / 1000);
#else
#   error not supported
#endif
  return MK_OK;
}
 
static enum MkErrorE SysSleep (
  MK_OBJN const errobj,
  unsigned int const sec
) {
#if defined(META_IS_POSIX)
  if (sleep (sec) != 0) {
    return MkErrorSys (sleep);
  }

Definition at line 2604 of file LibMkKernel_mk.h.

The documentation for this struct was generated from the following file:

LibMkKernel_mk.h

Public Attributes

Detailed Description

Member Data Documentation

◆ MkSysExitCB

◆ MkSysWaitForProcessCB

◆ MkSysWaitForThreadCB

◆ SysAbort

◆ SysAllowSIGCHLD

◆ SysCalloc

◆ SysDaemonize

◆ SysFork

◆ SysForkData

◆ SysFree

◆ SysIgnorSIGCHLD

◆ SysMalloc

◆ SysRealloc

◆ SysSleep

◆ SysStrDup

◆ SysStrNCpy

◆ SysStrNDup

◆ SysUSleep