1/* 2 * Copyright (c) 2006-2007,2011 Apple Inc. All Rights Reserved. 3 * 4 * @APPLE_LICENSE_HEADER_START@ 5 * 6 * This file contains Original Code and/or Modifications of Original Code 7 * as defined in and that are subject to the Apple Public Source License 8 * Version 2.0 (the 'License'). You may not use this file except in 9 * compliance with the License. Please obtain a copy of the License at 10 * http://www.opensource.apple.com/apsl/ and read it before using this 11 * file. 12 * 13 * The Original Code and all software distributed under the License are 14 * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER 15 * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES, 16 * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY, 17 * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT. 18 * Please see the License for the specific language governing rights and 19 * limitations under the License. 20 * 21 * @APPLE_LICENSE_HEADER_END@ 22 */ 23 24// 25// filediskrep - single-file executable disk representation 26// 27#ifndef _H_FILEDISKREP 28#define _H_FILEDISKREP 29 30#include "singlediskrep.h" 31#include "machorep.h" 32#include <security_utilities/cfutilities.h> 33 34namespace Security { 35namespace CodeSigning { 36 37 38// 39// A FileDiskRep represents a single code file on disk. We assume nothing about 40// the format or contents of the file and impose no structure on it, other than 41// assuming that all relevant code is contained in the file's data bytes. 42// By default, we seal the entire file data as a single page. 43// 44// This is the ultimate fallback disk format. It is used if no other pattern 45// applies. As such it is important that we do not introduce any assumptions 46// here. Know that you do not know what any of the file means. 47// 48// FileDiskrep stores components in extended file attributes, one attribute 49// per component. Note that this imposes size limitations on component size 50// that may well be prohibitive in some applications. 51// 52// This DiskRep does not support resource sealing. 53// 54class FileDiskRep : public SingleDiskRep { 55public: 56 FileDiskRep(const char *path); 57 58 CFDataRef component(CodeDirectory::SpecialSlot slot); 59 std::string format(); 60 61 const Requirements *defaultRequirements(const Architecture *arch, const SigningContext &ctx); 62 63public: 64 DiskRep::Writer *writer(); 65 class Writer; 66 friend class Writer; 67 68protected: 69 CFDataRef getAttribute(const char *name); 70 static std::string attrName(const char *name); 71}; 72 73 74// 75// The write side of a FileDiskRep 76// 77class FileDiskRep::Writer : public SingleDiskRep::Writer { 78 friend class FileDiskRep; 79public: 80 void component(CodeDirectory::SpecialSlot slot, CFDataRef data); 81 void remove(); 82 bool preferredStore(); 83 84protected: 85 Writer(FileDiskRep *r) : SingleDiskRep::Writer(r, writerLastResort) { } 86 RefPointer<FileDiskRep> rep; 87}; 88 89 90} // end namespace CodeSigning 91} // end namespace Security 92 93#endif // !_H_FILEDISKREP 94