symlink(2) System Calls Manual symlink(2) NAVN symlink, symlinkat - lav et nyt navn for en fil BIBLIOTEK C-standardbibliotek (libc, -lc) SYNOPSIS #include int symlink(const char *target, const char *linkpath); #include /* Definition af AT_*-konstanter */ #include int symlinkat(const char *target, int newdirfd, const char *linkpath); Feature Test Macro Requirements for glibc (se feature_test_macros(7)): symlink(): _XOPEN_SOURCE >= 500 || _POSIX_C_SOURCE >= 200112L || /* glibc <= 2.19: */ _BSD_SOURCE symlinkat(): Siden glibc 2.10: _POSIX_C_SOURCE >= 200809L For glibc 2.10: _ATFILE_SOURCE BESKRIVELSE symlink() opretter en symbolsk henvisning navngivet linkpath, der indeholder strengen target. Symbolske henvisninger fortolkes pa korselstidspunktet som om indholdet af henvisningen var erstattet ind i stien der folges for at finde en fil eller en mappe. Symbolske henvisninger kan indeholde ..-stikomponenter, der (hvis brugt i starten af henvisningen) refererer til overmapperne pa det som henvisningen befinder sig i. En symbolsk henvisning (ogsa kendt som en blod henvisning) kan pege pa en eksisterende fil eller til en ikkeeksisterende fil; det sidste tilfaelde kaldes en dangling-henvisning. Rettighederne for en symbolsk henvisning er irrelevante; ejerskabet ignoreres en henvisning folges (undtaget nar funktionen protected_symlinks er aktiveret, som forklaret i proc(5)), men tjekkes nar fjernelse eller omdobning af henvisningen er anmodet og henvisningen er i en mappe med det klaebende bit-saet (S_ISVTX). Hvis linkpath findes, sa vil den ikke blive overskrevet. symlinkat() Systemkaldet symlinkat() fungerer pa praecis den samme made som symlink(), med undtagelse af forskellene beskrevet her. Hvis stinavnet angivet i linkpath er relativt, sa fortolkes det relativt til mappen refereret til af fildeskriptoren newdirfd (frem for relativt til den nuvaerende arbejdsmappe for den kaldende proces, som gores af symlink() for et relativt stinavn). Hvis linkpath er relativt og newdirfd er den specielle vaerdi AT_FDCWD, sa fortolkes linkpath relativt til den nuvaerende arbejdsmappe for den kaldende proces (som symlink()). Hvis linkpath er absolut, sa ignoreres newdirfd Se openat(2) for en forklaring af behovet for symlinkat(). RETURVAERDI Ved succes returneres nul. Ved fejl returneres -1 og errno angives for at indikere fejlen. FEJL EACCES Skriveadgang til mappen indeholdende linkpath er naegtet, eller en af mapperne i stipraefikset for linkpath tillod ikke sogerettighed. (Se ogsa path_resolution(7).) EBADF (symlinkat()) linkpath er relativ men newdirfd er hverken AT_FDCWD eller en gyldig fildeskriptor. EDQUOT Brugerens ressourcekvota pa filsystemet er brugt op. Ressourcerne kan vaere iknuder eller diskblokke, afhaengig af filsystemimplementeringen. EEXIST linkpath findes allerede. EFAULT target eller linkpath peger udenfor dit tilgaengelige adresserum. EIO Der opstod en I/O-fejl. ELOOP For mange symbolske henvisninger blev modt, da linkpath blev slaet op. ENAMETOOLONG target eller linkpath var for lang. ENOENT En mappekomponent i linkpath findes ikke eller er en symbolsk dangling-henvisning, eller target eller linkpath er en tom streng. ENOENT (symlinkat()) linkpath er et relativt stinavn og newdirfd refererer til en mappe, der er blevet slettet. ENOMEM Utilstraekkelig kernehukommelse var tilgaengelig. ENOSPC Enheden indeholdende filen har ikke plads til det nye mappeelement. ENOTDIR En komponent brugt som en mappe i linkpath er ikke, reelt, en mappe. ENOTDIR (symlinkat()) linkpath er relativ og newdirfd er en fildeskriptor der refererer til en fil, der ikke er en mappe. EPERM Filsystemet indeholdende linkpath understotter ikke oprettelsen af symbolske henvisninger. EROFS linkpath er pa et skrivebeskyttet filsystem. STANDARDER POSIX.1-2024. HISTORIK symlink() SVr4, 4.3BSD, POSIX.1-2001. symlinkat() POSIX.1-2008. Linux 2.6.16, glibc 2.4. Glibc-noter Pa aeldre kerner hvor symlinkat() er utilgaengelig, falder glibc-omslagsfunktionen tilbage til brugen af symlink(). Nar linkpath er et relativt stinavn konstruerer glibc et stinavn baseret pa den symbolske henvisning i /proc/self/fd, der svarer til argumentet newdirfd. NOTER Ingen kontrol af malet udfores. Sletning af navnet refereret til af en symbolsk henvisning vil reelt slette filen (med mindre den ogsa har andre kodede henvisninger). Hvis denne opforelse ikke er onsket, sa brug link(2). SE OGSA ln(1), namei(1), lchown(2), link(2), lstat(2), open(2), readlink(2), rename(2), unlink(2), path_resolution(7), symlink(7) OVERSAETTELSE Oversaettere af denne manual til dansk Joe Dalton Denne oversaettelse er gratis dokumentation; laes GNU General Public License version 3 eller nyere for ophavsretbetingelser. Der er INGEN ANSVAR. Hvis du stoder pa fejl i oversaettelsen af denne vejledning, skal du sende en besked til . Linux man-pages 6.18 8. februar 2026 symlink(2)