Provided by: manpages-it_2.80-3_all bug

NOME

       symlink - crea un nuovo nome per un file

SINTASSI

       #include <unistd.h>

       int symlink(const char *oldpath, const char *newpath);

   Test   delle   funzioni   e   requisiti   delle  macro  per  glibc  (vedere
   feature_test_macros(7)):

       symlink(): _BSD_SOURCE || _XOPEN_SOURCE >= 500 ||
       _POSIX_C_SOURCE >= 200112L

DESCRIZIONE

       symlink()  crea un collegamento simbolico con nome newpath che contiene
       la stringa oldpath.

       I collegamenti simbolici sono interpretati all’esecuzione  come  se  il
       contenuto  del collegamento fosse stato sostituito nel percorso seguito
       per trovare un file o una directory.

       Un  collegamento  simbolico  può  contenere  ..   come  componente  del
       percorso,  che  (se  usato  all’inizio del collegamento) fa riferimento
       alle directory superiori a quella nella quale risiede il  collegamento.

       Un collegamento simbolico (conosciuto anche come soft link) può puntare
       ad un file esistente o non esistente: in  tal  caso  è  detto  dangling
       link.

       I  permessi  di  un  collegamento simbolico sono irrilevanti. Quando si
       segue il collegamento il  proprietario  viene  ignorato:  viene  invece
       verificato   quando   si  richiede  la  rimozione  o  la  rinomina  del
       collegamento che si trovi in una directory con lo sticky bit  (S_ISVTX)
       impostato.

       Se newpath esiste non sarà sovrascritto.

VALORE RESTITUITO

       In  caso di successo viene restituito zero, altrimenti -1 e errno verrà
       impostato di conseguenza.

ERRORI

       EACCES Non è possibile l’accesso in scrittura alla directory contenente
              newpath  ,  o  una  delle  directory  contenute nel prefisso del
              percorso di newpath non ha  il  permesso  di  ricerca.   (Vedere
              anche path_resolution(7).)

       EEXIST newpath esiste già.

       EFAULT oldpath  o  newpath puntano fuori dallo spazio di indirizzamento
              accessibile.

       EIO    E’ avvenuto un errore di I/O.

       ELOOP  Si  sono  incontrati   troppy   collegamenti   simbolici   nella
              risoluzione di newpath.

       ENAMETOOLONG
              oldpath o newpath è troppo lungo.

       ENOENT Una  directory  contenuta  in newpath non esiste o è un dangling
              link simbolico, o oldpath è una stringa vuota.

       ENOMEM Non c’è sufficente memoria per il kernel.

       ENOSPC Il dispositivo contenente il file non ha  spazio  per  la  nuova
              directory.

       ENOTDIR
              Un elemento usato come directory in newpath non è in effetti una
              directory.

       EPERM  Il file system contenente newpath non supporta la  creazione  di
              collegamenti simbolici.

       EROFS  newpath è contenuto in un file system in sola lettura.

CONFORME A

       SVr4, 4.3BSD, POSIX.1-2001.

NOTE

       Non viene effetuato nessun controllo su oldpath.

       La  cancellazione  del  nome  a  cui  fa  riferimento  un  collegamento
       simbolico cancellerà il file (a meno che  esso  non  abbia  altri  hard
       link).  Se non si desidera questo comportamento usare link(2).

VEDERE ANCHE

       ln(1),  lchown(2),  link(2), lstat(2), open(2), readlink(2), rename(2),
       symlinkat(2), unlink(2) path_resolution(7)

COLOPHON

       Questa pagina fa parte del rilascio  2.80  del  progetto  man-pages  di
       Linux.   Si può trovare una descrizione del progetto, e informazioni su
       come riportare bachi, presso http://www.kernel.org/doc/man-pages/.  Per
       la    traduzione    in    italiano    si   può   fare   riferimento   a
       http://www.pluto.it/ildp/collaborare/