ioctl_fideduperange(2)        System Calls Manual       ioctl_fideduperange(2)

NUME
       ioctl_fideduperange - partajeaza o parte din datele unui fi<?>ier cu un
       alt fi<?>ier

BIBLIOTECA
       Biblioteca C standard (libc, -lc)

REZUMAT
       #include <linux/fs.h>      /* Defini<?>ia lui FIDEDUPERANGE<?>i a
       constantelor                              FILE_DEDUPE_* */
       #include <sys/ioctl.h>

       int ioctl(int src_fd, FIDEDUPERANGE, struct file_dedupe_range *arg);

DESCRIERE
       In cazul in care un sistem de fi<?>iere accepta fi<?>iere care
       partajeaza stocarea fizica intre mai multe fi<?>iere, aceasta
       opera<?>ie 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 daca datele din fi<?>iere sunt identice
       (,,deduplicare"). Ambele fi<?>iere trebuie sa se afle in acela<?>i
       sistem de fi<?>iere. Acest lucru reduce consumul de stocare permi<?>and
       sistemului de fi<?>iere sa stocheze o singura copie partajata a
       datelor. In cazul in care o regiune partajata ar trebui sa fie scrisa
       intr-un fi<?>ier, 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 efectueaza opera<?>ia de ,,comparare <?>i partajare daca
       este identica" pe pana la src_length octe<?>i din descriptorul de
       fi<?>ier src_fd la pozi<?>ia src_offset. Aceasta informa<?>ie este
       transmisa intr-o structura de urmatoarea forma:

           struct file_dedupe_range {
           ;
               __u64 src_length;
               __u16 dest_count;
               __u16 reserved1;
               __u32 reserved2;
               struct file_dedupe_range_info info[0];
           };

       Deduplicarea este atomica in ceea ce prive<?>te scrierile simultane,
       astfel incat nu este nevoie sa se faca niciun blocaj pentru a ob<?>ine
       o copie deduplicata consistenta.

       Campurile rezerved1 <?>i rezerved2 trebuie sa fie zero.

       Destina<?>iile pentru opera<?>ia de deduplicare sunt transmise in
       matricea de la sfar<?>itul structurii.  Numarul de destina<?>ii este
       indicat in dest_count, iar informa<?>iile privind destina<?>ia sunt
       transmise sub urmatoarea forma:

           struct file_dedupe_range_info {
               __s64 dest_fd;
               __u64 dest_offset;
               __u64 bytes_deduped;
               __s32 status;
               __u32 reserved;
           };

       Fiecare opera<?>ie de deduplicare vizeaza src_length octe<?>i in
       descriptorul de fi<?>ier dest_fd la pozi<?>ia dest_offset. Campul
       reserved trebuie sa fie zero. In timpul apelului, src_fd trebuie sa fie
       deschis pentru citire, iar dest_fd trebuie sa fie deschis pentru
       scriere. Dimensiunea combinata a structurii matricei file_dedupe_range
       <?>i a structurii matricei file_dedupe_range_info nu trebuie sa
       depa<?>easca dimensiunea paginii de sistem. Dimensiunea maxima a
       src_length depinde de sistemul de fi<?>iere <?>i este de obicei de
       16 Mio. Aceasta limita va fi impusa in mod silen<?>ios de catre
       sistemul de fi<?>iere. Prin conven<?>ie, spa<?>iul de stocare utilizat
       de src_fd este plasat in dest_fd, iar con<?>inutul anterior din dest_fd
       este eliberat.

       La finalizarea cu succes a acestui ioctl, numarul de octe<?>i
       deduplica<?>i cu succes este returnat in bytes_deduped <?>i un cod de
       stare pentru opera<?>ia de deduplicare este returnat in status. In
       cazul in care nici macar un singur octet din interval nu corespunde,
       cererea de deduplicare va fi ignorata, iar status va fi stabilit la
       FILE_DEDUPE_RANGE_DIFFERS. Codul status este stabilit la
       FILE_DEDUPE_RANGE_SAME in caz de succes, un cod de eroare negativ in
       caz de eroare sau FILE_DEDUPE_RANGE_DIFFERS daca datele nu se
       potrivesc.

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

ERORI-IE<?>IRE
       Posibilele erori includ (dar nu se limiteaza la) urmatoarele:

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

       EINVAL Sistemul de fi<?>iere nu accepta deduplicarea intervalelor 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
              pe disc necesita ca argumentele ,,offset" <?>i ,,length" sa fie
              aliniate la dimensiunea blocului fundamental. Nici Btrfs <?>i
              nici XFS nu accepta suprapunerea intervalelor de deduplicare in
              acela<?>i fi<?>ier.

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

       ENOMEM Nucleul nu a reu<?>it sa aloce suficienta memorie pentru a
              efectua opera<?>ia sau dest_count este atat de mare incat
              descrierea argumentului de intrare se intinde pe mai mult de o
              singura pagina de memorie.

       EOPNOTSUPP
              Acest lucru poate aparea in cazul in care sistemul de fi<?>iere
              nu accepta deduplicarea niciunui descriptor de fi<?>ier sau in
              cazul in care unul 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.

VERSIUNI
       Unele sisteme de fi<?>iere pot limita cantitatea de date care pot fi
       deduplicate intr-un singur apel.

STANDARDE
       Linux.

ISTORIC
       Linux 4.5.

       A fost cunoscuta anterior sub numele de BTRFS_IOC_FILE_EXTENT_SAME <?>i
       a fost privata 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_fideduperange(2)