Coverage Report

Created: 2026-10-28 06:43

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/src/nettle/memxor.c
Line
Count
Source
1
/* memxor.c
2
3
   Copyright (C) 2010, 2014 Niels Möller
4
5
   This file is part of GNU Nettle.
6
7
   GNU Nettle is free software: you can redistribute it and/or
8
   modify it under the terms of either:
9
10
     * the GNU Lesser General Public License as published by the Free
11
       Software Foundation; either version 3 of the License, or (at your
12
       option) any later version.
13
14
   or
15
16
     * the GNU General Public License as published by the Free
17
       Software Foundation; either version 2 of the License, or (at your
18
       option) any later version.
19
20
   or both in parallel, as here.
21
22
   GNU Nettle is distributed in the hope that it will be useful,
23
   but WITHOUT ANY WARRANTY; without even the implied warranty of
24
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
25
   General Public License for more details.
26
27
   You should have received copies of the GNU General Public License and
28
   the GNU Lesser General Public License along with this program.  If
29
   not, see http://www.gnu.org/licenses/.
30
*/
31
32
/* Implementation inspired by memcmp in glibc, contributed to the FSF
33
   by Torbjorn Granlund.
34
 */
35
36
#if HAVE_CONFIG_H
37
# include "config.h"
38
#endif
39
40
#include <assert.h>
41
#include <limits.h>
42
43
#include "memxor.h"
44
#include "memxor-internal.h"
45
46
3.89k
#define WORD_T_THRESH 16
47
48
/* XOR word-aligned areas. n is the number of words, not bytes. */
49
static void
50
memxor_common_alignment (word_t *dst, const word_t *src, size_t n)
51
2.96k
{
52
  /* FIXME: Require n > 0? */
53
  /* FIXME: Unroll four times, like memcmp? Probably not worth the
54
     effort. */
55
56
2.96k
  if (n & 1)
57
0
    {
58
0
      n--;
59
0
      dst[n] ^= src[n];
60
0
    }
61
5.92k
  while (n >= 2)
62
2.96k
    {
63
2.96k
      n -= 2;
64
2.96k
      dst[n+1] ^= src[n+1];
65
2.96k
      dst[n] ^= src[n];
66
2.96k
    }
67
2.96k
}
68
69
/* XOR *un-aligned* src-area onto aligned dst area. n is number of
70
   words, not bytes. Assumes we can read complete words at the start
71
   and end of the src operand. */
72
static void
73
memxor_different_alignment (word_t *dst, const unsigned char *src, size_t n)
74
933
{
75
933
  int shl, shr;
76
933
  const word_t *src_word;
77
933
  unsigned offset = ALIGN_OFFSET (src);
78
933
  word_t s0, s1;
79
80
933
  assert (n > 0);
81
933
  shl = CHAR_BIT * offset;
82
933
  shr = CHAR_BIT * (sizeof(word_t) - offset);
83
84
933
  src_word = (const word_t *) ((uintptr_t) src & -sizeof(word_t));
85
86
  /* Read top offset bytes, in native byte order. */
87
933
  READ_PARTIAL (s0, (unsigned char *) &src_word[n], offset);
88
#ifdef WORDS_BIGENDIAN
89
  s0 <<= shr; /* FIXME: Eliminate this shift? */
90
#endif
91
92
  /* Do n-1 regular iterations */
93
933
  if (n & 1)
94
933
    s1 = s0;
95
0
  else
96
0
    {
97
0
      n--;
98
0
      s1 = src_word[n];
99
0
      dst[n] ^= MERGE (s1, shl, s0, shr);
100
0
    }
101
102
933
  assert (n & 1);
103
8.39k
  while (n > 2)
104
7.46k
    {
105
7.46k
      n -= 2;
106
7.46k
      s0 = src_word[n+1];
107
7.46k
      dst[n+1] ^= MERGE(s0, shl, s1, shr);
108
7.46k
      s1 = src_word[n]; /* FIXME: Overread on last iteration */
109
7.46k
      dst[n] ^= MERGE(s1, shl, s0, shr);
110
7.46k
    }
111
933
  assert (n == 1);
112
  /* Read low wordsize - offset bytes */
113
933
  READ_PARTIAL (s0, src, sizeof(word_t) - offset);
114
933
#ifndef WORDS_BIGENDIAN
115
933
  s0 <<= shl; /* FIXME: eliminate shift? */
116
933
#endif /* !WORDS_BIGENDIAN */
117
118
933
  dst[0] ^= MERGE(s0, shl, s1, shr);
119
933
}
120
121
/* Performance, Intel SU1400 (x86_64): 0.25 cycles/byte aligned, 0.45
122
   cycles/byte unaligned. */
123
124
/* XOR LEN bytes starting at SRCADDR onto DESTADDR. Result undefined
125
   if the source overlaps with the destination. Return DESTADDR. */
126
void *
127
memxor(void *dst_in, const void *src_in, size_t n)
128
3.89k
{
129
3.89k
  unsigned char *dst = dst_in;
130
3.89k
  const unsigned char *src = src_in;
131
132
3.89k
  if (n >= WORD_T_THRESH)
133
3.89k
    {
134
3.89k
      unsigned i;
135
3.89k
      unsigned offset;
136
3.89k
      size_t nwords;
137
      /* There are at least some bytes to compare.  No need to test
138
   for N == 0 in this alignment loop.  */
139
3.89k
      for (i = ALIGN_OFFSET(dst + n); i > 0; i--)
140
0
  {
141
0
    n--;
142
0
    dst[n] ^= src[n];
143
0
  }
144
3.89k
      offset = ALIGN_OFFSET(src + n);
145
3.89k
      nwords = n / sizeof (word_t);
146
3.89k
      n %= sizeof (word_t);
147
148
3.89k
      if (offset)
149
933
  memxor_different_alignment ((word_t *) (dst+n), src+n, nwords);
150
2.96k
      else
151
2.96k
  memxor_common_alignment ((word_t *) (dst+n),
152
2.96k
         (const word_t *) (src+n), nwords);
153
3.89k
    }
154
3.89k
  while (n > 0)
155
0
    {
156
0
      n--;
157
0
      dst[n] ^= src[n];
158
0
    }
159
160
3.89k
  return dst;
161
3.89k
}