VeraCrypt
aboutsummaryrefslogtreecommitdiff
path: root/src/Common/libzip/zip_file_rename.c
blob: cc42dfcc4228c657a7ba13c1654884914010afa8 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
/*
  zip_file_rename.c -- rename file in zip archive
  Copyright (C) 1999-2018 Dieter Baron and Thomas Klausner

  This file is part of libzip, a library to manipulate ZIP archives.
  The authors can be contacted at <libzip@nih.at>

  Redistribution and use in source and binary forms, with or without
  modification, are permitted provided that the following conditions
  are met:
  1. Redistributions of source code must retain the above copyright
     notice, this list of conditions and the following disclaimer.
  2. Redistributions in binary form must reproduce the above copyright
     notice, this list of conditions and the following disclaimer in
     the documentation and/or other materials provided with the
     distribution.
  3. The names of the authors may not be used to endorse or promote
     products derived from this software without specific prior
     written permission.

  THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
  OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
  WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
  DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
  GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
  INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
  IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
  OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
  IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*/


#include <string.h>

#include "zipint.h"


ZIP_EXTERN int
zip_file_rename(zip_t *za, zip_uint64_t idx, const char *name, zip_flags_t flags) {
    const char *old_name;
    int old_is_dir, new_is_dir;

    if (idx >= za->nentry || (name != NULL && strlen(name) > ZIP_UINT16_MAX)) {
	zip_error_set(&za->error, ZIP_ER_INVAL, 0);
	return -1;
    }

    if (ZIP_IS_RDONLY(za)) {
	zip_error_set(&za->error, ZIP_ER_RDONLY, 0);
	return -1;
    }

    if ((old_name = zip_get_name(za, idx, 0)) == NULL)
	return -1;

    new_is_dir = (name != NULL && name[strlen(name) - 1] == '/');
    old_is_dir = (old_name[strlen(old_name) - 1] == '/');

    if (new_is_dir != old_is_dir) {
	zip_error_set(&za->error, ZIP_ER_INVAL, 0);
	return -1;
    }

    return _zip_set_name(za, idx, name, flags);
}
lass="s">"Documentation.html" ><img src="VeraCrypt128x128.png" alt="VeraCrypt" /></a> </div> <div id="menu"> <ul> <li><a href="Home.html">Home</a></li> <li><a href="/code/">Source Code</a></li> <li><a href="Downloads.html">Downloads</a></li> <li><a class="active" href="Documentation.html">Documentation</a></li> <li><a href="Donation.html">Donate</a></li> <li> <a href="https://sourceforge.net/p/veracrypt/discussion/" target="_blank" >Forums</a > </li> </ul> </div> <div> <p> <a href="Documentation.html">Documentation</a> <img src="arrow_right.gif" alt=">>" style="margin-top: 5px" /> <a href="Technical%20Details.html">Technical Details</a> <img src="arrow_right.gif" alt=">>" style="margin-top: 5px" /> <a href="Keyfiles.html">Keyfiles</a> </p> </div> <div class="wikidoc"> <h1>Keyfiles</h1> <div style=" text-align: left; margin-top: 19px; margin-bottom: 19px; padding-top: 0px; padding-bottom: 0px; " > <p> VeraCrypt keyfile is a file whose content is combined with a password. The user can use any kind of file as a VeraCrypt keyfile. The user can also generate a keyfile using the built-in keyfile generator, which utilizes the VeraCrypt RNG to generate a file with random content (for more information, see the section <a href="Random%20Number%20Generator.html"> <em>Random Number Generator</em></a >). </p> <p> The maximum size of a keyfile is not limited; however, only its first 1,048,576 bytes (1 MiB) are processed (all remaining bytes are ignored due to performance issues connected with processing extremely large files). The user can supply one or more keyfiles (the number of keyfiles is not limited). </p> <p> Keyfiles can be stored on PKCS-11-compliant [23] security tokens and smart cards protected by multiple PIN codes (which can be entered either using a hardware PIN pad or via the VeraCrypt GUI). </p> <p> EMV-compliant smart cards' data can be used as keyfile, see chapter <a href="EMV%20Smart%20Cards.html" style="text-align: left; color: #0080c0; text-decoration: none.html" > <em style="text-align: left">EMV Smart Cards</em></a >. </p> <p> Keyfiles are processed and applied to a password using the following method: </p> <ol> <li> Let <em>P</em> be a VeraCrypt volume password supplied by user (may be empty) </li> <li>Let <em>KP</em> be the keyfile pool</li> <li> Let <em>kpl</em> be the size of the keyfile pool <em>KP</em>, in bytes (64, i.e., 512 bits); <p> kpl must be a multiple of the output size of a hash function H </p> </li> <li> Let <em>pl</em> be the length of the password <em>P</em>, in bytes (in the current version: 0 &le; <em>pl</em> &le; 64) </li> <li> if <em>kpl &gt; pl</em>, append (<em>kpl &ndash; pl</em>) zero bytes to the password <em>P</em> (thus <em>pl = kpl</em>) </li> <li> Fill the keyfile pool <em>KP</em> with <em>kpl</em> zero bytes. </li> <li> For each keyfile perform the following steps: <ol type="a"> <li> Set the position of the keyfile pool cursor to the beginning of the pool </li> <li>Initialize the hash function <em>H</em></li> <li> Load all bytes of the keyfile one by one, and for each loaded byte perform the following steps: <ol type="i"> <li> Hash the loaded byte using the hash function <em>H</em> without initializing the hash, to obtain an intermediate hash (state) <em>M.</em> Do not finalize the hash (the state is retained for next round). </li> <li> Divide the state <em>M</em> into individual bytes.<br /> For example, if the hash output size is 4 bytes, (<em>T</em ><sub>0</sub> || <em>T</em><sub>1</sub> || <em>T</em ><sub>2</sub> || <em>T</em><sub>3</sub>) = <em>M</em> </li> <li> Write these bytes (obtained in step 7.c.ii) individually to the keyfile pool with the modulo 2<sup>8</sup> addition operation (not by replacing the old values in the pool) at the position of the pool cursor. After a byte is written, the pool cursor position is advanced by one byte. When the cursor reaches the end of the pool, its position is set to the beginning of the pool. </li> </ol> </li> </ol> </li> <li> Apply the content of the keyfile pool to the password <em>P</em> using the following method: <ol type="a"> <li> Divide the password <em>P</em> into individual bytes <em>B</em ><sub>0</sub>...<em>B</em><sub>pl-1</sub>.<br /> Note that if the password was shorter than the keyfile pool, then the password was padded with zero bytes to the length of the pool in Step 5 (hence, at this point the length of the password is always greater than or equal to the length of the keyfile pool). </li> <li> Divide the keyfile pool <em>KP</em> into individual bytes <em>G</em><sub>0</sub>...<em>G</em><sub>kpl-1</sub> </li> <li>For 0 &le; i &lt; kpl perform: Bi = Bi &oplus; Gi</li> <li> <em>P</em> = <em>B</em><sub>0</sub> || <em>B</em><sub>1</sub> || ... || <em>B</em><sub>pl-2</sub> || <em>B</em><sub>pl-1</sub> </li> </ol> </li> <li> The password <em>P</em> (after the keyfile pool content has been applied to it) is now passed to the header key derivation function PBKDF2 (PKCS #5 v2), which processes it (along with salt and other data) using a cryptographically secure hash algorithm selected by the user (e.g., SHA-512). See the section <a href="Header%20Key%20Derivation.html"> <em>Header Key Derivation, Salt, and Iteration Count</em></a > for more information. </li> </ol> <p> The role of the hash function <em>H</em> is merely to perform diffusion [2]. CRC-32 is used as the hash function <em>H</em>. Note that the output of CRC-32 is subsequently processed using a cryptographically secure hash algorithm: The keyfile pool content (in addition to being hashed using CRC-32) is applied to the password, which is then passed to the header key derivation function PBKDF2 (PKCS #5 v2), which processes it (along with salt and other data) using a cryptographically secure hash algorithm selected by the user (e.g., SHA-512). The resultant values are used to form the header key and the secondary header key (XTS mode). </p> <p>&nbsp;</p> <p> <a href="Personal%20Iterations%20Multiplier%20%28PIM%29.html" style=" text-align: left; color: #0080c0; text-decoration: none; font-weight: bold.html; " >Next Section &gt;&gt;</a > </p> </div> </div> <div class="ClearBoth"></div> </body> </html>