ioctl_ficlonerange(2)         System Calls Manual        ioctl_ficlonerange(2)

NUME
       ioctl_ficlonerange, ioctl_ficlone - partajarea unor date dintr-un
       fi<?>ier cu un alt fi<?>ier

BIBLIOTECA
       Biblioteca C standard (libc, -lc)

REZUMAT
       #include <linux/fs.h>        /* Definirea constantelor FICLONE* */
       #include <sys/ioctl.h>

       int ioctl(int dest_fd, FICLONERANGE, struct file_clone_range *arg);
       int ioctl(int dest_fd, FICLONE, int src_fd);

DESCRIERE
       In cazul in care un sistem de fi<?>iere accepta fi<?>iere care
       partajeaza stocarea fizica intre mai multe fi<?>iere (,,reflink"),
       aceasta opera<?>iune ioctl(2) poate fi utilizata pentru a face ca o
       parte din datele din fi<?>ierul src_fd sa apara in fi<?>ierul dest_fd
       prin partajarea stocarii subiacente, ceea ce este mai rapid decat
       realizarea unei copii fizice separate a datelor.  Ambele fi<?>iere
       trebuie sa se afle in acela<?>i sistem de fi<?>iere.  In cazul in care
       ar trebui sa aiba loc o scriere a unui fi<?>ier intr-o regiune
       partajata, sistemul de fi<?>iere trebuie sa se asigure ca modificarile
       raman private pentru fi<?>ierul care este scris.  Acest comportament
       este denumit in mod obi<?>nuit ,,copiere la scriere".

       Acest ioctl ,,reflink" cloneaza pana la src_length octe<?>i din
       descriptorul de fi<?>ier src_fd la pozi<?>ia src_offset in fi<?>ierul
       dest_fdd la pozi<?>ia dest_offset, cu condi<?>ia ca ambele sa fie
       fi<?>iere.  In cazul in care src_length este zero, ioctl ,,reflink"
       cloneaza la sfar<?>itul fi<?>ierului sursa.  Aceasta informa<?>ie este
       transmisa intr-o structura de urmatoarea forma:

           struct file_clone_range {
               __s64 src_fd;
               __u64 src_offset;
               __u64 src_length;
               __u64 dest_offset;
           };

       Clonele sunt atomice in ceea ce prive<?>te scrierile simultane, astfel
       incat nu este necesar sa se ia nicio blocare pentru a ob<?>ine o copie
       clonata consistenta.

       Ioctl-ul FICLONE cloneaza fi<?>iere intregi.

VALOAREA RETURNATA
       In caz de eroare, se returneaza -1, iar errno este configurata pentru a
       indica eroarea.

ERORI-IE<?>IRE
       Codurile de eroare pot fi unul dintre urmatoarele, dar nu se limiteaza
       la acestea:

       EBADF  src_fd nu este deschis pentru citire; dest_fd nu este deschis
              pentru scriere sau este deschis doar pentru scriere de tip
              ,,append-only" (doar-adaugare); sau sistemul de fi<?>iere pe
              care se afla src_fd nu accepta ,,reflink".

       EINVAL Sistemul de fi<?>iere nu suporta clonarea ,,reflink" intre
              intervalele de fi<?>iere date.  Aceasta eroare poate aparea, de
              asemenea, daca oricare dintre descriptorii de fi<?>iere
              reprezinta un dispozitiv, FIFO sau soclu.  In general, sistemele
              de fi<?>iere de pe discuri cer ca argumentele ,,offset"
              (pozi<?>ie) <?>i ,,length" (lungime) sa fie aliniate la
              dimensiunea blocului fundamental.  XFS <?>i Btrfs nu accepta
              suprapunerea intervalelor de clonare ,,reflink" in acela<?>i
              fi<?>ier.

       EISDIR Unul dintre fi<?>iere este un director, iar sistemul de
              fi<?>iere nu accepta regiuni partajate in directoare.

       EOPNOTSUPP
              Acest lucru poate aparea in cazul in care sistemul de fi<?>iere
              nu accepta clonarea ,,reflink" cu oricare dintre descriptorii de
              fi<?>iere sau in cazul in care oricare dintre descriptorii de
              fi<?>iere se refera la noduri-i speciale.

       EPERM  dest_fd este imuabil.

       ETXTBSY
              Unul dintre fi<?>iere este un fi<?>ier swap.  Fi<?>ierele swap
              nu pot partaja spa<?>iul de stocare.

       EXDEV  dest_fd <?>i src_fd nu se afla pe acela<?>i sistem de fi<?>iere
              montat.

STANDARDE
       Linux.

ISTORIC
       Linux 4.5.

       Acestea erau cunoscute anterior sub numele de BTRFS_IOC_CLONE <?>i
       BTRFS_IOC_CLONE_RANGE <?>i erau private pentru Btrfs.

NOTE
       Deoarece o opera<?>ie de copiere la scriere ,,copy-on-write" necesita
       alocarea de noi spa<?>ii de stocare, opera<?>ia fallocate(2) poate sa
       nu partajeze blocurile partajate pentru a garanta ca scrierile
       ulterioare nu vor e<?>ua din cauza lipsei de spa<?>iu pe disc.

CONSULTA<?>I <?>I
       ioctl(2)

TRADUCERE
       Traducerea in limba romana a acestui manual a fost facuta de Remus-
       Gabriel Chelu <remusgabriel.chelu@disroot.org>

       Aceasta traducere este documenta<?>ie gratuita; citi<?>i Licen<?>a
       publica generala GNU Versiunea 3
       <https://www.gnu.org/licenses/gpl-3.0.html> sau o versiune ulterioara
       cu privire la condi<?>ii privind drepturile de autor.  NU se asuma
       NICIO RESPONSABILITATE.

       Daca gasi<?>i erori in traducerea acestui manual, va rugam sa
       trimite<?>i un e-mail la <translation-team-ro@lists.sourceforge.net>.

Pagini de manual de Linux 6.06 31 octombrie 2023         ioctl_ficlonerange(2)