102 lines
3.1 KiB
C#
102 lines
3.1 KiB
C#
|
/*
|
||
|
|
Copyright (C) 2014-2019 de4dot@gmail.com
|
||
|
|
|
||
|
|
This file is part of dnSpy
|
||
|
|
|
||
|
|
dnSpy is free software: you can redistribute it and/or modify
|
||
|
|
it under the terms of the GNU General Public License as published by
|
||
|
|
the Free Software Foundation, either version 3 of the License, or
|
||
|
|
(at your option) any later version.
|
||
|
|
|
||
|
|
dnSpy is distributed in the hope that it will be useful,
|
||
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||
|
|
GNU General Public License for more details.
|
||
|
|
|
||
|
|
You should have received a copy of the GNU General Public License
|
||
|
|
along with dnSpy. If not, see <http://www.gnu.org/licenses/>.
|
||
|
|
*/
|
||
|
|
|
||
|
|
using System;
|
||
|
|
using System.ComponentModel.Composition;
|
||
|
|
using System.Diagnostics;
|
||
|
|
using System.Diagnostics.CodeAnalysis;
|
||
|
|
|
||
|
|
namespace dnSpy.Contracts.Debugger.StartDebugging {
|
||
|
|
/// <summary>
|
||
|
|
/// Process starter result flags
|
||
|
|
/// </summary>
|
||
|
|
[Flags]
|
||
|
|
public enum ProcessStarterResult {
|
||
|
|
/// <summary>
|
||
|
|
/// No bit is set
|
||
|
|
/// </summary>
|
||
|
|
None = 0,
|
||
|
|
|
||
|
|
/// <summary>
|
||
|
|
/// The file extension is not the normal extension
|
||
|
|
/// </summary>
|
||
|
|
WrongExtension = 0x00000001,
|
||
|
|
}
|
||
|
|
|
||
|
|
/// <summary>
|
||
|
|
/// Starts a process without debugging
|
||
|
|
/// </summary>
|
||
|
|
public abstract class DbgProcessStarter {
|
||
|
|
/// <summary>
|
||
|
|
/// Checks if this instance supports starting the executable
|
||
|
|
/// </summary>
|
||
|
|
/// <param name="filename">Filename</param>
|
||
|
|
/// <param name="result">Contains extra information if it's a supported file</param>
|
||
|
|
/// <returns></returns>
|
||
|
|
public abstract bool IsSupported(string filename, out ProcessStarterResult result);
|
||
|
|
|
||
|
|
/// <summary>
|
||
|
|
/// Starts the executable. Returns false and an error message if it failed or throws an exception
|
||
|
|
/// </summary>
|
||
|
|
/// <param name="filename">Filename</param>
|
||
|
|
/// <param name="error">Updated with an error message</param>
|
||
|
|
/// <returns></returns>
|
||
|
|
public abstract bool TryStart(string filename, [NotNullWhen(false)] out string? error);
|
||
|
|
}
|
||
|
|
|
||
|
|
/// <summary>Metadata</summary>
|
||
|
|
public interface IDbgProcessStarterMetadata {
|
||
|
|
/// <summary>See <see cref="ExportDbgProcessStarterAttribute.Order"/></summary>
|
||
|
|
double Order { get; }
|
||
|
|
}
|
||
|
|
|
||
|
|
/// <summary>
|
||
|
|
/// Exports a <see cref="DbgProcessStarter"/> instance
|
||
|
|
/// </summary>
|
||
|
|
[MetadataAttribute, AttributeUsage(AttributeTargets.Class, AllowMultiple = false)]
|
||
|
|
public sealed class ExportDbgProcessStarterAttribute : ExportAttribute, IDbgProcessStarterMetadata {
|
||
|
|
/// <summary>
|
||
|
|
/// Constructor
|
||
|
|
/// </summary>
|
||
|
|
/// <param name="order">Order, see <see cref="PredefinedDbgProcessStarterOrders"/></param>
|
||
|
|
public ExportDbgProcessStarterAttribute(double order)
|
||
|
|
: base(typeof(DbgProcessStarter)) => Order = order;
|
||
|
|
|
||
|
|
/// <summary>
|
||
|
|
/// Order
|
||
|
|
/// </summary>
|
||
|
|
public double Order { get; }
|
||
|
|
}
|
||
|
|
|
||
|
|
/// <summary>
|
||
|
|
/// Predefined <see cref="DbgProcessStarter"/> order constants
|
||
|
|
/// </summary>
|
||
|
|
public static class PredefinedDbgProcessStarterOrders {
|
||
|
|
/// <summary>
|
||
|
|
/// .NET
|
||
|
|
/// </summary>
|
||
|
|
public const double DotNet = 1000000;
|
||
|
|
|
||
|
|
/// <summary>
|
||
|
|
/// Default process starter that calls <see cref="Process.Start(string)"/>
|
||
|
|
/// </summary>
|
||
|
|
public const double DefaultExe = double.MaxValue;
|
||
|
|
}
|
||
|
|
}
|