Linux Manpages Online - man.cx manual pages

NAAM

symlink, symlinkat - maak een nieuwe naam voor een bestand

SAMENVATTING

#include <unistd.h>

int symlink(const char *oudpad, const char *nieuwpad);

#include <fcntl.h> /* Definitie van AT_* constanten */
#include <unistd.h>

int symlinkat(const char *oudpad, int nieuwmapbi, const char *nieuwpad);

Feature Test Macro Requirements for glibc (see feature_test_macros(7)):

symlink():

_XOPEN_SOURCE >= 500 || _POSIX_C_SOURCE >= 200112L
|| /* Glibc versies <= 2.19: */ _BSD_SOURCE

symlinkat():

Sinds glibc 2.10:

_POSIX_C_SOURCE >= 200809L

Vóór glibc 2.10:

_ATFILE_SOURCE

BESCHRIJVING

symlink() maakt een symbolische koppeling genaamd nieuwpad die het karakter-string oudpad bevat.

Symbolische koppelingen worden geïnterpreteerd tijdens draaien, alsof de inhoud van de koppeling vervangen werd naar de pad die gevolgd werd om een bestand of map te vinden.

Symbolische koppelingen kunnen .. pad onderdelen bevatten, die (als gebruikt bij het begin van de koppeling) wijzen naar de ouder mappen van dat waarin de koppeling verblijft.

Een symbolische koppeling (ook bekend als zachte koppeling) mag wijzen naar een bestaand bestand of naar een niet bestaande; het laatste geval is bekend als een loshangende koppeling.

De toestemmingen van een symbolische koppeling zijn onbelangrijk; het eigendom wordt genegeerd bij het volgen van de koppeling, maar wordt getest als verwijderen of hernoemen van de koppeling wordt gevraagd en als de koppeling in een map is met het sticky bit (S_ISVTX) gezet.

Als nieuwpad bestaat zal het niet overschreven worden.

symlinkat()
The symlinkat() system call operates in exactly the same way as symlink(), except for the differences described here.

If the pathname given in linkpath is relative, then it is interpreted relative to the directory referred to by the file descriptor newdirfd (rather than relative to the current working directory of the calling process, as is done by symlink() for a relative pathname).

If linkpath is relative and newdirfd is the special value AT_FDCWD, then linkpath is interpreted relative to the current working directory of the calling process (like symlink()).

If linkpath is absolute, then newdirfd is ignored.

EIND WAARDE

Bij succes wordt nul teruggegeven. Bij falen wordt -1 teruggegeven en wordt errno naar behoren gezet.

FOUTEN

	EACCES		Schrijf toegang in de map die nieuwpad bevat wordt niet toegestaan voor het geldende uid van het proces, of een van de mappen in nieuwpad liet zoek (voer-uit) toestemming niet toe. (Zie ook path_resolution(7).)
	EDQUOT		The user’s quota of resources on the filesystem has been exhausted. The resources could be inodes or disk blocks, depending on the filesystem implementation.
	EEXIST		nieuwpad bestaat al.
	EFAULT		oudpad of nieuwpad wijzen buiten uw toegankelijk geheugen.
	EIO		Een In/Uit fout trad op.
	ELOOP		Teveel symbolische koppelingen werden tegengekomen bij het vaststellen van nieuwpad.

ENAMETOOLONG

oudpad of nieuwpad was te lang.

	ENOENT		Een map deel in nieuwpad bestaat niet of is een loshangende symbolische koppeling, of oudpad of linkpad is het lege string.
	ENOMEM		Onvoldoende kernelgeheugen voorhanden.
	ENOSPC		Het apparaat waar het bestand op zit heeft geen ruimte voor een nieuwe map.

ENOTDIR

Een deel gebruikt als een map in nieuwpad is in feite geen map.

	EPERM		Het bestandsysteem dat nieuwpad bevat, ondersteund het maken van symbolische koppelingen niet.
	EROFS		nieuwpad is op een alleen-lezen bestandsysteem.

De volgende extra fouten kunnen optreden voor symlinkat():

	EBADF		newdirfd is not a valid file descriptor.
	ENOENT		linkpath is a relative pathname and newdirfd refers to a directory that has been deleted.

ENOTDIR

linkpath is relative and newdirfd is a file descriptor referring to a file other than a directory.

VERSIES

symlinkat() was added to Linux in kernel 2.6.16; library support was added to glibc in version 2.4.

VOLDOET AAN

symlink(): SVr4, 4.3BSD, POSIX.1-2001, POSIX.1-2008.

symlinkat(): POSIX.1-2008.

OPMERKINGEN

oudpad wordt niet gecontroleerd.

Schrappen van de naam waar de symbolische koppeling naar wijst zal daadwerkelijk het bestand schrappen (tenzij het ook nog andere harde koppelingen heeft.) Als dit gedrag ongewenst is, gebruik link(2).

Glibc-opmerkingen
On older kernels where symlinkat() is unavailable, the glibc wrapper function falls back to the use of symlink(). When linkpath is a relative pathname, glibc constructs a pathname based on the symbolic link in /proc/self/fd that corresponds to the newdirfd argument.

Indien U fouten in de vertaling van deze handleiding zou vinden, stuur een e-mail naar <debian-l10n-dutch [AT] lists.org>.

Manpages