کمک در الگوریتم hash

سلام


من یه برنامه دارم که در قسمت includeیه فایل جدید معرفی کرده
کد اون فایل هم دارم چه کنم که برنامه اصلی من اون فایل رو بشناسه؟


بعد نوی همون فایل متغیر هایی از نوع unit8-t هست که فکر نکنم جایی تعریف کرده باشه
چه جوری میشه؟
البته یه قسمتی از برنامه اینو داره

کد:

---

/*

---

کد:

---

*  sha1.h
*
*  Description:
*      This is the header file for code which implements the Secure
*      Hashing Algorithm 1 as defined in FIPS PUB 180-1 published
*      April 17, 1995.
*
*      Many of the variable names in this code, especially the
*      single character names, were used because those were the names
*      used in the publication.
*
*      Please read the file sha1.c for more information.
*
*/
 
#ifndef _SHA1_H_
#define _SHA1_H_
 
#include <stdint.h>
/*
* If you do not have the ISO standard stdint.h header file, then you
* must typdef the following:
*    name              meaning
*  uint32_t        unsigned 32 bit integer
*  uint8_t          unsigned 8 bit integer (i.e., unsigned char)
*  int_least16_t    integer of >= 16 bits
*
*/
 
#ifndef _SHA_enum_
#define _SHA_enum_
enum
{
shaSuccess = 0,
shaNull,            /* Null pointer parameter */
shaInputTooLong,    /* input data too long */
shaStateError      /* called Input after Result */
};
#endif
#define SHA1HashSize 20

---

این یعنی چی؟

کد:

---

#define SHA1CircularShift(bits,word)
                (((word) << (bits)) | ((word) >> (32-(bits))))

---

خودش که نوشته! اگه UIN8 رو نشناخت اون رو typedef کنید.

کد:

---

typedef unsigned char uint8_t

---

در ضمن

کد:

---

#define SHA1CircularShift(bits,word)
                (((word) << (bits)) | ((word) >> (32-(bits))))

---

word رو bitsتا به چپ شیفت می ده و (32-shift) تا به راست و بعد این دو رو با هم or می کنه.

خودش که نوشته! اگه UIN8 رو نشناخت اون رو typedef کنید.

کد:

---

typedef unsigned char uint8_t

---

در ضمن

کد:

---

#define SHA1CircularShift(bits,word)
                (((word) << (bits)) | ((word) >> (32-(bits))))

---

word رو bitsتا به چپ شیفت می ده و (32-shift) تا به راست و بعد این دو رو با هم or می کنه.

خوب حالا این متغیر جدید که تعریف کردیم چه نوعیه؟
از نوع int که تا 8 بیت را پشتیبانی میکند؟
بعد در تعریف typedef این شکلی باید بنوسیم unsigned char




کار این چیه؟

کد:

---

#ifndef _SHA_enum_
#define _SHA_enum_

---

کار این قطعه چیه؟

کد:

---

/*
 *  SHA1Reset
 *
 *  Description:
 *      This function will initialize the SHA1Context in preparation
 *      for computing a new SHA1 message digest.
 *
 *  Parameters:
 *      context: [in/out]
 *          The context to reset.
 *
 *  Returns:
 *      sha Error Code.
 *
 */
int SHA1Reset(SHA1Context *context)
{
    if (!context)
    {
        return shaNull;
    }
 
    context->Length_Low            = 0;
    context->Length_High            = 0;
    context->Message_Block_Index    = 0;
 
    context->Intermediate_Hash[0]  = 0x67452301;
    context->Intermediate_Hash[1]  = 0xEFCDAB89;
    context->Intermediate_Hash[2]  = 0x98BADCFE;
    context->Intermediate_Hash[3]  = 0x10325476;
    context->Intermediate_Hash[4]  = 0xC3D2E1F0;
 
    context->Computed  = 0;
    context->Corrupted  = 0;
 
    return shaSuccess;
}
 
/*
 *  SHA1Result
 *
 *  Description:
 *      This function will return the 160-bit message digest into the
 *      Message_Digest array  provided by the caller.
 *      NOTE: The first octet of hash is stored in the 0th element,
 *            the last octet of hash in the 19th element.
 *
 *  Parameters:
 *      context: [in/out]
 *          The context to use to calculate the SHA-1 hash.
 *      Message_Digest: [out]
 *          Where the digest is returned.
 *
 *  Returns:
 *      sha Error Code.
 *
 */
int SHA1Result( SHA1Context *context,
                uint8_t Message_Digest[SHA1HashSize])
{
    int i;
 
    if (!context || !Message_Digest)
    {
        return shaNull;
    }
 
    if (context->Corrupted)
    {
        return context->Corrupted;
    }
 
    if (!context->Computed)
    {
        SHA1PadMessage(context);
        for(i=0; i<64; ++i)
        {
            /* message may be sensitive, clear it out */
            context->Message_Block[i] = 0;
        }
        context->Length_Low = 0;    /* and clear length */
        context->Length_High = 0;
        context->Computed = 1;
 
    }
 
    for(i = 0; i < SHA1HashSize; ++i)
    {
        Message_Digest[i] = context->Intermediate_Hash[i>>2]
                            >> 8 * ( 3 - ( i & 0x03 ) );
    }
 
    return shaSuccess;
}

---

با توجه به این که sha1context این جوریه؟

کد:

---

typedef struct SHA1Context
{
    uint32_t Intermediate_Hash[SHA1HashSize/4]; /* Message Digest  */
 
    uint32_t Length_Low;            /* Message length in bits      */
    uint32_t Length_High;          /* Message length in bits      */
 
                              /* Index into message block array  */
    int_least16_t Message_Block_Index;
    uint8_t Message_Block[64];      /* 512-bit message blocks      */
 
    int Computed;              /* Is the digest computed?        */
    int Corrupted;            /* Is the message digest corrupted? */
} SHA1Context;

---

لطفا کمکم کنید

خواهش میکنم جواب منو بدین من به کمک شما احتیاج دارم

نقل قول:

---

خوب حالا این متغیر جدید که تعریف کردیم چه نوعیه؟
از نوع int که تا 8 بیت را پشتیبانی میکند؟
بعد در تعریف typedef این شکلی باید بنوسیم unsigned char

---

آره int هشت بیتی
و باید برای تعریف متغییر uint-8 بنویسی

نقل قول:

---

کار این چیه؟

---

کارش اینه که که مطمئن میشه که این فایل دوبار اینکلود نشده. البته خیلی مهم نیست.

خودش که بالای توابع نوشته که هر تابع چه می کنه.

با توجه به تابه زیر مقدار shaSucess چه زمانی برابر یک میشود؟

کد:

---

int SHA1Reset(SHA1Context *context)
{
    if (!context)
    {
        return shaNull;
    }
 
    context->Length_Low            = 0;
    context->Length_High            = 0;
    context->Message_Block_Index    = 0;
 
    context->Intermediate_Hash[0]  = 0x67452301;
    context->Intermediate_Hash[1]  = 0xEFCDAB89;
    context->Intermediate_Hash[2]  = 0x98BADCFE;
    context->Intermediate_Hash[3]  = 0x10325476;
    context->Intermediate_Hash[4]  = 0xC3D2E1F0;
 
    context->Computed  = 0;
    context->Corrupted  = 0;
 
    return shaSuccess;
}

---

که در اول لرنامه مفدار اولیه shaSucess صفر داده

کد:

---

#ifndef _SHA_enum_
#define _SHA_enum_
enum
{
    shaSuccess = 0,
    shaNull,            /* Null pointer parameter */
    shaInputTooLong,    /* input data too long */
    shaStateError      /* called Input after Result */
};
#endif

---

مرسی از اینکه جواب سوالمو دادین

کار stderr در کد زیر چیه؟

کد:

---

        if (err)
        {
            fprintf(stderr, "SHA1Reset Error %d.\n", err );
            break;    /* out of for j loop */
        }

---