d/freebsd-nq
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
146,021 Commits 6 Branches 133 Tags 2.6 GiB
ee94c7ef01
Commit Graph

1199 Commits

Author SHA1 Message Date
Pawel Jakub Dawidek
d1eb7b96e7 When immutable, undeletable or append-only flag is set, rename(2) 
return EPERM.
 2006-12-09 19:19:46 +00:00
Pawel Jakub Dawidek
858e6c9cbd When undeletable flag is set, unlink(2) return EPERM. 2006-12-09 19:18:39 +00:00
Ruslan Ermilov
a82e937c0b Grammar. 
OK'ed by:	sam
 2006-12-04 20:34:25 +00:00
Sam Leffler
78e3a7fdd5 document recent change to return ECONNRESET for tcp sockets 
MFC after:	1 month
 2006-12-04 18:39:11 +00:00
Yaroslav Tykhiy
df19774d2f Note that, thanks to the work by Alan Cox et al, some arch'es 
don't need sendfile() buffers any more.

The report on the work referenced can be found at
http://usenix.org/events/usenix05/tech/general/elmeleegy.html

MFC after:	1 week
 2006-11-24 11:44:19 +00:00
John Baldwin
8cc7b0f93d Document that the data field for NOTE_EXIT holds the process exit status. 
Submitted by:	Jared Yanovich -phirerunner at comcast.net-
MFC after:	2 weeks
 2006-11-20 22:20:04 +00:00
Tom Rhodes
c74824fe88 Add an entry for PT_GETLWPLIST. 
Nudged by:	jhb
Reviewed by:	davidxu
 2006-11-09 11:27:18 +00:00
Robert Watson
21f62f0771 Remove sys/uio.h include -- this is no longer required by the extattr 
system call API.

MFC after:	3 weeks
 2006-11-06 15:12:43 +00:00
Daniel Gerzo
137e54d3db - clock_gettime is in time.h instead of sys/time.h 
Approved by: trhodes (mentor), keramida (mentor)
PR: docs/104707
MFC-after: 3 days
 2006-11-04 09:35:36 +00:00
Ruslan Ermilov
f19110addc Replace the SEE ALSO xrefs with a more reasonable set stolen from POSIX. 2006-11-02 14:10:56 +00:00
Pawel Jakub Dawidek
a722f8df9e Document MNT_GJOURNAL option. 2006-11-01 23:40:44 +00:00
Simon L. B. Nielsen
27111d392c Minor markup fix: A comma should be seperated by space from macro 
argument.  This resulted in "pwritev,()" instead of the intended
"pwritev()," in the output.

MFC after:	3 days
 2006-10-21 20:36:50 +00:00
Ruslan Ermilov
2aeccd6ea7 Avoid a potential hard sentence break. 2006-10-21 18:03:53 +00:00
Ruslan Ermilov
b13b4f6ffd Use normal parentheses. 
PR:		docs/84549
Submitted by:	Gary W. Swearingen
MFC after:	3 days
 2006-10-12 20:50:26 +00:00
Ruslan Ermilov
17cba6de53 Link select(2) to FD_CLR(3), FD_ISSET(3), FD_SET(3), and FD_ZERO(3). 
PR:		docs/57974
MFC after:	3 days
 2006-10-12 13:46:33 +00:00
Ruslan Ermilov
942bfcd744 Document S_IRWXU and permission bits for group/other. 
PR:		docs/57153
MFC after:	3 days
 2006-10-12 13:35:07 +00:00
Maxim Konovalov
1be947e9f8 o Follow the trend and try to explain what the slow device is. 
Not ideal but better than nothing.

Obtained from:	OpenBSD, NetBSD
 2006-10-11 13:33:02 +00:00
Tom Rhodes
dfe25dc456 Reword previous delta a little bit. 
Submitted by:	ru
 2006-10-07 10:49:20 +00:00
Tom Rhodes
1ae5dc92c0 Fix ambiguity in description. Note that the aio_return() system call should 
only be called once after failure or completion of an AIO request.  Bump doc
date while I'm here.

Noticed by:	Samy Al Bahra
 2006-10-07 05:34:51 +00:00
Tom Rhodes
ef5566e8fc Add missing word "returns." 
Noticed by:	Samy Al Bahra
 2006-10-07 05:13:32 +00:00
Ruslan Ermilov
bb4b8a9dd4 Fix markup, language, function prototype, and example code. 2006-09-30 10:24:00 +00:00
Vasil Dimov
23883885a3 Fix typo 
PR:		docs/103666
Submitted by:	vd
Approved by:	maxim
 2006-09-26 09:47:46 +00:00
David Xu
d31279c4e7 remove thr_getscheduler, thr_setscheduler, thr_setschedparam, 
add rtprio_thread.
 2006-09-21 04:22:46 +00:00
Ruslan Ermilov
a73a3ab56b Markup fixes. 2006-09-17 21:27:35 +00:00
Ruslan Ermilov
b31a663480 Remove more traces of Alpha. 2006-09-17 20:53:30 +00:00
Joel Dahl
f832d58dc8 Remove reference to T/TCP. 
Reviewed by:	andre
 2006-09-13 19:48:00 +00:00
Brian Somers
cd0ac75c13 Fix a typo 2006-09-10 20:41:33 +00:00
Ceri Davies
d2b2ccea4c Note that the system only allows a maximum of kern.kq_calloutmax timers. 
PR:		docs/102353
Submitted by:	phk
MFC after:	1 week
 2006-08-25 15:19:47 +00:00
Wes Peters
25dbf7fe4e Document EAGAIN failure per PR. (Finally!) 
PR:		24125
 2006-08-16 02:56:51 +00:00
Pawel Jakub Dawidek
225ee44c8a We operate on 'statfs' structures, not on 'fsstat' structures. 
MFC after:	3 days
 2006-08-15 18:17:03 +00:00
Yaroslav Tykhiy
776fc0e90e Commit the results of the typo hunt by Darren Pilgrim. 
This change affects documentation and comments only,
no real code involved.

PR:		misc/101245
Submitted by:	Darren Pilgrim <darren pilgrim bitfreak org>
Tested by:	md5(1)
MFC after:	1 week
 2006-08-04 07:56:35 +00:00
Norikatsu Shigemura
27a9d57fed Add missing ;. 
Pointy hat to:	myself
Approved by:	deischen (implicitly)
 2006-07-23 15:53:12 +00:00
Norikatsu Shigemura
e257c93bbc Add missing syscalls. 
Reviewed by:	deischen
Approved by:	deischen
 2006-07-23 13:08:54 +00:00
Konstantin Belousov
455dd7d4c7 Make the mincore(2) return ENOMEM when requested range is not fully mapped. 
Requested by:	Bruno Haible <bruno at clisp org>
Reviewed by:	alc
Approved by:	pjd (mentor)
MFC after:	1 month
 2006-06-21 12:59:05 +00:00
Maxim Konovalov
05922cdfcc o Sort .Xrs. 2006-06-13 12:49:14 +00:00
Poul-Henning Kamp
dfe969585d Add xref to statfs(2) 2006-06-13 12:23:22 +00:00
Maxim Konovalov
332a76f71b o Document the fact truncate(2) has no effect for !VDIR or !VREG files. 
Submitted by:	ceri
 2006-06-01 14:20:43 +00:00
Craig Rodrigues
e6d1e46944 Remove reference to "System call restart" in intro(2). intro(2) does not 
have such a reference.  Add a reference instead to SA_RESTART in
sigaction(2).
 2006-05-20 21:49:03 +00:00
Giorgos Keramidas
79652c510a * Document the fact that non-superusers cannot change file flags for 
objects with SF_IMMUTABLE, SF_APPEND, or SF_NOUNLINK.
* Document that non-superusers cannot set or clear any SF_* flag
  (setting fails with EPERM, clearing is silently ignored).
* Document that superusers cannot change any flag if one of
  SF_IMMUTABLE, SF_APPEND, SF_NOUNLINK is set and securelevel is
  greater than 0.
* Document SF_SNAPSHOT and note that it is maintained by the
  system and is, for this reason, impossible to set to clear by
  any user.

PR:             docs/33877
Submitted by:   harti
Help by:        George Marsellis <gam9478@njit.edu>
MFC after:      1 week
 2006-05-16 20:24:41 +00:00
Tom Rhodes
38467e931c Update for rev 1.205 of vm_mmap.c. 
Submitted by:	fanf
 2006-04-21 07:22:55 +00:00
Maxim Konovalov
6ad8b89261 o Document SO_NOSIGPIPE, touch .Dd. 
PR:		docs/78479
Submitted by:	Mikko Tyolajarvi
MFC after:	2 weeks
 2006-04-15 13:37:35 +00:00
Ruslan Ermilov
1427d59bee List pwritev in the NAME section. 2006-04-14 19:34:07 +00:00
Peter Wemm
c8cd6b70e2 Document that the documented 2GB mmap limit is actually a 
documentation bug.  We switched to page indexes some time around
FreeBSD 2.2.  The actual 'len' limit is the maximum file size or what
will fit in your address space, whichever comes first.  It should be
possible to make 1TB files on 32 bit systems, but of course address space
runs out long before then.
 2006-03-23 23:37:06 +00:00
Daniel Eischen
6fad3aaf15 Add each directory's symbol map file to SYM_MAPS. 2006-03-13 01:15:01 +00:00
Daniel Eischen
cce72e8860 Add symbol maps and initial symbol version definitions to libc. 
Reviewed by:	davidxu
 2006-03-13 00:53:21 +00:00
David Xu
be957ba522 Remove mq.c, the POSIX mqueue is implemented in librt. 
Suggested by: deischen
 2006-03-08 23:42:41 +00:00
Christian Brueffer
f92b647c38 Remove a useless word. 
PR:		94087
Submitted by:	Tadaaki Nagao <nagao@iij.ad.jp>
MFC after:	3 days
 2006-03-05 10:32:15 +00:00
Jesus R. Camou
68dac191af Sync with actual code. 
PR:		docs/87681
Noticed by:	Andreas Kohn <andreas@syndrom23.de>
Reviewed by:	brooks
Approved by:	trhodes (mentor)
MFC after:	3 days
 2006-03-03 13:58:43 +00:00
David Xu
b8211fabf1 Disconnect mqueue from buildworld, as I will implement it in seperated 
library.
 2006-03-01 06:25:46 +00:00
Yaroslav Tykhiy
36ab780431 Tell the truth about a) how to get the first fileid, and 
b) what return values from kldstat(2) can be expected.

Bump .Dd.

MFC after:	3 days
 2006-02-22 15:11:12 +00:00
Brad Davis
209462832d - Massage wording to make it easier to understand and fix some grammar. 
Submitted by:	sbahra at gwu dot edu
Reviewed by:	ru@
Approved by:	ceri@
MFC after:	3 days
 2006-02-16 09:56:31 +00:00
Gleb Smirnoff
61fb9bd80c - In pipe() return the error returned by pipe_create(), rather then 
hardcoded ENFILES, which is incorrect. pipe_create() can fail due
  to ENOMEM.
- Update manual page, describing ENOMEM return code.

Reviewed by:	arch
 2006-01-30 08:25:04 +00:00
Don Lewis
3700c24576 Back out the previous change to rename.2. The previous rename() 
behaviour of returning EINVAL when ".." is passed as either argument
has been restored.

rmdir("..") now returns EINVAL instead of EPERM.  Document the
previously undocumented behaviour of rmdir(".") returning EINVAL
as required by POSIX and SUSv3.  Bump the man page change date.

undelete("..") now returns EINVAL instead of EPERM.  Bump the man
page change date.

MFC after:	3 days
 2006-01-22 19:49:37 +00:00
Don Lewis
af0c232ba6 rename(), rmdir(), and undelete() fail with EPERM if the last component 
of the path is "..".

MFC after:	3 days
 2006-01-21 20:45:45 +00:00
Greg Lehey
3b4c974228 Add references to fhopen, fhstat, getfh, lgetfh and fhstatfs. 
Pointed out by: Antony Curtis <antony@mysql.com>
 2006-01-10 23:24:47 +00:00
Diomidis Spinellis
79a7950c48 Document the recently-added EINVAL behavior. 
MFC after:	1 week
 2006-01-05 08:55:56 +00:00
Poul-Henning Kamp
4c13606d1e Add abort2 manual page. 
Submitted by:	"Wojciech A. Koszek" <dunstan@freebsd.czest.pl>
Edited by:	phk
 2005-12-23 12:27:42 +00:00
David Xu
412295fdbd Sort .Xr by section number. 
Submitted by: ru
 2005-12-13 13:43:35 +00:00
David Xu
e9e7495667 Add cross references to siginfo.3. 2005-12-13 03:05:58 +00:00
David Xu
f2a77c2a7c Fix markeup. 
Submitted by: ru
 2005-12-06 09:52:54 +00:00
David Xu
52cf88e2ef Fix markup. 
Submitted by: ru
 2005-12-05 09:31:49 +00:00
David Xu
8c1e5ef215 Document SIGEV_NONE and SIGEV_SIGNAL. 2005-12-05 04:44:39 +00:00
Ruslan Ermilov
4b66957aa4 Fix prototype. 2005-12-03 09:01:02 +00:00
Ruslan Ermilov
fc37aef9c0 Fix type of argument. 2005-12-03 09:00:43 +00:00
Ruslan Ermilov
61df86c1ed Break hard sentence break. 2005-12-03 08:52:07 +00:00
David Xu
8fcc657635 Remove implementation-defined, it has already been described in NOTES 
section.
 2005-12-03 02:49:04 +00:00
David Xu
ce45c6d3d7 Remove implementation-defined sentences. 2005-12-03 02:31:18 +00:00
David Xu
951ac754b9 Fix lots of markup and content bug. 
Submitted by: ru
 2005-12-03 01:34:41 +00:00
David Xu
0e6a74358e syscall -> system call. 2005-12-02 13:50:56 +00:00
David Xu
4ea655e4bb Fix markup. 2005-12-02 09:04:35 +00:00
Warner Losh
fdc504a929 Tweak markup for POSIX standards. Minor wordsmithing. 
Submitted by: ru@
 2005-12-01 18:17:50 +00:00
Warner Losh
edd94d735c Document O_NOCTTY and O_SYNC. O_NOCTTY is a nop on freebsd, while on 
other systems it prevents a tty from becoming a controlling tty on the
open.  O_SYNC is the POSIX name for O_FSYNC.

The Markup Police may need to tweak my references to standards.
 2005-12-01 17:54:33 +00:00
David Xu
6f59c4c0cd Update conformance and history sections. 2005-11-30 04:15:44 +00:00
David Xu
400786f6bb Symlink mq_send to mq_timedsend. 
Symlink mq_receive to mq_timedreceive.
 2005-11-30 04:14:53 +00:00
David Xu
968cc4bd61 Add manuals for POSIX message queue. 2005-11-30 04:12:37 +00:00
David Xu
8635f5a162 Implement following POSIX message queue interfaces: 
mq_close, mq_getattr, mq_receive, mq_send.
 2005-11-26 13:01:17 +00:00
Ruslan Ermilov
47be132478 Make SYNOPSIS compile. 
Attn peter@: this manpage wasn't synced with your code changes.
 2005-11-24 07:48:19 +00:00
Ruslan Ermilov
93f0f0427b Fix prototypes. 
Attn davidxu@: most likely, the description should also be tweaked
after your undocumented changes that changed these prototypes.
 2005-11-24 07:33:35 +00:00
Simon L. B. Nielsen
71dac3fb8f Do not explicitly state how many bytes an argument list can be in the 
description of E2BIG, since it's now larger on some platforms.

MFC after:	3 days
 2005-11-19 11:30:55 +00:00
Andre Oppermann
f6232df7a4 Document CLOCK_UPTIME which returns the current uptime in SI seconds. 
At the moment it is just an alias for CLOCK_MONOTONIC which reports
the same number.

Sponsored by:	TCP/IP Optimization Fundraise 2005
 2005-11-18 17:13:22 +00:00
Ruslan Ermilov
5507a2aed5 Fix up markup etc. in recently born manpage. 2005-11-18 11:53:23 +00:00
Ruslan Ermilov
110e1704d3 -mdoc sweep. 2005-11-17 13:00:00 +00:00
David Xu
ec0fd3f855 add continued status. 2005-11-12 01:37:03 +00:00
David Xu
b1e515a3f4 Insert missing copyright headers. 2005-11-12 01:19:05 +00:00
David Xu
b71ec5beb4 Only signo should be marked with .Fa. 2005-11-11 14:52:06 +00:00
Xin LI
16902e8a3f Fix plural. 2005-11-11 08:00:44 +00:00
David Xu
d971c2eec2 Fix plural. 2005-11-11 07:50:51 +00:00
David Xu
9463da7fe5 Fix copy-paste issue. 2005-11-11 07:50:09 +00:00
David Xu
bb5eebe6f2 Add POSIX timer manuals. 2005-11-11 07:48:38 +00:00
David Xu
a0e82eba5d Add descriptions about signal queue. 2005-11-11 05:40:39 +00:00
David Xu
c05e95d4ff Er, highlight function wait(). 2005-11-11 05:38:40 +00:00
David Xu
4c1a973e6e Add notes about queued SIGCHLD. 2005-11-11 05:30:48 +00:00
David Xu
e84ece6bef Add manuals for sigqueue, sigtimedwait, sigwaitinfo. 2005-11-11 03:13:25 +00:00
Joseph Koshy
9dc2f0df89 Document the fact that sendfile(2) can EOPNOTSUPP if the underlying 
filesystem for the file being transferred doesn't support UIO_NOCOPY.

Reported by:	Niki Denev <nike_d@cytexbg.com>
 2005-10-31 04:08:28 +00:00
Joseph Koshy
012546dd27 Sort error list. 2005-10-31 04:00:20 +00:00
Robert Watson
f0dc021549 Add mkfifo(2) to the man page SEE ALSO list for umask(2) -- it's 
mentioned in the description.

MFC after:	2 days
 2005-09-10 20:47:02 +00:00
Gleb Smirnoff
83c83f3e46 - Document the fact that the real length of listen queue is 1.5 more 
than the value of backlog argument.
- Document the fact that a subsequent listen(2) calls on the listening
  socket change the backlog argument.
- Note that current listen queue lengths can be queried using netstat(1).

Submitted by:	Igor Sysoev <is rambler-co.ru>
Wording by:	gnn
 2005-08-29 10:23:46 +00:00
Giorgos Keramidas
6fb9b618f5 Fix all the spelling mistakes I could find in the man pages for words 
that have at least 3 characters.

MFC after:	1 week
Thanks to:	Music band ``Chingon''
		for keeping me company while searching for these.
 2005-07-31 03:30:48 +00:00
Diomidis Spinellis
87a236caf5 Document the ECONNRESET errno value. 2005-07-29 07:42:10 +00:00
John-Mark Gurney
5ba593de9e remove the supposed max of 2^31, it hasn't been this small in a very 
long time... i.e. since this file was imported...  (ufs1 supports much
larger files then this)...

Submitted by:	Ivan Voras
MFC after:	1 week
 2005-07-18 22:27:41 +00:00
Maxim Sobolev
9c007cf29e Document the fact that if MAP_FIXED request has been successful it 
replaces any previous mapping to the same address.

Obtained from:	IEEE Std 1003.1, 2004 Edition
 2005-07-15 11:37:25 +00:00
John Baldwin
bcd9e0dd20 - Add two new system calls: preadv() and pwritev() which are like readv() 
and writev() except that they take an additional offset argument and do
  not change the current file position.  In SAT speak:
  preadv:readv::pread:read and pwritev:writev::pwrite:write.
- Try to reduce code duplication some by merging most of the old
  kern_foov() and dofilefoo() functions into new dofilefoo() functions
  that are called by kern_foov() and kern_pfoov().  The non-v functions
  now all generate a simple uio on the stack from the passed in arguments
  and then call kern_foov().  For example, read() now just builds a uio and
  calls kern_readv() and pwrite() just builds a uio and calls kern_pwritev().

PR:		kern/80362
Submitted by:	Marc Olzheim marcolz at stack dot nl (1)
Approved by:	re (scottl)
MFC after:	1 week
 2005-07-07 18:17:55 +00:00
Hiten Pandya
a1601503f5 Use 'manual page' instead of 'man page' for consistency. 
Approved by:	re (hrs)
 2005-06-30 13:18:15 +00:00
Ruslan Ermilov
f789cb8293 Assorted markup fixes. 
Approved by:	re
 2005-06-15 19:04:04 +00:00
Craig Rodrigues
e5d54f7733 Fix the wording in this man page so that it 
reflects the actual behavior of the API
for listing extended attributes.

PR:		docs/79261
Submitted by:	rodrigc
Reviewed by:	rwatson, kan
Approved by:	das (mentor)
 2005-06-10 16:54:17 +00:00
Alan Cox
2ca32bcc02 Update .Dd value. 2005-06-04 19:44:09 +00:00
Alan Cox
bbe7bbdfee Eliminate the original method of requesting notification of aio_read(2) and 
aio_write(2) completion through kevent(2).  This method does not work on
64-bit architectures.  It was deprecated in FreeBSD 4.4.  See revisions
1.87 and 1.70.2.7.

Change aio_physwakeup() to call psignal(9) directly rather than indirectly
through a timeout(9).  Discussed with: bde

Correct a bug introduced in revision 1.65 that could result in premature
delivery of a signal if an lio_listio(2) consisted of a mixture of
direct/raw and queued I/O operations.  Observed by: tegge

Eliminate a field from struct kaioinfo that is now unused.

Reviewed by: tegge
 2005-06-04 19:16:33 +00:00
Giorgos Keramidas
e3446e1f8e Document the fact that accept(2) may return EINVAL when addrlen is 
negative (in addition to returning EINVAL when called on a descriptor
that is not a socket).

Submitted by:	Arne H Juul <arnej@europe.yahoo-inc.com>
PR:		docs/80587
 2005-05-04 11:09:26 +00:00
Alfred Perlstein
d025278aa1 Make MSG_NOSIGNAL available to native programs. 
Bump FreeBSD_version to note this change.

Reviewed by: sobomax
 2005-03-09 00:17:33 +00:00
Tom Rhodes
61001d7506 Fix a few markup nits in previous commit. 
Noticed by:	ru, who else? :)
 2005-02-25 00:40:46 +00:00
Tom Rhodes
0fa17d320d Do not mislead users into checking for a mount_ufs or mount_ufs2 manual 
page.  They do not exist.

PR:		53303
Submitted by:	Marc Silver <marcs@draenor.org> (original version)
 2005-02-24 00:32:58 +00:00
Christian S.J. Peron
e80750df02 -document the fact that extattr_get_* can fail if the requested 
attribute does not exist on the file.
-bump document date

Reviewed by:	rwatson,trhodes
MFC after:	1 week
 2005-02-24 00:04:45 +00:00
Tom Rhodes
87dbe6bb4b Xref chflags(2). 
Note that unlink.2 can return EPERM if the immutable or append-only flags are set.

PR:		77043
 2005-02-23 23:55:58 +00:00
Ruslan Ermilov
423ac68026 Expand contractions. 2005-02-15 09:27:00 +00:00
Ruslan Ermilov
36a142c455 Expand contractions. 2005-02-13 23:45:54 +00:00
Ruslan Ermilov
0227791b40 Expand *n't contractions. 2005-02-13 22:25:33 +00:00
Colin Percival
75fa96cc9b read(), pread(), write(), and pwrite() return EINVAL if they are asked 
for more than INT_MAX bytes.
 2005-02-10 20:09:01 +00:00
Ruslan Ermilov
6b806d21d1 Fixed the misplaced $FreeBSD$. 2005-02-09 18:07:17 +00:00
Giorgos Keramidas
7a46d27566 EISCONN may be returned by sendto() if an attempt is made to specify the 
destination address to a datagram socket that is already connected.

Submitted by:	Rudolf Cejka <cejkar@fit.vutbr.cz>
PR:		docs/76399
MFC after:	1 week
 2005-01-24 20:41:44 +00:00
Ruslan Ermilov
ead5223f54 Fixed punctuation in xrefs. 2005-01-21 20:48:00 +00:00
Ruslan Ermilov
24a0682c64 Sort sections. 2005-01-20 09:17:07 +00:00
Ruslan Ermilov
6a5796e734 Eliminate macro calls inside literal displays. 2005-01-15 12:28:01 +00:00
Ruslan Ermilov
2d82ac3110 Scheduled mdoc(7) sweep. 2005-01-11 20:50:51 +00:00
Tom Rhodes
a51d79c1d3 Catch up with stat.h a bit: 
o Sticky bit is actually defined as S_ISTXT not S_ISVTX.
o Sticky bit is wrapped in if __BSD_VISIBLE not _POSIX_SOURCE.
 2004-12-29 20:00:29 +00:00
Giorgos Keramidas
f56be64fb2 ``NULL is a specific instance of a null pointer constant; the generic is 
a "null pointer".''

Making good use of the excellent explanations sent to me by Ruslan
Ermilov, Garrett Wollman and Bruce Evans, correct the descriptions of
null pointers.  They are just "null pointers", not nil, not NULL or
".Dv NULL".

Suggested by:	ru, wollman, bde
Reviewed by:	ru, wollman
Pointy hat:	keramida
 2004-12-23 23:45:25 +00:00
Giorgos Keramidas
9168f08258 Punctuation marks should be separate arguments in groff macros. 
Noticed by:	ru
 2004-12-22 16:20:12 +00:00
Giorgos Keramidas
411d727cf8 Use .Dv NULL when referring to NULL C pointers, instead of "nil". 2004-12-22 16:15:52 +00:00
Giorgos Keramidas
563058ccff Cross reference init(8) too, instead of vaguely referring to the 
"initialization process".
 2004-12-22 15:44:21 +00:00
Ruslan Ermilov
e354922c78 MNT_NODEV is deprecated. 2004-11-29 09:56:12 +00:00
Yaroslav Tykhiy
49ea9a58a7 Document more fields of struct stat. 
Note to mdoc(7) police:
The document date has already been touched today.
 2004-11-15 14:16:31 +00:00
Yaroslav Tykhiy
502f968bb9 Use .Vt "struct stat" consistently. 2004-11-15 13:58:52 +00:00
Yaroslav Tykhiy
93d7fd123e Nitpicking on grammar. 2004-11-15 13:55:33 +00:00
Yaroslav Tykhiy
fed4da2585 Improve mdoc(7) markup of the page: add several missing macros, 
use .Va instead of .Li for struct stat fields.
 2004-11-15 13:45:13 +00:00
Yaroslav Tykhiy
b337489271 Document the S_IS*(mode) macros used to test for file types. 
Bump the document date accordingly.
 2004-11-15 13:37:56 +00:00
Ceri Davies
47c01d89b4 Add necessary whitespace to correct cross references. 
PR:		docs/73193
Submitted by:	Jilles Tjoelker <jilles at stack.nl>
 2004-10-27 11:26:51 +00:00
Yaroslav Tykhiy
a39fd5061b Reword the last change a bit, add mdoc(7) markup. 
Discussed with:	bde
 2004-10-25 13:35:03 +00:00
Yaroslav Tykhiy
017aaf79e1 Since sendfile(2) works on regular files only, 
which have no negative offsets, "negative" and
"invalid" are equivalent WRT the offset argument.

Suggested by:	bde
 2004-10-18 10:02:04 +00:00
Alfred Perlstein
af2e24d782 Document EMSGSIZE return from recvmsg due to insufficient free files 
when transfering rights (file descriptors.)
 2004-10-17 07:13:34 +00:00
Yaroslav Tykhiy
9a0cabd9e4 Explain it is a negative offset that EINVAL may indicate. 
Now readers won't get an impression that pointing to beyond
the current end of file will result in EINVAL.

MFC after:	1 week
 2004-10-16 09:53:35 +00:00
Yaroslav Tykhiy
6def5837f5 Improve mdoc(7) markup. 2004-10-16 09:46:38 +00:00
Yaroslav Tykhiy
fc5cfaae79 Give details on what will happen if the `offset' argument 
to sendfile(2) falls beyond the end of file.

Touch .Dd.

PR:		bin/72649 (in the audit trail)
MFC after:	1 week
 2004-10-16 09:39:25 +00:00
Julian Elischer
599e7243d3 Make less wrong for desciptions of signal handling 
MFC in: 1 week
 2004-10-08 20:40:30 +00:00
Peter Pentchev
2f67164732 Add a BUGS section and copy the wording from mmap(2)'s MAP_NOSYNC, 
documenting the obsoleteness of the msync(2) syscall and its single
remaining purpose.

PR:		70916
Submitted by:	Radim Kolar <hsn@netmag.cz>
MFC after:	3 days
 2004-09-03 06:24:25 +00:00
Peter Pentchev
9f4c0e5c8f Document the MNT_SNAPSHOT mount flag with a cross-reference 
to mksnap_ffs(8).

PR:		70402
Submitted by:	James Raftery <james@now.ie>
 2004-08-13 14:33:03 +00:00
Brian Feldman
ea84c8dc30 Update "documentation date" fields. 2004-08-10 16:38:19 +00:00
Brian Feldman
831bc6f574 Update mlock(2) manpage to cross-reference m{,un}lockall(2), remove 
a case where ENOMEM could be returned by munlock(2), and add possible
system deadlock to the BUGS section.
 2004-08-10 14:52:42 +00:00
Peter Pentchev
9a3daf494b Fix a case of _SC_CLK_TCK being misspelled as _SC_CLOCK_TCK. 
PR:		69428
Submitted by:	Sascha Schneider <suntsu@suntsu.org>
MFC after:	2 weeks
 2004-08-06 14:49:11 +00:00
Christian S.J. Peron
ef6dea1404 Back out previous commit. Even though statfs(2) can take a regular 
file as an argument, it may still fail for the same reasons that
open(2) can.

Pointed out by:	Jilles Tjoelker
Apporived by:	bmilekic (mentor)
 2004-07-20 19:30:57 +00:00
Christian S.J. Peron
5b154abc54 Remove reference to ENOTDIR in the documented errors 
for statfs(2). This is false, if the pathname specified
is a regular file, then the information for the file
system that the file lives on will be returned.

Approved by:	bmilekic (mentor)
 2004-07-20 18:35:33 +00:00
Hartmut Brandt
b711f5ddea Document the MSG_DONTWAIT flag. 2004-07-16 17:15:37 +00:00
Alfred Perlstein
85e8765b7e Clarify getfsstat(2) usage. 
The getfsstat(2) function expects a buffer and a count, and returns a count.

The confusing part is that the count it takes is a byte count, while the
return value is a count of the number of structures it has filled out.

Spell this out.
 2004-07-16 01:18:13 +00:00
Marcel Moolenaar
b41e0f0f56 Document the new PT_LWPINFO request. In fact, the request is so new 
it hasn't even been implemented yet. I just wanted to be the first
to try a new approach to development ;-)
 2004-07-12 04:43:58 +00:00
Garrett Wollman
5b1eaa7bb6 Eliminate some magic numbers and correct description of _PC_NO_TRUNC. 
Slight emendation to _PC_CHOWN_RESTRICTED, which is in a very similar
boat.
 2004-07-08 20:27:38 +00:00
Alfred Perlstein
83f46f9e33 there's no such define as KERN_NAME_MAX, change to _POSIX_NAME_MAX. 2004-07-07 20:47:42 +00:00
Ruslan Ermilov
51f98e585b Fix the NAME section making whatis(1) happy in particular. 2004-07-05 17:12:53 +00:00
Ruslan Ermilov
1c85060a13 Sort SEE ALSO references (in dictionary order, ignoring case). 2004-07-04 20:55:50 +00:00
Ruslan Ermilov
a817e9e674 Fixed markup. 2004-07-03 23:14:34 +00:00
Ruslan Ermilov
30950a21e1 Eliminate double whitespace. 2004-07-03 22:30:10 +00:00
Ruslan Ermilov
1a0a934547 Mechanically kill hard sentence breaks. 2004-07-02 23:52:20 +00:00
Ruslan Ermilov
d37ea99837 Removed trailing whitespace. 2004-07-02 19:07:33 +00:00
Ruslan Ermilov
33992dc0ed Markup, grammar, and spelling fixes. 2004-06-30 20:09:10 +00:00
Roman Kurakin
f01a74582c s/SS_CANTSENDMORE/SBS_CANTSENDMORE/ 2004-06-24 10:53:44 +00:00
Bruce M Simpson
cb450d2233 Be specific about which socket properties are inherited from the original 
socket upon accept(2).

PR:	docs/54995, kern/45733
 2004-06-23 00:20:46 +00:00
Mike Pritchard
3c6dd63b2c Spelling fixes. 2004-06-21 18:57:32 +00:00
Mike Pritchard
12270048ca PR: docs/67884 
Submitted by:	Chirstopger Nehren <apeiron@comcast.net>
 2004-06-21 18:24:48 +00:00
Kelly Yancey
0a0163040b CLOCK_PROF and CLOCK_VIRTUAL are implemented now. 2004-06-17 23:13:38 +00:00
Kelly Yancey
2aab594f92 The maximum value of iovcnt is IOV_MAX, not 16. 2004-06-15 01:24:41 +00:00
David Schultz
d2b8f61223 Use .Dv instead of .Li for all the RLIMIT_* constants. 
Requested by:	ru
 2004-06-14 01:32:40 +00:00
David Schultz
c294e3b58c Document RLIMIT_AS. While here, correct an insertion sort error. 2004-06-13 22:19:29 +00:00
Yaroslav Tykhiy
e7aa25d3fb Use ".In" to mark up C include file names. 2004-06-07 21:52:20 +00:00
Yaroslav Tykhiy
cacc8e6c5d Each sentence should begin on a new line. 2004-06-07 21:48:02 +00:00
Yaroslav Tykhiy
431c0866bb Extend and improve the mdoc(7) markup of this page. 
Reviewed by:	ru
 2004-06-07 21:43:14 +00:00
Yaroslav Tykhiy
35641ec00f Finally document the option to avoid zombie creation 
through ignoring SIGCHLD.
 2004-06-07 11:01:39 +00:00
Alan Cox
db9081ab70 Update the document date. 
Reminded by:	ru@
 2004-05-20 18:47:15 +00:00
Alan Cox
5ae2d19711 Remove a long obsolete paragraph from the BUGS section. 2004-05-19 03:25:17 +00:00
Yaroslav Tykhiy
d0080709e7 Clarify and extend paragraphs on interoperation 
of fcntl(2), flock(2), and lockf(3) advisory locks.
Add such a paragraph to the flock(2) manpage for the
sake of consistency.

Reviewed by:	Cyrille Lefevre and Kirk McKusick on -arch
MFC after:	2 weeks
 2004-05-17 23:09:10 +00:00
Josef El-Rayes
ac006f74fd Fix typo. 
Submitted by:	Michel Lavondes <fox@vader.aacc.cc.md.us>
PR:		docs/66576
 2004-05-12 20:45:51 +00:00
Christian S.J. Peron
1f95348010 Document the fact that in a jailed environment, sendto(2) could fail 
returning EPERM if the source address specified in the IP header did
not match the address bound to the prison.

Approved by:	bmilekic (mentor)
 2004-05-11 16:28:07 +00:00
Colin Percival
3b38d66be6 Add mention of the fact that timeouts are silently limited to 24 hours. 
Observed by:	jmg
 2004-04-20 21:07:43 +00:00
Colin Percival
b6f7c57ecf Document POSIX stupidity: Attempts to mmap zero bytes will succeed (and 
have no effect), while attempts to munmap zero bytes will fail.
 2004-04-18 23:36:45 +00:00
Christian Brueffer
e2738131b1 Bring describtion of a sysctl in line with the source: 
kern.acct_chkfreq is specified in seconds, not minutes.

Cluebat provided by:	kensmith
 2004-04-16 22:53:51 +00:00
Christian Brueffer
0d5d3ffdb7 Remove unnecessary .Pp macro and bump document date 
Submitted by:	ru
 2004-04-16 22:38:54 +00:00
Christian Brueffer
e8490b5cb4 List some sysctl variables that influence accounting 
PR:		65070
Submitted by:	Marc Silver <marcs@draenor.org>
X-MFC after:	re approval
 2004-04-16 20:32:56 +00:00
Doug Rabson
0128d11082 Update .Dd value. 
Reminded by: ru
 2004-04-06 09:06:45 +00:00
Doug Rabson
8aca967c58 Document lgetfh(2). 2004-04-05 10:17:56 +00:00
Diomidis Spinellis
78a5f747c9 Shave-off troff cycles by invoking .Fa only once. 
Submitted by:	ru
MFC after:	1 week
 2004-03-19 16:04:11 +00:00
Tim J. Robbins
36fa8d519c Sort MLINKS. 
Noticed by:	ru
 2004-03-16 11:06:31 +00:00
Tim J. Robbins
be0f84026d Add fairly minimal documentation for the nmount() syscall. 2004-03-16 09:45:38 +00:00
Diomidis Spinellis
5eb48ad91e Document missing EFAULT errno value. 
MFC after:	2 weeks
 2004-03-03 14:51:11 +00:00
David Schultz
10b1416d2f Update the documentation for setpgrp(2) to reflect the access control 
checks that the code actually performs.  Judging from the 4.2BSD
release notes, the docs have only been out of date for 20 years.

PR:	29844
 2004-02-08 12:38:30 +00:00
Mike Silbersack
a4e8244762 Document the SF_NODISKIO flag, and fix a small typo. 2004-02-08 07:38:35 +00:00
Eivind Eklund
93a876df31 Xref kqueue and poll 2004-01-26 15:20:16 +00:00
Eivind Eklund
1633f3b5a2 Xref kqueue 2004-01-26 15:19:54 +00:00
Andrey A. Chernov
81ccc5779c Describe EOVERFLOW case 2004-01-25 06:24:08 +00:00
Poul-Henning Kamp
a9b19289e6 add cross-reference to clock_gettime(2) 2004-01-19 12:41:39 +00:00
Ruslan Ermilov
1f0bfc3ee5 The libc_r/man/sigwait.3 manpage has been repocopied to libc/sys/sigwait.2. 
Reviewed by:	deischen
Repocopy by:	markm
 2004-01-14 21:22:10 +00:00
Ruslan Ermilov
fccedf067d - libc/sys/sem.c was repocopied to libc/gen/sem.c. 
- sem_*(3) manpages were repocopied from libc_r.

Reviewed by:	deischen
Repocopy by:	markm
 2004-01-14 20:54:16 +00:00
Robert Watson
ccfddc1cce Clarify the behavior of ptrace(2) a little bit: the tracing process 
must first attach to the traced process.  If the tracing process
exits without detaching, the traced process will be killed rather
than continued.  For the duration of the tracing session, the traced
process is reparented to the tracing process (with resulting expected
behaviors).  It is permissible to trace more than one other process
at a time.  When using waitpid() to monitor the behavior of the traced
process, signals are intercepted: they may optionally then be
forwarded using ptrace().  Signals are generated normally by and for
the process, but also by the tracing facility (SIGTRAP).

Product of:	Suffering
Sponsored by:	DARPA, AFRL
 2004-01-10 17:41:04 +00:00
Maxim Konovalov
d22427bf0f Describe kern.ipc.nsfbufsused and kern.ipc.nsfbufspeak. 
Reviewed by:	silby
 2003-12-29 12:29:37 +00:00
Alfred Perlstein
7e2a61e17d Add restrict qualifiers. (docs) 
PR: 44394
Submitted by: Craig Rodrigues <rodrige@attbi.com>
 2003-12-24 18:52:41 +00:00