/* Copyright (c) 2014, Google Inc. * * Permission to use, copy, modify, and/or distribute this software for any * purpose with or without fee is hereby granted, provided that the above * copyright notice and this permission notice appear in all copies. * * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY * SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION * OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN * CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. */ #ifndef OPENSSL_HEADER_TOOL_INTERNAL_H #define OPENSSL_HEADER_TOOL_INTERNAL_H #if !defined(OPENSSL_BENCHMARK) #include #include #include #endif #include #include #include #include #include struct FileCloser { void operator()(FILE *file) { fclose(file); } }; using ScopedFILE = std::unique_ptr; // The following functions abstract between POSIX and Windows differences in // file descriptor I/O functions. // CloseFD behaves like |close|. void CloseFD(int fd); class ScopedFD { public: ScopedFD() {} explicit ScopedFD(int fd) : fd_(fd) {} ScopedFD(ScopedFD &&other) { *this = std::move(other); } ScopedFD(const ScopedFD &) = delete; ~ScopedFD() { reset(); } ScopedFD &operator=(const ScopedFD &) = delete; ScopedFD &operator=(ScopedFD &&other) { reset(); fd_ = other.fd_; other.fd_ = -1; return *this; } explicit operator bool() const { return fd_ >= 0; } int get() const { return fd_; } void reset() { if (fd_ >= 0) { CloseFD(fd_); } fd_ = -1; } int release() { int fd = fd_; fd_ = -1; return fd; } private: int fd_ = -1; }; // OpenFD behaves like |open| but handles |EINTR| and works on Windows. ScopedFD OpenFD(const char *path, int flags); // ReadFromFD reads up to |num| bytes from |fd| and writes the result to |out|. // On success, it returns true and sets |*out_bytes_read| to the number of bytes // read. Otherwise, it returns false and leaves an error in |errno|. On POSIX, // it handles |EINTR| internally. bool ReadFromFD(int fd, size_t *out_bytes_read, void *out, size_t num); // WriteToFD writes up to |num| bytes from |in| to |fd|. On success, it returns // true and sets |*out_bytes_written| to the number of bytes written. Otherwise, // it returns false and leaves an error in |errno|. On POSIX, it handles |EINTR| // internally. bool WriteToFD(int fd, size_t *out_bytes_written, const void *in, size_t num); // FDToFILE behaves like |fdopen|. ScopedFILE FDToFILE(ScopedFD fd, const char *mode); enum ArgumentType { kRequiredArgument, kOptionalArgument, kBooleanArgument, }; typedef struct argument_t { const char *name; ArgumentType type; const char *description; } argument_t; typedef std::vector args_list_t; typedef std::map args_map_t; // ParseKeyValueArguments converts the list of strings |args| ["-filter", "RSA", "-Timeout", "10"] into a map in // |out_args| of key value pairs {"-filter": "RSA", "-Timeout": "10"}. It uses |templates| to determine what arguments // are option or required. bool ParseKeyValueArguments(args_map_t *out_args, const args_list_t &args, const argument_t *templates); // PrintUsage prints the description from the list of templates in |templates| to stderr. void PrintUsage(const argument_t *templates); // Get{Unsigned, String} assign |out| the value of |arg_name| from the map // |args| if it is present. If |arg_name| is not found in |args| it assigns // |out| to the |default_value|. bool GetUnsigned(unsigned *out, const std::string &arg_name, unsigned default_value, const args_map_t &args); bool GetString(std::string *out, const std::string &arg_name, std::string default_value, const args_map_t &args); // GetBoolArgument assigns |out| the value |true| if |arg_name|, of // type |kBooleanArgument|, from the map |args| is present. If |arg_name| is not // found in |args| it assigns |out| to the value |false|. bool GetBoolArgument(bool *out, const std::string &arg_name, const args_map_t &args); bool ReadAll(std::vector *out, FILE *in); bool WriteToFile(const std::string &path, const uint8_t *in, size_t in_len); bool Ciphers(const std::vector &args); bool Client(const std::vector &args); bool DoPKCS12(const std::vector &args); bool GenerateECH(const std::vector &args); bool GenerateEd25519Key(const std::vector &args); bool GenerateRSAKey(const std::vector &args); bool MD5Sum(const std::vector &args); bool Rand(const std::vector &args); bool SHA1Sum(const std::vector &args); bool SHA224Sum(const std::vector &args); bool SHA256Sum(const std::vector &args); bool SHA384Sum(const std::vector &args); bool SHA512Sum(const std::vector &args); bool SHA512256Sum(const std::vector &args); bool Server(const std::vector &args); bool Sign(const std::vector &args); bool Speed(const std::vector &args); // These values are DER encoded, RSA private keys. extern const uint8_t kDERRSAPrivate2048[]; extern const size_t kDERRSAPrivate2048Len; extern const uint8_t kDERRSAPrivate4096[]; extern const size_t kDERRSAPrivate4096Len; extern const uint8_t kDERRSAPrivate3072[]; extern const size_t kDERRSAPrivate3072Len; extern const uint8_t kDERRSAPrivate8192[]; extern const size_t kDERRSAPrivate8192Len; #define BM_ARRAY_SIZE(array) (sizeof(array) / sizeof((array)[0])) #endif // !OPENSSL_HEADER_TOOL_INTERNAL_H