freebsd-dev/lib/libc/sys
Diomidis Spinellis 55e24f6e77 Document an additional error return value. The connect(2) call can also
return EACCES on non-Unix domain sockets as demonstrated by the
following program:

#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>
#include <errno.h>
#include <sys/types.h>
#include <sys/socket.h>
#include <netinet/in.h>
#include <arpa/inet.h>

int
main(int argc, char *argv[])
{
	struct sockaddr_in rem_addr;
	int sock;

	if ((sock = socket(AF_INET, SOCK_STREAM, 0)) < 0) {
		perror("socket");
		exit(1);
	}

	bzero((char *)&rem_addr, sizeof(rem_addr));
	rem_addr.sin_family = AF_INET;
	rem_addr.sin_addr.s_addr = INADDR_NONE;
	rem_addr.sin_port = htons(10000);

	if (connect(sock, (struct sockaddr *)&rem_addr,
sizeof(rem_addr)) < 0) {
		perror("connect");
		exit(1);
	}
}

The call chain returning this value is probably:

kern/uipc_syscalls.c:connect
kern/uipc_socket.c:soconnect
netinet/tcp_usrreq.c:tcp_usr_connect
netinet/tcp_output.c:tcp_output
netinet/ip_output.c:ip_output

Reviewed by:	schweikh (mentor)
MFC after:	2 weeks
2003-07-23 22:00:08 +00:00
..
__error.c Fix the style of the SCM ID's. 2002-03-22 21:53:29 +00:00
_exit.2 mdoc(7) police: Fixed abuses of the .Ar and .Em macros. 2002-12-18 13:33:04 +00:00
accept.2 mdoc(7) police: "The .Fa argument.". 2002-12-19 09:40:28 +00:00
access.2 mdoc(7) police: "The .Fa argument.". 2002-12-19 09:40:28 +00:00
acct.2 mdoc(7) police: "The .Fa argument.". 2002-12-19 09:40:28 +00:00
adjtime.2 mdoc(7) police: Tidy up the syscall language. 2002-12-18 09:22:32 +00:00
aio_cancel.2 Refer to 1003.1 instead of 1003.2 in the Standards section. 2003-01-13 10:37:11 +00:00
aio_error.2 Refer to 1003.1 instead of 1003.2 in the Standards section. 2003-01-13 10:37:11 +00:00
aio_read.2 Including <time.h> before <aio.h> has not been necessary for a while now. 2003-01-14 02:37:06 +00:00
aio_return.2 Refer to 1003.1 instead of 1003.2 in the Standards section. 2003-01-13 10:37:11 +00:00
aio_suspend.2 Refer to 1003.1 instead of 1003.2 in the Standards section. 2003-01-13 10:37:11 +00:00
aio_waitcomplete.2 mdoc(7) police: Tidy up the syscall language. 2002-12-18 09:22:32 +00:00
aio_write.2 Refer to 1003.1 instead of 1003.2 in the Standards section. 2003-01-13 10:37:11 +00:00
bind.2 mdoc(7) police: "The .Fa argument.". 2002-12-19 09:40:28 +00:00
brk.2 mdoc(7) police: Tidy up the syscall language. 2002-12-18 09:22:32 +00:00
chdir.2 mdoc(7) police: "The .Fa argument.". 2002-12-19 09:40:28 +00:00
chflags.2 mdoc(7) police: "The .Fa argument.". 2002-12-19 09:40:28 +00:00
chmod.2 mdoc(7) police: "The .Fa argument.". 2002-12-19 09:40:28 +00:00
chown.2 mdoc(7) police: "The .Fa argument.". 2002-12-19 09:40:28 +00:00
chroot.2 Document a bug in our chroot(2) implementation: if access control 2003-01-31 21:19:22 +00:00
clock_gettime.2 Mention CLOCK_MONOTONIC. 2003-02-23 10:20:23 +00:00
close.2 Document ENOSPC. 2003-06-13 22:41:12 +00:00
connect.2 Document an additional error return value. The connect(2) call can also 2003-07-23 22:00:08 +00:00
dup.2 mdoc(7) police: "The .Fa argument.". 2002-12-19 09:40:28 +00:00
execve.2 mdoc(7) police: "The .Fa argument.". 2002-12-19 09:40:28 +00:00
extattr_get_file.2 Document the new explicit listing API for extended attributes; note 2003-06-04 04:00:26 +00:00
fcntl.2 Prevent uppercase after .Xr by adding ``The ... utility/system call''. 2003-02-05 13:36:13 +00:00
fhopen.2 english(4) police. 2002-12-27 12:15:40 +00:00
flock.2 mdoc(7) police: "The .Fa argument.". 2002-12-19 09:40:28 +00:00
fork.2 mdoc(7) police: "The .Fa argument.". 2002-12-19 09:40:28 +00:00
fsync.2 mdoc(7) police: "The .Fa argument.". 2002-12-19 09:40:28 +00:00
ftruncate.c Fix the style of the SCM ID's. 2002-03-22 21:53:29 +00:00
getdirentries.2 mdoc(7) police: "The .Fa argument.". 2002-12-19 09:40:28 +00:00
getdtablesize.2 mdoc(7) police: Tidy up the syscall language. 2002-12-18 09:22:32 +00:00
getfh.2 mdoc(7) police: "The .Fa argument.". 2002-12-19 09:40:28 +00:00
getfsstat.2 Add or correct section number in .Xr. Use .Vt or .Fn 2003-06-08 10:01:52 +00:00
getgid.2 mdoc(7) police: Tidy up the syscall language. 2002-12-18 09:22:32 +00:00
getgroups.2 mdoc(7) police: "The .Fa argument.". 2002-12-19 09:40:28 +00:00
getitimer.2 mdoc(7) police: "The .Fa argument.". 2002-12-19 09:40:28 +00:00
getlogin.2 mdoc(7) police: "The .Fa argument.". 2002-12-19 09:40:28 +00:00
getpeername.2 mdoc(7) police: "The .Fa argument.". 2002-12-19 09:40:28 +00:00
getpgrp.2 mdoc(7) police: Tidy up the syscall language. 2002-12-18 09:22:32 +00:00
getpid.2 mdoc(7) police: Tidy up the syscall language. 2002-12-18 09:22:32 +00:00
getpriority.2 mdoc(7) police: "The .Fa argument.". 2002-12-19 09:40:28 +00:00
getrlimit.2 mdoc(7) police: "The .Fa argument.". 2002-12-19 09:40:28 +00:00
getrusage.2 mdoc(7) police: "The .Fa argument.". 2002-12-19 09:40:28 +00:00
getsid.2 mdoc(7) police: Tidy up the syscall language. 2002-12-18 09:22:32 +00:00
getsockname.2 Add or correct section number in .Xr. Use .Vt or .Fn 2003-06-08 10:01:52 +00:00
getsockopt.2 mdoc(7) police: "The .Fa argument.". 2002-12-19 09:40:28 +00:00
gettimeofday.2 mdoc(7) police: "The .Fa argument.". 2002-12-19 09:40:28 +00:00
getuid.2 mdoc(7) police: Tidy up the syscall language. 2002-12-18 09:22:32 +00:00
intro.2 Update errors. 2003-02-18 22:54:42 +00:00
ioctl.2 Back out revision 1.22. 2003-07-15 12:23:12 +00:00
issetugid.2 mdoc(7) police: Tidy up the syscall language. 2002-12-18 09:22:32 +00:00
jail.2 Assorted mdoc(7) fixes. 2003-05-22 13:02:28 +00:00
kenv.2 mdoc(7) police: "The .Fa argument.". 2002-12-19 09:40:28 +00:00
kill.2 mdoc(7) police: "The .Fa argument.". 2002-12-19 09:40:28 +00:00
kldfind.2 mdoc(7) police: Tidy up the syscall language. 2002-12-18 09:22:32 +00:00
kldfirstmod.2 mdoc(7) police: Tidy up the syscall language. 2002-12-18 09:22:32 +00:00
kldload.2 Document that kldload(2) can also return EEXIST. 2003-06-03 12:29:34 +00:00
kldnext.2 mdoc(7) police: Tidy up the syscall language. 2002-12-18 09:22:32 +00:00
kldstat.2 mdoc(7) police: Tidy up the syscall language. 2002-12-18 09:22:32 +00:00
kldsym.2 mdoc(7) police: "The .Fa argument.". 2002-12-19 09:40:28 +00:00
kldunload.2 mdoc(7) police: Tidy up the syscall language. 2002-12-18 09:22:32 +00:00
kqueue.2 mdoc(7) police: "The .Fa argument.". 2002-12-19 09:40:28 +00:00
kse.2 Xref policy: exit(2) -> _exit(2). 2003-06-17 09:36:47 +00:00
ktrace.2 mdoc(7) police: "The .Fa argument.". 2002-12-19 09:40:28 +00:00
link.2 mdoc(7) police: "The .Fa argument.". 2002-12-19 09:40:28 +00:00
lio_listio.2 Assorted mdoc(7) fixes. 2003-06-01 19:19:59 +00:00
listen.2 Document that listen() can return EINVAL now. 2003-01-17 19:25:27 +00:00
lseek.2 mdoc(7) police: "The .Fa argument.". 2002-12-19 09:40:28 +00:00
lseek.c Fix the style of the SCM ID's. 2002-03-22 21:53:29 +00:00
madvise.2 Add a facility allowing processes to inform the VM subsystem they are 2003-03-31 21:09:57 +00:00
Makefile.inc Add a manual page for the ntp_gettime syscall. 2003-04-17 18:39:30 +00:00
mincore.2 mdoc(7) police: markup laundry. 2003-02-23 01:47:49 +00:00
minherit.2 mdoc(7) police: Tidy up the syscall language. 2002-12-18 09:22:32 +00:00
mkdir.2 mdoc(7) police: "The .Fa argument.". 2002-12-19 09:40:28 +00:00
mkfifo.2 mdoc(7) police: "The .Fa argument.". 2002-12-19 09:40:28 +00:00
mknod.2 mdoc(7) police: "The .Fa argument.". 2002-12-19 09:40:28 +00:00
mlock.2 mdoc(7) police: "The .Fa argument.". 2002-12-19 09:40:28 +00:00
mmap.2 Spelling: s/then/than/ where appropriate. 2002-12-24 16:52:31 +00:00
mmap.c Fix style (no space after return, twice-too-big continuation) and 2002-12-22 03:20:16 +00:00
modfind.2 mdoc(7) police: Tidy up the syscall language. 2002-12-18 09:22:32 +00:00
modnext.2 mdoc(7) police: Tidy up the syscall language. 2002-12-18 09:22:32 +00:00
modstat.2 mdoc(7) police: Tidy up the syscall language. 2002-12-18 09:22:32 +00:00
mount.2 Add a new mount flag MNT_BYFSID that can be used to unmount a file 2003-07-01 17:40:23 +00:00
mprotect.2 mdoc(7) police: markup laundry. 2003-02-23 01:47:49 +00:00
msync.2 mdoc(7) police: "The .Fa argument.". 2002-12-19 09:40:28 +00:00
munmap.2 mdoc(7) police: "The .Fa argument.". 2002-12-19 09:40:28 +00:00
nanosleep.2 Grammatical fixup: s/be the -1/be -1/ 2002-12-19 21:48:43 +00:00
nfssvc.2 Prevent uppercase after .Xr by adding ``The ... utility/system call''. 2003-02-05 13:36:13 +00:00
ntp_adjtime.2 ntp_adjtime returns the current state of the clock (TIME_*) on success 2003-06-20 21:14:59 +00:00
ntp_gettime.2 Add clarifications about the information that ntp_gettime returns. 2003-06-21 20:27:54 +00:00
open.2 The .Fn function 2003-03-24 16:07:19 +00:00
pathconf.2 Typo fixes. 2003-01-07 05:06:27 +00:00
pipe.2 mdoc(7) police: Tidy up the syscall language. 2002-12-18 09:22:32 +00:00
poll.2 mdoc(7) police: "The .Fa argument.". 2002-12-19 09:40:28 +00:00
pread.c Fix the style of the SCM ID's. 2002-03-22 21:53:29 +00:00
profil.2 mdoc(7) police: "The .Fa argument.". 2002-12-19 09:40:28 +00:00
ptrace.2 mdoc(7) police: "The .Fa argument.". 2002-12-19 09:40:28 +00:00
pwrite.c Fix the style of the SCM ID's. 2002-03-22 21:53:29 +00:00
quotactl.2 mdoc(7) police: "The .Fa argument.". 2002-12-19 09:40:28 +00:00
read.2 Fix struct iovec documentation to match reality. 2003-01-12 15:18:47 +00:00
readlink.2 mdoc(7) police: "The .Fa argument.". 2002-12-19 09:40:28 +00:00
reboot.2 mdoc(7) police: "The .Fa argument.". 2002-12-19 09:40:28 +00:00
recv.2 mdoc(7) police: "The .Fa argument.". 2002-12-19 09:40:28 +00:00
rename.2 Fixed the abuses of .Ql visible on stderr in troff mode. 2002-12-23 16:04:51 +00:00
revoke.2 mdoc(7) police: "The .Fa argument.". 2002-12-19 09:40:28 +00:00
rfork.2 Correct the return value of vfork(2) and rfork(2) in their 2003-04-27 21:01:34 +00:00
rmdir.2 mdoc(7) police: "The .Fa argument.". 2002-12-19 09:40:28 +00:00
rtprio.2 mdoc(7) police: "The .Fa argument.". 2002-12-19 09:40:28 +00:00
sched_get_priority_max.2 mdoc(7) police: "The .Fa argument.". 2002-12-19 09:40:28 +00:00
sched_setparam.2 .Xr p1003_1b moved to .St -p1003.1b-93 2003-06-08 10:11:13 +00:00
sched_setscheduler.2 .Xr p1003_1b moved to .St -p1003.1b-93 2003-06-08 10:11:13 +00:00
sched_yield.2 mdoc(7) police: Tidy up the syscall language. 2002-12-18 09:22:32 +00:00
select.2 mdoc(7) police: "The .Fa argument.". 2002-12-19 09:40:28 +00:00
sem.c Eliminate 61 warnings emitted at WARNS=2 (leaving 53 to go). 2003-02-16 17:29:11 +00:00
semctl.2 mdoc(7) police: "The .Fa argument.". 2002-12-19 09:40:28 +00:00
semget.2 mdoc(7) police: "The .Fa argument.". 2002-12-19 09:40:28 +00:00
semop.2 Bring semop() closer the the opengroup standards. 2003-01-25 21:27:37 +00:00
send.2 mdoc(7) police: "The .Fa argument.". 2002-12-19 09:40:28 +00:00
sendfile.2 Assorted mdoc(7) fixes. 2003-05-22 13:02:28 +00:00
setgroups.2 mdoc(7) police: "The .Fa argument.". 2002-12-19 09:40:28 +00:00
setpgid.2 mdoc(7) police: Tidy up the syscall language. 2002-12-18 09:22:32 +00:00
setregid.2 mdoc(7) police: "The .Fa argument.". 2002-12-19 09:40:28 +00:00
setresuid.2 mdoc(7) police: Tidy up the syscall language. 2002-12-18 09:22:32 +00:00
setreuid.2 mdoc(7) police: Tidy up the syscall language. 2002-12-18 09:22:32 +00:00
setsid.2 mdoc(7) police: Tidy up the syscall language. 2002-12-18 09:22:32 +00:00
setuid.2 Typo fixes. 2003-01-07 05:06:27 +00:00
shm_open.2 mdoc(7) police: Use the new .In macro for #include statements. 2001-10-01 16:09:29 +00:00
shmat.2 Bring shm functions closer the the opengroup standards. 2003-01-25 21:33:05 +00:00
shmctl.2 mdoc(7) police: Fixed a few .Fa abuses. 2002-12-19 09:33:34 +00:00
shmget.2 Bring shm functions closer the the opengroup standards. 2003-01-25 21:33:05 +00:00
shutdown.2 mdoc(7) police: Tidy up the syscall language. 2002-12-18 09:22:32 +00:00
sigaction.2 The .Fn function 2003-03-24 16:07:19 +00:00
sigaltstack.2 mdoc(7) police: Tidy up the syscall language. 2002-12-18 09:22:32 +00:00
sigpending.2 Unify cross-references between sigpending(2), sigprocmask(2), 2003-06-24 15:41:19 +00:00
sigprocmask.2 Unify cross-references between sigpending(2), sigprocmask(2), 2003-06-24 15:41:19 +00:00
sigreturn.2 mdoc(7) police: "The .Fa argument.". 2002-12-19 09:40:28 +00:00
sigstack.2 mdoc(7) police: Tidy up the syscall language. 2002-12-18 09:22:32 +00:00
sigsuspend.2 Unify cross-references between sigpending(2), sigprocmask(2), 2003-06-24 15:41:19 +00:00
sigwait.2 The .Fn function. Use .Xr where appropriate. 2003-03-24 16:05:24 +00:00
socket.2 The .Fn function 2003-03-24 16:07:19 +00:00
socketpair.2 mdoc(7) police: Tidy up the syscall language. 2002-12-18 09:22:32 +00:00
stat.2 Assorted mdoc(7) fixes. 2003-05-22 13:02:28 +00:00
statfs.2 mdoc(7) police: "The .Fa argument.". 2002-12-19 09:40:28 +00:00
swapon.2 mdoc(7) police: "The .Fa argument.". 2002-12-19 09:40:28 +00:00
symlink.2 mdoc(7) police: "The .Fa argument.". 2002-12-19 09:40:28 +00:00
sync.2 mdoc(7) police: Tidy up the syscall language. 2002-12-18 09:22:32 +00:00
sysarch.2 mdoc(7) police: "The .Fa argument.". 2002-12-19 09:40:28 +00:00
syscall.2 mdoc(7) police: "The .Fa argument.". 2002-12-19 09:40:28 +00:00
truncate.2 mdoc(7) police: "The .Fa argument.". 2002-12-19 09:40:28 +00:00
truncate.c Fix the style of the SCM ID's. 2002-03-22 21:53:29 +00:00
umask.2 mdoc(7) police: Tidy up the syscall language. 2002-12-18 09:22:32 +00:00
undelete.2 mdoc(7) police: "The .Fa argument.". 2002-12-19 09:40:28 +00:00
unlink.2 mdoc(7) police: "The .Fa argument.". 2002-12-19 09:40:28 +00:00
utimes.2 mdoc(7) police: "The .Fa argument.". 2002-12-19 09:40:28 +00:00
uuidgen.2 Correct a misspelled name of time_hi_and_version. 2003-06-27 13:41:29 +00:00
vfork.2 Correct the return value of vfork(2) and rfork(2) in their 2003-04-27 21:01:34 +00:00
wait.2 mdoc(7) police: "The .Fa argument.". 2002-12-19 09:40:28 +00:00
write.2 Fix struct iovec documentation to match reality. 2003-01-12 15:18:47 +00:00