370ff654e7
Change license to AGPL
This commit:
- Updates the `LICENSE` file
- Start every file with something like:
// Copyright YEAR_FIRST_PUBLISHED Signal Messenger, LLC
// SPDX-License-Identifier: AGPL-3.0-only
---
First, I removed existing license headers with this Ruby 3.1.2 script:
require 'set'
EXTENSIONS_TO_CHECK = Set['.h', '.hpp', '.cpp', '.m', '.mm', '.pch', '.swift']
same = 0
different = 0
all_files = `git ls-files`.lines.map { |line| line.strip }
all_files.each do |relative_path|
if relative_path == 'Pods'
next
end
unless EXTENSIONS_TO_CHECK.include? File.extname(relative_path)
next
end
path = File.expand_path(relative_path)
contents = File.read(path)
new_contents = contents.sub(/\/\/\n\/\/ Copyright .*\n\/\/\n\n/, '')
if contents == new_contents
same += 1
else
different += 1
end
File.write(path, new_contents)
end
puts "updated #{different} file(s), left #{same} untouched"
I'm sure this script could be improved, but it worked well enough.
Then, I created `Scripts/lint/lint-license-headers` and ran it to auto-
fix a lot of files. This changed the mode of some files, but I think
that's actually desirable. For example,
`SignalServiceKit/src/Util/AppContext.m` previously had a mode of
`0755/-rwxr-xr-x`, and it's now `0644/-rw-r--r--`.
Then I fixed some stragglers and updated the precommit script.
See [a similar change in the Desktop app][0].
[0]: 8bfaf598af
55 lines
2.4 KiB
Objective-C
55 lines
2.4 KiB
Objective-C
//
|
|
// Copyright 2020 Signal Messenger, LLC
|
|
// SPDX-License-Identifier: AGPL-3.0-only
|
|
//
|
|
|
|
#import <Foundation/Foundation.h>
|
|
|
|
NS_ASSUME_NONNULL_BEGIN
|
|
|
|
@class DarwinNotificationName;
|
|
|
|
extern const int DarwinNotificationInvalidObserver;
|
|
|
|
@interface DarwinNotificationCenter : NSObject
|
|
|
|
/// Determines if an observer token is valid for a current registration.
|
|
/// Negative integers are never valid. A positive or zero value is valid
|
|
/// if the current process has a registration associated with the given value.
|
|
/// @param observerToken The token returned by `addObserverForName:`
|
|
+ (BOOL)isValidObserver:(int)observerToken;
|
|
|
|
/// Post a darwin notification that can be listened for from other processes.
|
|
/// @param name The name of the notification to post.
|
|
+ (void)postNotificationName:(DarwinNotificationName *)name;
|
|
|
|
/// Add an observer for a darwin notification of the given name.
|
|
/// @param name The name of the notification to listen for.
|
|
/// @param queue The queue to callback on.
|
|
/// @param block The block to callback. Includes the observer token as an input parameter to allow
|
|
/// removing the observer after receipt.
|
|
/// @return An `int` observer token that can be used to remove this observer.
|
|
+ (int)addObserverForName:(DarwinNotificationName *)name queue:(dispatch_queue_t)queue usingBlock:(void (^)(int))block;
|
|
|
|
/// Stops listening for notifications registered by the given observer token.
|
|
/// @param observerToken The token returned by `addObserverForName:` for the notification you want to stop listening
|
|
/// for.
|
|
+ (void)removeObserver:(int)observerToken;
|
|
|
|
/// Sets the state value for a given observer. This value can be set and read from
|
|
/// any process listening for this notification. Note: `setState:` and `getState`
|
|
/// are vulnerable to races.
|
|
/// @param state The `uint64_t` state you wish to share with another process.
|
|
/// @param observerToken The token returned by `addObserverForName:` for the notification you want to set state for.
|
|
+ (void)setState:(uint64_t)state forObserver:(int)observerToken;
|
|
|
|
/// Retrieves the state for a given observer. This value can be set and read from
|
|
/// any process listening for this notification. Note: `setState:` and `getState`
|
|
/// are vulnerable to races.
|
|
/// @param observerToken The token returned by `addObserverForName:` for the notification you want to get state for.
|
|
+ (uint64_t)getStateForObserver:(int)observerToken;
|
|
|
|
@end
|
|
|
|
NS_ASSUME_NONNULL_END
|