blob: f1aa8e3f5d7d7945d85b6f35a911e1d451b40576 [file] [log] [blame]
// Copyright (c) 2011 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef COMPONENTS_CRASH_CORE_COMMON_OBJC_ZOMBIE_H_
#define COMPONENTS_CRASH_CORE_COMMON_OBJC_ZOMBIE_H_
#include <stddef.h>
#include "build/build_config.h"
#include "components/crash/core/common/crash_export.h"
// You should think twice every single time you use anything from this
// namespace.
namespace ObjcEvilDoers {
// Enable zombie object debugging. This implements a variant of Apple's
// NSZombieEnabled which can help expose use-after-free errors where messages
// are sent to freed Objective-C objects in production builds.
//
// Returns NO if it fails to enable.
//
// When |zombieAllObjects| is YES, all objects inheriting from
// NSObject become zombies on -dealloc. If NO, -shouldBecomeCrZombie
// is queried to determine whether to make the object a zombie.
//
// |zombieCount| controls how many zombies to store before freeing the
// oldest. Set to 0 to free objects immediately after making them
// zombies.
bool CRASH_EXPORT ZombieEnable(bool zombieAllObjects, size_t zombieCount);
// Disable zombies.
void CRASH_EXPORT ZombieDisable();
} // namespace ObjcEvilDoers
#if defined(OS_MACOSX)
#if defined(__OBJC__)
#import <Foundation/Foundation.h>
@interface NSObject (CrZombie)
- (BOOL)shouldBecomeCrZombie;
@end
#endif // __OBJC__
#endif // OS_MACOSX
#endif // COMPONENTS_CRASH_CORE_COMMON_OBJC_ZOMBIE_H_