grpc 1.51.0 → 1.52.0.pre2

data/src/core/lib/iomgr/call_combiner.h

@@ -1,20 +1,20 @@
-/*
- *
- * Copyright 2017 gRPC authors.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- *
- */
+//
+//
+// Copyright 2017 gRPC authors.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+//
 
 #ifndef GRPC_CORE_LIB_IOMGR_CALL_COMBINER_H
 #define GRPC_CORE_LIB_IOMGR_CALL_COMBINER_H
@@ -211,4 +211,4 @@ class CallCombinerClosureList {
 
 }  // namespace grpc_core
 
-#endif /* GRPC_CORE_LIB_IOMGR_CALL_COMBINER_H */
+#endif  // GRPC_CORE_LIB_IOMGR_CALL_COMBINER_H

data/src/core/lib/iomgr/cfstream_handle.cc

@@ -1,20 +1,20 @@
-/*
- *
- * Copyright 2018 gRPC authors.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- *
- */
+//
+//
+// Copyright 2018 gRPC authors.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+//
 
 #include <grpc/support/port_platform.h>
 
@@ -199,9 +199,9 @@ void CFStreamHandle::Unref(const char* file, int line, const char* reason) {
 
 #else
 
-/* Creating a phony function so that the grpc_cfstream library will be
- * non-empty.
- */
+// Creating a phony function so that the grpc_cfstream library will be
+// non-empty.
+//
 void CFStreamPhony() {}
 
 #endif

data/src/core/lib/iomgr/cfstream_handle.h

@@ -1,23 +1,23 @@
-/*
- *
- * Copyright 2018 gRPC authors.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- *
- */
-
-/* The CFStream handle acts as an event synchronization entity for
- * read/write/open/error/eos events happening on CFStream streams. */
+//
+//
+// Copyright 2018 gRPC authors.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+//
+
+// The CFStream handle acts as an event synchronization entity for
+// read/write/open/error/eos events happening on CFStream streams.
 
 #ifndef GRPC_CORE_LIB_IOMGR_CFSTREAM_HANDLE_H
 #define GRPC_CORE_LIB_IOMGR_CFSTREAM_HANDLE_H
@@ -43,7 +43,7 @@ class CFStreamHandle : public GrpcLibraryInitHolder {
  public:
   static CFStreamHandle* CreateStreamHandle(CFReadStreamRef read_stream,
                                             CFWriteStreamRef write_stream);
-  /** Use CreateStreamHandle function instead of using this directly. */
+  /// Use CreateStreamHandle function instead of using this directly.
   CFStreamHandle(CFReadStreamRef read_stream, CFWriteStreamRef write_stream);
   CFStreamHandle(const CFStreamHandle& ref) = delete;
   CFStreamHandle(CFStreamHandle&& ref) = delete;
@@ -87,4 +87,4 @@ class CFStreamHandle : public GrpcLibraryInitHolder {
 
 #endif
 
-#endif /* GRPC_CORE_LIB_IOMGR_CFSTREAM_HANDLE_H */
+#endif  // GRPC_CORE_LIB_IOMGR_CFSTREAM_HANDLE_H

data/src/core/lib/iomgr/closure.h

@@ -1,20 +1,20 @@
-/*
- *
- * Copyright 2015 gRPC authors.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- *
- */
+//
+//
+// Copyright 2015 gRPC authors.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+//
 
 #ifndef GRPC_CORE_LIB_IOMGR_CLOSURE_H
 #define GRPC_CORE_LIB_IOMGR_CLOSURE_H
@@ -27,6 +27,7 @@
 #include <grpc/support/alloc.h>
 #include <grpc/support/log.h>
 
+#include "src/core/lib/gprpp/crash.h"
 #include "src/core/lib/gprpp/debug_location.h"
 #include "src/core/lib/gprpp/manual_constructor.h"
 #include "src/core/lib/gprpp/mpscq.h"
@@ -42,19 +43,19 @@ typedef struct grpc_closure_list {
   grpc_closure* tail;
 } grpc_closure_list;
 
-/** gRPC Callback definition.
- *
- * \param arg Arbitrary input.
- * \param error absl::OkStatus() if no error occurred, otherwise some grpc_error
- *              describing what went wrong.
- *              Error contract: it is not the cb's job to unref this error;
- *              the closure scheduler will do that after the cb returns */
+/// gRPC Callback definition.
+///
+///\param arg Arbitrary input.
+///\param error absl::OkStatus() if no error occurred, otherwise some grpc_error
+///             describing what went wrong.
+///             Error contract: it is not the cb's job to unref this error;
+///             the closure scheduler will do that after the cb returns
 typedef void (*grpc_iomgr_cb_func)(void* arg, grpc_error_handle error);
 
-/** A closure over a grpc_iomgr_cb_func. */
+/// A closure over a grpc_iomgr_cb_func.
 struct grpc_closure {
-  /** Once queued, next indicates the next queued closure; before then, scratch
-   *  space */
+  /// Once queued, next indicates the next queued closure; before then, scratch
+  /// space
   union {
     grpc_closure* next;
     grpc_core::ManualConstructor<
@@ -63,13 +64,13 @@ struct grpc_closure {
     uintptr_t scratch;
   } next_data;
 
-  /** Bound callback. */
+  /// Bound callback.
   grpc_iomgr_cb_func cb;
 
-  /** Arguments to be passed to "cb". */
+  /// Arguments to be passed to "cb".
   void* cb_arg;
 
-  /** Once queued, the result of the closure. Before then: scratch space */
+  /// Once queued, the result of the closure. Before then: scratch space
   union {
     uintptr_t error;
     uintptr_t scratch;
@@ -109,7 +110,7 @@ inline grpc_closure* grpc_closure_init(grpc_closure* closure,
   return closure;
 }
 
-/** Initializes \a closure with \a cb and \a cb_arg. Returns \a closure. */
+/// Initializes \a closure with \a cb and \a cb_arg. Returns \a closure.
 #ifndef NDEBUG
 #define GRPC_CLOSURE_INIT(closure, cb, cb_arg, scheduler) \
   grpc_closure_init(__FILE__, __LINE__, closure, cb, cb_arg)
@@ -202,7 +203,7 @@ inline grpc_closure* grpc_closure_create(grpc_iomgr_cb_func cb, void* cb_arg) {
   return &wc->wrapper;
 }
 
-/* Create a heap allocated closure: try to avoid except for very rare events */
+// Create a heap allocated closure: try to avoid except for very rare events
 #ifndef NDEBUG
 #define GRPC_CLOSURE_CREATE(cb, cb_arg, scheduler) \
   grpc_closure_create(__FILE__, __LINE__, cb, cb_arg)
@@ -218,8 +219,8 @@ inline void grpc_closure_list_init(grpc_closure_list* closure_list) {
   closure_list->head = closure_list->tail = nullptr;
 }
 
-/** add \a closure to the end of \a list
-    Returns true if \a list becomes non-empty */
+/// add \a closure to the end of \a list
+/// Returns true if \a list becomes non-empty
 inline bool grpc_closure_list_append(grpc_closure_list* closure_list,
                                      grpc_closure* closure) {
   if (closure == nullptr) {
@@ -236,9 +237,9 @@ inline bool grpc_closure_list_append(grpc_closure_list* closure_list,
   return was_empty;
 }
 
-/** add \a closure to the end of \a list
-    and set \a closure's result to \a error
-    Returns true if \a list becomes non-empty */
+/// add \a closure to the end of \a list
+/// and set \a closure's result to \a error
+/// Returns true if \a list becomes non-empty
 inline bool grpc_closure_list_append(grpc_closure_list* closure_list,
                                      grpc_closure* closure,
                                      grpc_error_handle error) {
@@ -249,7 +250,7 @@ inline bool grpc_closure_list_append(grpc_closure_list* closure_list,
   return grpc_closure_list_append(closure_list, closure);
 }
 
-/** force all success bits in \a list to false */
+/// force all success bits in \a list to false
 inline void grpc_closure_list_fail_all(grpc_closure_list* list,
                                        grpc_error_handle forced_failure) {
   for (grpc_closure* c = list->head; c != nullptr; c = c->next_data.next) {
@@ -260,7 +261,7 @@ inline void grpc_closure_list_fail_all(grpc_closure_list* list,
   }
 }
 
-/** append all closures from \a src to \a dst and empty \a src. */
+/// append all closures from \a src to \a dst and empty \a src.
 inline void grpc_closure_list_move(grpc_closure_list* src,
                                    grpc_closure_list* dst) {
   if (src->head == nullptr) {
@@ -275,7 +276,7 @@ inline void grpc_closure_list_move(grpc_closure_list* src,
   src->head = src->tail = nullptr;
 }
 
-/** return whether \a list is empty. */
+/// return whether \a list is empty.
 inline bool grpc_closure_list_empty(grpc_closure_list closure_list) {
   return closure_list.head == nullptr;
 }
@@ -307,4 +308,4 @@ class Closure {
 };
 }  // namespace grpc_core
 
-#endif /* GRPC_CORE_LIB_IOMGR_CLOSURE_H */
+#endif  // GRPC_CORE_LIB_IOMGR_CLOSURE_H

data/src/core/lib/iomgr/combiner.cc

@@ -1,20 +1,20 @@
-/*
- *
- * Copyright 2016 gRPC authors.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- *
- */
+//
+//
+// Copyright 2016 gRPC authors.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+//
 
 #include <grpc/support/port_platform.h>
 
@@ -27,6 +27,7 @@
 #include <grpc/support/alloc.h>
 #include <grpc/support/log.h>
 
+#include "src/core/lib/gprpp/crash.h"
 #include "src/core/lib/gprpp/mpscq.h"
 #include "src/core/lib/iomgr/executor.h"
 #include "src/core/lib/iomgr/iomgr_internal.h"

data/src/core/lib/iomgr/combiner.h

@@ -1,20 +1,20 @@
-/*
- *
- * Copyright 2016 gRPC authors.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- *
- */
+//
+//
+// Copyright 2016 gRPC authors.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+//
 
 #ifndef GRPC_CORE_LIB_IOMGR_COMBINER_H
 #define GRPC_CORE_LIB_IOMGR_COMBINER_H
@@ -86,4 +86,4 @@ bool grpc_combiner_continue_exec_ctx();
 
 extern grpc_core::DebugOnlyTraceFlag grpc_combiner_trace;
 
-#endif /* GRPC_CORE_LIB_IOMGR_COMBINER_H */
+#endif  // GRPC_CORE_LIB_IOMGR_COMBINER_H

data/src/core/lib/iomgr/dualstack_socket_posix.cc

@@ -1,20 +1,20 @@
-/*
- *
- * Copyright 2020 gRPC authors.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- *
- */
+//
+//
+// Copyright 2020 gRPC authors.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+//
 
 #include <grpc/support/port_platform.h>
 
@@ -28,9 +28,9 @@
 
 #ifndef GRPC_SET_SOCKET_DUALSTACK_CUSTOM
 
-/* This should be 0 in production, but it may be enabled for testing or
-   debugging purposes, to simulate an environment where IPv6 sockets can't
-   also speak IPv4. */
+// This should be 0 in production, but it may be enabled for testing or
+// debugging purposes, to simulate an environment where IPv6 sockets can't
+// also speak IPv4.
 int grpc_forbid_dualstack_sockets_for_testing = 0;
 
 int grpc_set_socket_dualstack(int fd) {
@@ -38,7 +38,7 @@ int grpc_set_socket_dualstack(int fd) {
     const int off = 0;
     return 0 == setsockopt(fd, IPPROTO_IPV6, IPV6_V6ONLY, &off, sizeof(off));
   } else {
-    /* Force an IPv6-only socket, for testing purposes. */
+    // Force an IPv6-only socket, for testing purposes.
     const int on = 1;
     setsockopt(fd, IPPROTO_IPV6, IPV6_V6ONLY, &on, sizeof(on));
     return 0;

data/src/core/lib/iomgr/dynamic_annotations.h

@@ -1,20 +1,20 @@
-/*
- *
- * Copyright 2018 gRPC authors.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- *
- */
+//
+//
+// Copyright 2018 gRPC authors.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+//
 
 #ifndef GRPC_CORE_LIB_IOMGR_DYNAMIC_ANNOTATIONS_H
 #define GRPC_CORE_LIB_IOMGR_DYNAMIC_ANNOTATIONS_H
@@ -53,7 +53,7 @@ void AnnotateRWLockReleased(const char* file, int line,
 }
 #endif
 
-#else /* GRPC_TSAN_ENABLED */
+#else  // GRPC_TSAN_ENABLED
 
 #define TSAN_ANNOTATE_HAPPENS_BEFORE(addr)
 #define TSAN_ANNOTATE_HAPPENS_AFTER(addr)
@@ -62,6 +62,6 @@ void AnnotateRWLockReleased(const char* file, int line,
 #define TSAN_ANNOTATE_RWLOCK_ACQUIRED(addr, is_w)
 #define TSAN_ANNOTATE_RWLOCK_RELEASED(addr, is_w)
 
-#endif /* GRPC_TSAN_ENABLED */
+#endif  // GRPC_TSAN_ENABLED
 
-#endif /* GRPC_CORE_LIB_IOMGR_DYNAMIC_ANNOTATIONS_H */
+#endif  // GRPC_CORE_LIB_IOMGR_DYNAMIC_ANNOTATIONS_H

data/src/core/lib/iomgr/endpoint.cc

@@ -1,20 +1,20 @@
-/*
- *
- * Copyright 2015 gRPC authors.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- *
- */
+//
+//
+// Copyright 2015 gRPC authors.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+//
 
 #include <grpc/support/port_platform.h>