X-Git-Url: https://git.saurik.com/apple/security.git/blobdiff_plain/72a12576750f52947eb043106ba5c12c0d07decf..b1ab9ed8d0e0f1c3b66d7daa8fd5564444c56195:/libsecurity_utilities/lib/osxcode.h diff --git a/libsecurity_utilities/lib/osxcode.h b/libsecurity_utilities/lib/osxcode.h new file mode 100644 index 00000000..849c4fdd --- /dev/null +++ b/libsecurity_utilities/lib/osxcode.h @@ -0,0 +1,136 @@ +/* + * Copyright (c) 2000-2001 Apple Computer, Inc. All Rights Reserved. + * + * The contents of this file constitute Original Code as defined in and are + * subject to the Apple Public Source License Version 1.2 (the 'License'). + * You may not use this file except in compliance with the License. Please obtain + * a copy of the License at http://www.apple.com/publicsource and read it before + * using this file. + * + * This Original Code and all software distributed under the License are + * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS + * OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES, INCLUDING WITHOUT + * LIMITATION, ANY WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR + * PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT. Please see the License for the + * specific language governing rights and limitations under the License. + */ + + +// +// osxcode - MacOS X's standard code objects +// +#ifndef _H_OSXCODE +#define _H_OSXCODE + +#include +#include +#include +#include +#include +#include +#include + + +namespace Security { + + +// +// A Signable with OS X support calls added +// +class OSXCode : public RefCount { +public: + virtual ~OSXCode() { } + +public: + // creating OSXCode objects + static RefPointer main(); + static RefPointer at(const char *path); + static RefPointer at(const std::string &path) { return at(path.c_str()); } + +public: + virtual string canonicalPath() const = 0; // reverse of at() + virtual string executablePath() const = 0; // path to main executable file + virtual SecStaticCodeRef codeRef() const; // defaults to code at canonicalPath() + +protected: + OSXCode() { } // nonpublic +}; + + +// +// A simple executable tool. +// +class ExecutableTool : public OSXCode { +public: + ExecutableTool(const char *path) : mPath(path) { } + + string path() const { return mPath; } + string canonicalPath() const; + string executablePath() const; + +private: + string mPath; // UTF8 pathname to executable +}; + + +// +// A generic bundle +// +class Bundle : public OSXCode { +public: + Bundle(const char *path, const char *execPath = NULL); // from root and optional exec path + Bundle(CFBundleRef bundle, const char *root = NULL); // from existing CFBundleRef + ~Bundle(); + + string canonicalPath() const; + string path() const { return mPath; } + string executablePath() const; + string identifier() const { return cfString(CFBundleGetIdentifier(cfBundle())); } + CFTypeRef infoPlistItem(const char *name) const; // not retained + + string resourcePath() const { return cfStringRelease(CFBundleCopyResourcesDirectoryURL(cfBundle())); } + string resource(const char *name, const char *type, const char *subdir = NULL); + void resources(vector &paths, const char *type, const char *subdir = NULL); + + virtual void *lookupSymbol(const char *name); + +protected: + CFBundleRef cfBundle() const; + +protected: + string mPath; // UTF8 path to bundle directory + mutable string mExecutablePath; // cached or determined path to main executable + mutable CFBundleRef mBundle; // CF-style bundle object (lazily built) +}; + + +class LoadableBundle : public Bundle { +public: + LoadableBundle(const char *pathname) : Bundle(pathname) { } + LoadableBundle(CFBundleRef bundle) : Bundle(bundle) { } + + virtual bool isLoaded() const; + virtual void load(); + virtual void unload(); +}; + + +class OSXCodeWrap : public OSXCode { +public: + OSXCodeWrap(SecStaticCodeRef code) : mCode(code) { } + + string encode() const; + + string canonicalPath() const; + string executablePath() const; + SecStaticCodeRef codeRef() const; + +private: + CFCopyRef mCode; +}; + + +} // end namespace Security + + +#endif //_H_OSXCODE