man/man2/svrctl.2

   1 .\" svrctl.2
   2 .\"
   3 .\" Created: July, 1994 by Philip Homburg <philip@cs.vu.nl>
   4 .TH svrctl 2
   5 .SH NAME
   6 svrctl \- special server control functions
   7 .SH SYNOPSIS
   8 .nf
   9 .ft B
  10 #include <sys/svrctl.h>
  11
  12 int svrctl(u32_t \fIrequest\fP, void *\fIdata\fP);
  13 .ft R
  14 .fi
  15 .SH DESCRIPTION
  16 .B Svrctl
  17 allows root to control the kernel in various ways, or implements some very
  18 MINIX 3 specific system calls that don't deserve their own system call number.
  19 .PP
  20 This system call makes it easy to add new ways of setting and getting kernel
  21 parameters, but at the same time, backwards compatibility is not guaranteed.
  22 Read the <sys/svrctl.h> include file to see what the struct's mentioned below
  23 look like.  Most calls are root-only, unless specified otherwise.
  24 .PP
  25 The only way to know how to properly use these calls is to study the
  26 associated kernel or server code, or the programs that already use these
  27 calls.
  28 .PP
  29 Current requests are:
  30 .TP 5
  31 .B MMSIGNON
  32 Inform MM that the current process wants to become a server.
  33 .TP
  34 .B MMSWAPON
  35 Instruct MM to mount a file or device as swapspace.
  36 .TP
  37 .B MMSWAPOFF
  38 Tell MM to stop using swapspace.
  39 .TP
  40 .B FSSIGNON
  41 Register a new device with FS.
  42 .ig
  43 .TP
  44 .B FSDEVMAP
  45 Translate a device number to a task number, minor device pair using a
  46 \fBstruct fsdevmap\fP
  47 ..
  48 .TP
  49 .B SYSSIGNON
  50 Inform the kernel that the process want to become a server.
  51 The processes task number is filled-in in a \fBstruct systaskinfo\fP.
  52 .TP
  53 .B SYSGETENV
  54 Request the value of one or all boot parameters.  Can be used by non-root.
  55 .SH "RETURN VALUES"
  56 .B Svrctl
  57 returns 0 upon success and -1 upon failure.
  58 .SH AUTHOR
  59 Philip Homburg <philip@cs.vu.nl>