share/doc/psd/05.sysman/a.t

   1 .\" Copyright (c) 1983, 1993
   2 .\"     The Regents of the University of California.  All rights reserved.
   3 .\"
   4 .\" Redistribution and use in source and binary forms, with or without
   5 .\" modification, are permitted provided that the following conditions
   6 .\" are met:
   7 .\" 1. Redistributions of source code must retain the above copyright
   8 .\"    notice, this list of conditions and the following disclaimer.
   9 .\" 2. Redistributions in binary form must reproduce the above copyright
  10 .\"    notice, this list of conditions and the following disclaimer in the
  11 .\"    documentation and/or other materials provided with the distribution.
  12 .\" 3. Neither the name of the University nor the names of its contributors
  13 .\"    may be used to endorse or promote products derived from this software
  14 .\"    without specific prior written permission.
  15 .\"
  16 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  17 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  18 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  19 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  20 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  21 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  22 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  23 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  24 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  25 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  26 .\" SUCH DAMAGE.
  27 .\"
  28 .\"     @(#)a.t 8.1 (Berkeley) 6/8/93
  29 .\"
  30 .ds RH Summary of facilities
  31 .bp
  32 .SH
  33 \s+2I.  Summary of facilities\s0
  34 .PP
  35 .de h
  36 .br
  37 .if n .ne 8
  38 \fB\\$1 \\$2\fP
  39 .br
  40 ..
  41 .nr H1 0
  42 .NH
  43 Kernel primitives
  44 .LP
  45 .h 1.1. "Process naming and protection
  46 .in +5
  47 .TS
  48 lw(1.6i) aw(3i).
  49 sethostid       set UNIX host id
  50 gethostid       get UNIX host id
  51 sethostname     set UNIX host name
  52 gethostname     get UNIX host name
  53 getpid  get process id
  54 fork    create new process
  55 exit    terminate a process
  56 execve  execute a different process
  57 getuid  get user id
  58 geteuid get effective user id
  59 setreuid        set real and effective user id's
  60 getgid  get accounting group id
  61 getegid get effective accounting group id
  62 getgroups       get access group set
  63 setregid        set real and effective group id's
  64 setgroups       set access group set
  65 getpgrp get process group
  66 setpgrp set process group
  67 .TE
  68 .in -5
  69 .h 1.2 "Memory management
  70 .in +5
  71 .TS
  72 lw(1.6i) aw(3i).
  73 <sys/mman.h>    memory management definitions
  74 sbrk    change data section size
  75 sstk\(dg        change stack section size
  76 getpagesize     get memory page size
  77 mmap\(dg        map pages of memory
  78 msync\(dg       flush modified mapped pages to filesystem
  79 munmap\(dg      unmap memory
  80 mprotect\(dg    change protection of pages
  81 madvise\(dg     give memory management advice
  82 mincore\(dg     determine core residency of pages
  83 msleep\(dg      sleep on a lock
  84 mwakeup\(dg     wakeup process sleeping on a lock
  85 .TE
  86 .FS
  87 \(dg Not supported in 4.3BSD.
  88 .FE
  89 .in -5
  90 .h 1.3 "Signals
  91 .in +5
  92 .TS
  93 lw(1.6i) aw(3i).
  94 <signal.h>      signal definitions
  95 sigvec  set handler for signal
  96 kill    send signal to process
  97 killpgrp        send signal to process group
  98 sigblock        block set of signals
  99 sigsetmask      restore set of blocked signals
 100 sigpause        wait for signals
 101 sigstack        set software stack for signals
 102 .TE
 103 .in -5
 104 .h 1.4 "Timing and statistics
 105 .in +5
 106 .TS
 107 lw(1.6i) aw(3i).
 108 <sys/time.h>    time-related definitions
 109 gettimeofday    get current time and timezone
 110 settimeofday    set current time and timezone
 111 getitimer       read an interval timer
 112 setitimer       get and set an interval timer
 113 profil  profile process
 114 .TE
 115 .in -5
 116 .h 1.5 "Descriptors
 117 .in +5
 118 .TS
 119 lw(1.6i) aw(3i).
 120 getdtablesize   descriptor reference table size
 121 dup     duplicate descriptor
 122 dup2    duplicate to specified index
 123 close   close descriptor
 124 select  multiplex input/output
 125 fcntl   control descriptor options
 126 wrap\(dg        wrap descriptor with protocol
 127 .TE
 128 .FS
 129 \(dg Not supported in 4.3BSD.
 130 .FE
 131 .in -5
 132 .h 1.6 "Resource controls
 133 .in +5
 134 .TS
 135 lw(1.6i) aw(3i).
 136 <sys/resource.h>        resource-related definitions
 137 getpriority     get process priority
 138 setpriority     set process priority
 139 getrusage       get resource usage
 140 getrlimit       get resource limitations
 141 setrlimit       set resource limitations
 142 .TE
 143 .in -5
 144 .h 1.7 "System operation support
 145 .in +5
 146 .TS
 147 lw(1.6i) aw(3i).
 148 mount   mount a device file system
 149 swapon  add a swap device
 150 umount  umount a file system
 151 sync    flush system caches
 152 reboot  reboot a machine
 153 acct    specify accounting file
 154 .TE
 155 .in -5
 156 .NH
 157 System facilities
 158 .LP
 159 .h 2.1 "Generic operations
 160 .in +5
 161 .TS
 162 lw(1.6i) aw(3i).
 163 read    read data
 164 write   write data
 165 <sys/uio.h>     scatter-gather related definitions
 166 readv   scattered data input
 167 writev  gathered data output
 168 <sys/ioctl.h>   standard control operations
 169 ioctl   device control operation
 170 .TE
 171 .in -5
 172 .h 2.2 "File system
 173 .PP
 174 Operations marked with a * exist in two forms: as shown,
 175 operating on a file name, and operating on a file descriptor,
 176 when the name is preceded with a ``f''.
 177 .in +5
 178 .TS
 179 lw(1.6i) aw(3i).
 180 <sys/file.h>    file system definitions
 181 chdir   change directory
 182 chroot  change root directory
 183 mkdir   make a directory
 184 rmdir   remove a directory
 185 open    open a new or existing file
 186 mknod   make a special file
 187 portal\(dg      make a portal entry
 188 unlink  remove a link
 189 stat*   return status for a file
 190 lstat   returned status of link
 191 chown*  change owner
 192 chmod*  change mode
 193 utimes  change access/modify times
 194 link    make a hard link
 195 symlink make a symbolic link
 196 readlink        read contents of symbolic link
 197 rename  change name of file
 198 lseek   reposition within file
 199 truncate*       truncate file
 200 access  determine accessibility
 201 flock   lock a file
 202 .TE
 203 .in -5
 204 .h 2.3 "Communications
 205 .in +5
 206 .TS
 207 lw(1.6i) aw(3i).
 208 <sys/socket.h>  standard definitions
 209 socket  create socket
 210 bind    bind socket to name
 211 getsockname     get socket name
 212 listen  allow queuing of connections
 213 accept  accept a connection
 214 connect connect to peer socket
 215 socketpair      create pair of connected sockets
 216 sendto  send data to named socket
 217 send    send data to connected socket
 218 recvfrom        receive data on unconnected socket
 219 recv    receive data on connected socket
 220 sendmsg send gathered data and/or rights
 221 recvmsg receive scattered data and/or rights
 222 shutdown        partially close full-duplex connection
 223 getsockopt      get socket option
 224 setsockopt      set socket option
 225 .TE
 226 .in -5
 227 .h 2.4 "Terminals, block and character devices
 228 .in +5
 229 .in -5
 230 .h 2.5 "Processes and kernel hooks
 231 .in +5