/*############################################################################ # Copyright 2017 Intel Corporation # # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. # See the License for the specific language governing permissions and # limitations under the License. ############################################################################*/ /// EpidSignBasic interface. /*! \file */ #ifndef EPID_MEMBER_SRC_SIGNBASIC_H_ #define EPID_MEMBER_SRC_SIGNBASIC_H_ #include <stddef.h> #include "epid/common/errors.h" /// \cond typedef struct MemberCtx MemberCtx; typedef struct BasicSignature BasicSignature; typedef struct BigNumStr BigNumStr; /// \endcond /// Creates a basic signature for use in constrained environment. /*! Used in constrained environments where, due to limited memory, it may not be possible to process through a large and potentially unbounded revocation list. \param[in] ctx The member context. \param[in] msg The message. \param[in] msg_len The length of message in bytes. \param[in] basename Optional basename. If basename is NULL a random basename is used. Signatures generated using random basenames are anonymous. Signatures generated using the same basename are linkable by the verifier. If a basename is provided it must already be registered or ::kEpidBadArgErr is returned. \param[in] basename_len The size of basename in bytes. Must be 0 if basename is NULL. \param[out] sig The generated basic signature \param[out] rnd_bsn Random basename, can be NULL if basename is provided. \returns ::EpidStatus \note This function should be used in conjunction with EpidNrProve() \note If the result is not ::kEpidNoErr the content of sig, is undefined. \see EpidMemberInit \see EpidNrProve */ EpidStatus EpidSignBasic(MemberCtx const* ctx, void const* msg, size_t msg_len, void const* basename, size_t basename_len, BasicSignature* sig, BigNumStr* rnd_bsn); #endif // EPID_MEMBER_SRC_SIGNBASIC_H_