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