15821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Copyright (c) 2012 The Chromium Authors. All rights reserved. 25821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Use of this source code is governed by a BSD-style license that can be 35821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// found in the LICENSE file. 45821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 55821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#ifndef SANDBOX_LINUX_SECCOMP_BPF_SYSCALL_ITERATOR_H__ 65821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define SANDBOX_LINUX_SECCOMP_BPF_SYSCALL_ITERATOR_H__ 75821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 85821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include <stdint.h> 95821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 101320f92c476a1ad9d19dba2a48c72b75566198e9Primiano Tucci#include "base/macros.h" 11cedac228d2dd51db4b79ea1e72c7f249408ee061Torne (Richard Coles)#include "sandbox/sandbox_export.h" 12f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) 13a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles)namespace sandbox { 145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Iterates over the entire system call range from 0..0xFFFFFFFFu. This 165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// iterator is aware of how system calls look like and will skip quickly 175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// over ranges that can't contain system calls. It iterates more slowly 185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// whenever it reaches a range that is potentially problematic, returning 195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// the last invalid value before a valid range of system calls, and the 205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// first invalid value after a valid range of syscalls. It iterates over 215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// individual values whenever it is in the normal range for system calls 225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// (typically MIN_SYSCALL..MAX_SYSCALL). 235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// If |invalid_only| is true, this iterator will only return invalid 245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// syscall numbers, but will still skip quickly over invalid ranges, 255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// returning the first invalid value in the range and then skipping 265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// to the last invalid value in the range. 275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// 285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Example usage: 295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// for (SyscallIterator iter(false); !iter.Done(); ) { 305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// uint32_t sysnum = iter.Next(); 315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// // Do something with sysnum. 325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// } 335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// 345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// TODO(markus): Make this a classic C++ iterator. 35c5cede9ae108bb15f6b7a8aea21c7e1fefa2834cBen Murdochclass SANDBOX_EXPORT SyscallIterator { 365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) public: 375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) explicit SyscallIterator(bool invalid_only) 38f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) : invalid_only_(invalid_only), done_(false), num_(0) {} 395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool Done() const { return done_; } 415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) uint32_t Next(); 425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) static bool IsValid(uint32_t num); 435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) private: 455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) static bool IsArmPrivate(uint32_t num); 465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 47f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) bool invalid_only_; 48f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) bool done_; 495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) uint32_t num_; 505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 512a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) DISALLOW_IMPLICIT_CONSTRUCTORS(SyscallIterator); 525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 54a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles)} // namespace sandbox 555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#endif // SANDBOX_LINUX_SECCOMP_BPF_SYSCALL_ITERATOR_H__ 57